クラスター管理プロジェクトでGitLab Runnerをインストールする

管理プロジェクトテンプレートから作成されたプロジェクトが既にあると仮定すると、 GitLab Runnerをインストールするには、helmfile.yamlから次の行のコメントを外します:

  - path: applications/gitlab-runner/helmfile.yaml

GitLab Runnerは、gitlab-managed-appsクラスターのネームスペースにデフォルトでインストールされます。

必須変数

GitLab Runnerが機能するためには、applications/gitlab-runner/values.yaml.gotmplファイルで以下を指定する必要があります:

• gitlabUrl: Runnerの登録先となるGitLabサーバーの完全なURL（例：https://gitlab.example.com）。

• Runnerトークン: これは、GitLabインスタンスから取得する必要があります。次のトークンのいずれかを使用できます:

  • runnerToken: Runner設定用のRunner認証トークンGitLab UIで作成。
  • runnerRegistrationToken（GitLab 15.6でdeprecated非推奨となり、GitLab 20.0で削除予定です。）: 新しいRunnerをGitLabに追加するために使用される登録トークン。

これらの値は、CI/CD変数を使用して指定できます:

• CI_SERVER_URLはgitlabUrlに使用されます。GitLab.comを使用している場合は、この変数を設定する必要はありません。
• GITLAB_RUNNER_TOKENはrunnerTokenに使用されます。
• GITLAB_RUNNER_REGISTRATION_TOKENはrunnerRegistrationTokenに使用されます（非推奨）。

これらの値を指定する方法は、相互に排他的です。次のいずれかの方法があります:

• 変数GITLAB_RUNNER_TOKENとCI_SERVER_URLをCI変数として指定します（推奨）。
• applications/gitlab-runner/values.yaml.gotmplでrunnerToken:とgitlabUrl:の値を指定します。

runner登録トークンを使用すると、runnerがプロジェクトに接続できるようになるため、悪意のある使用やrunnerを介したコード流出を防ぐためのシークレットとして扱う必要があります。このため、runner登録トークンを保護された変数およびマスクされた変数として指定し、values.yaml.gotmplファイル内のGitリポジトリにコミットしないことをお勧めします。

クラスター管理プロジェクトでapplications/gitlab-runner/values.yaml.gotmplファイルを定義することにより、GitLab Runnerのインストールをカスタマイズできます。利用可能な設定オプションについては、チャートを参照してください。