GitLab Runnerをクラスター管理プロジェクトと一緒にインストールします。
GitLab 14.0 で導入されました。
管理プロジェクトテンプレートから作成したプロジェクトがすでにあると仮定して、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:GitLab UI で作成した Runner 設定の Runner 認証トークン。 -
runnerRegistrationToken(GitLab 15.6では非推奨、GitLab 17.0では削除予定）：GitLabに新しいRunnerを追加するための登録トークン。
-
これらの値は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:の値を指定します。
ランナー登録トークンはランナーによるプロジェクトへの接続を許可するため、悪意のある使用やランナーを介したコードの流出を防ぐためにシークレットとして扱う必要があります。このため、ランナー登録トークンを保護変数や マスク変数として指定し、values.yaml.gotmpl ファイルで Git リポジトリにコミットしないことをお勧めします。
クラスター管理プロジェクトでapplications/gitlab-runner/values.yaml.gotmpl ファイルを定義することで、GitLab Runner のインストールをカスタマイズすることができます。利用可能な設定オプションについては、Chartを参照してください。