• 利用可能な機能フラグ
• パイプライン設定で機能フラグを有効にします。
• Runner環境変数で機能フラグを有効にします。
• Runner設定で機能フラグを有効にします。

GitLab Runner機能フラグ

GitLab 11.4で導入されました。

機能フラグは、特定の機能を有効にしたり無効にしたりするためのトグルです。これらのフラグは一般的に使われます：

• 有志がテストするために利用可能になっているが、すべてのユーザーに対して有効にする準備ができていないベータ機能の場合。

  ベータ機能は不完全であったり、さらなるテストが必要な場合があります。ベータ機能を使いたいユーザーは、そのリスクを受け入れ、機能フラグで明示的にその機能を有効にすることができます。その機能を必要としない他のユーザーや、システム上のリスクを受け入れたくないユーザーは、デフォルトでその機能が無効になっており、起こりうるバグやリグレッションの影響を受けません。

• 近い将来、機能が廃止されたり、機能が削除されたりする可能性のある変更。

  製品の進化に伴い、機能が変更されたり、完全に削除されたりすることがあります。既知のバグが修正されることもよくありますが、場合によっては、ユーザーが影響を受けたバグの回避策をすでに見つけていることもあります。標準化されたバグ修正をユーザーに強制すると、カスタマイズした設定に別の問題が発生する可能性があります。

  このような場合、機能フラグを使うことで、オンデマンドで古い動作から新しい動作に切り替えることができます。これにより、ユーザーは、古い動作から新しい動作へのスムーズで永続的な移行を計画する時間を確保しながら、新しいバージョンの製品を採用することができます。

機能フラグは環境変数を使って切り替えます。へ：

• 機能フラグを有効にするには、対応する環境変数を"true" または1 に設定します。
• 機能フラグを無効にするには、対応する環境変数を"false" または0 に設定します。

利用可能な機能フラグ

パイプライン設定で機能フラグを有効にします。

CI変数を使って機能フラグを有効にすることができます：

• パイプライン内のすべてのジョブに対して（グローバルに）：

   variables:
     FEATURE_FLAG_NAME: 1
  

• 単一のジョブ：

   job:
     stage: test
     variables:
       FEATURE_FLAG_NAME: 1
     script:
     - echo "Hello"
  

Runner環境変数で機能フラグを有効にします。

Runnerが実行するすべてのジョブで機能を有効にするには、Runner設定のenvironment 変数として機能フラグを指定します：

[[runners]]
  name = "ruby-2.7-docker"
  url = "https://CI/"
  token = "TOKEN"
  limit = 0
  executor = "docker"
  builds_dir = ""
  shell = ""
  environment = ["FEATURE_FLAG_NAME=1"]

Runner設定で機能フラグを有効にします。

GitLab Runner 13.11で導入されました。

機能フラグは[runners.feature_flags] で指定することで有効にすることができます。この設定によって、どのジョブも機能フラグの値を上書きすることができなくなります。

いくつかの機能フラグは、ジョブがどのように実行されるかに関係しないため、この設定を行った場合にのみ使用できます。

[[runners]]
  name = "ruby-2.7-docker"
  url = "https://CI/"
  token = "TOKEN"
  executor = "docker"
  [runners.feature_flags]
    FF_USE_DIRECT_DOWNLOAD = true