Buildkite ランナーをプログラムによりセットアップする

Buildkite ランナーをプログラムにより作成するには

1. Buildkite エージェントトークンを作成し、トークンを AWS Secrets Manager内にプレーンテキストで保存します。

2. 任意の設定で CodeBuild プロジェクトをセットアップします。次の追加属性を設定する必要があります。

   1. CODEBUILD_CONFIG_BUILDKITE_AGENT_TOKEN という名前の環境値、タイプ SECRETS_MANAGER、および Buildkite クラスターに関連付けられた Buildkite エージェントトークンと等しい値。

   2. NO_SOURCE と等しいソースタイプ

   3. プロジェクトのサービスロールのステップ 1 で作成したシークレットにアクセスするためのアクセス許可

   例えば、CLI で次のコマンドを使用して有効な Buildkite ランナープロジェクトを作成できます。

   aws codebuild create-project \
   --name buildkite-runner-project \
   --source "{\"type\": \"NO_SOURCE\",\"buildspec\":\"\"}" \
   --environment "{\"image\":\"aws/codebuild/amazonlinux-x86_64-standard:5.0\",\"type\":\"LINUX_CONTAINER\",\"computeType\":\"BUILD_GENERAL1_MEDIUM\",\"environmentVariables\":[{\"name\":\"CODEBUILD_CONFIG_BUILDKITE_AGENT_TOKEN\",\"type\":\"SECRETS_MANAGER\",\"value\":\"<buildkite-secret-name>\"}]}" \
   --artifacts "{\"type\": \"NO_ARTIFACTS\"}" \
   --service-role <service-role>

3. ステップ 2 で作成したプロジェクトに Buildkite ランナーウェブフックを作成します。ウェブフックを作成するときは、次の設定オプションを使用する必要があります。

   1. build-type は RUNNER_BUILDKITE_BUILD と等しくなければなりません

   2. タイプが EVENT でパターンが WORKFLOW_JOB_QUEUED に等しいフィルター

   例えば、CLI で次のコマンドを使用して有効な Buildkite ランナーウェブフックを作成できます。

   aws codebuild create-webhook \
   --project-name buildkite-runner-project \
   --filter-groups "[[{\"type\":\"EVENT\",\"pattern\":\"WORKFLOW_JOB_QUEUED\"}]]" \
   --build-type RUNNER_BUILDKITE_BUILD

4. create-webhook 呼び出しによって返された [ペイロード URL] と [シークレット] の値を保存し、認証情報を使用して Buildkite コンソール内にウェブフックを作成します。このリソースのセットアップ方法については、「チュートリアル: CodeBuild がホストする Buildkite ランナーを設定」の「ステップ 3: Buildkite 内で CodeBuild ウェブフックを作成する」を参照してください。