Google Cloud Compute EngineでRunnerをプロビジョニングする

GitLab.comのプロジェクトRunnerまたはグループRunnerを作成し、Google Cloudプロジェクトでプロビジョニングできます。Runnerを作成すると、GitLabユーザーインターフェースに、Google CloudプロジェクトでRunnerを自動的にプロビジョニングするための画面上の指示とスクリプトが表示されます。

Runnerを作成すると、Runner認証トークンがRunnerに割り当てられます。GRIT Terraformスクリプトは、このトークンを使用してRunnerを登録します。Runnerは、ジョブキューからジョブを取得するときに、トークンを使用してGitLabで認証。

プロビジョニング後、オートスケールRunnerフリートは、Google CloudでCI/CDジョブを実行する準備ができています。Runnerマネージャーは、一時的なRunnerを自動的に作成します。

前提要件:

• グループRunnerの場合: グループのオーナーロール。
• プロジェクトRunnerの場合: プロジェクトのメンテナーロール。
• Google Cloud Platformプロジェクトの場合: オーナー IAMロール。
• Google Cloud Platformプロジェクトの課金が有効。
• Google CloudプロジェクトのIAMロールで認証された、稼働中のgcloudCLIツール。
• Terraform v1.5以降およびTerraform CLIツール。
• Bashがインストールされたターミナル。

グループRunnerまたはプロジェクトRunnerを作成し、Google Cloudでプロビジョニングするには:

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。

2. 新しいRunnerを作成します。

   • 新しいグループRunnerを作成するには、Build > Runners > New group runner（ビルド > Runners > 新しいグループRunner）を選択します。
   • 新しいプロジェクトRunnerを作成するには、Settings > CI/CD > Runners > New project runner（設定 > CI/CD > Runners > 新しいプロジェクトRunner）を選択します。

3. タグセクションのタグフィールドに、ジョブタグを入力してRunnerが実行できるジョブを指定します。タグ付けされたジョブに加えて、タグ付けされていないジョブにRunnerを使用するには、Run untagged（タグなしで実行）を選択します。

4. オプション。設定セクションで、Runnerの説明と追加の設定を追加します。

5. Runnerを作成を選択します。

6. プラットフォームセクションで、Google Cloudを選択します。

7. 環境で、Google Cloud環境の次の詳細を入力します:

   • Google CloudプロジェクトID
   • リージョン
   • ゾーン
   • マシンタイプ

8. Set up GitLab Runner（GitLab Runnerのセットアップ）で、セットアップ手順を選択します。ダイアログで:

   1. 必要なサービス、サービスアカウント、および権限を有効にするには、Configure Google Cloud project（Google Cloudプロジェクトを設定する）で、各Google Cloudプロジェクトに対してBashを1回実行します。
   2. Install and register GitLab Runner（GitLab Runnerのインストールと登録）からの設定を含むmain.tfファイルを作成します。このスクリプトは、Runnerマネージャーを実行するために、Google CloudプロジェクトでインフラストラクチャをプロビジョニングするためにGitLab Runner Infrastructure Toolkit（GRIT）を使用します。

スクリプトを実行すると、RunnerマネージャーがRunner認証トークンに接続されます。Runnerマネージャーがオンラインとして表示され、ジョブの受信を開始するまでに最大1分かかる場合があります。