CodeBuild がホストする Buildkite ランナーでサポートされているラベルの上書き - AWS CodeBuild

CodeBuild がホストする Buildkite ランナーでサポートされているラベルの上書き

Buildkite パイプラインステップのエージェントタグラベルでは、セルフマネージド型ランナーのビルドを変更するさまざまなラベルの上書きを指定できます。CodeBuild で認識されないビルドは無視されますが、ウェブフックリクエストは失敗しません。例えば、次のワークフロー YAML には、イメージ、インスタンスサイズ、フリート、および buildspec の上書きが含まれます。

agents:
  queue: "myQueue"
steps:
  - command: "echo \"Hello World\""
    agents:
      project: "codebuild-myProject"
      image: "{{matrix.os}}"
      instance-size: "{{matrix.size}}"
      buildspec-override: "true"
    matrix:
      setup:
        os:
          - "arm-3.0"
          - "al2-5.0"
        size:
          - "small"
          - "large"

project:codebuild-<project-name> (必須)

  • 例:project: "codebuild-myProject"

  • すべての Buildkite パイプラインステップ設定に必須です。<project name> は、セルフホスト型ランナーウェブフックが設定されているプロジェクトの名前と同じである必要があります。

queue: "<queue-name>"

  • 例:queue: "<queue-name>"

  • Buildkite ジョブを特定のキューにルーティングするために使用されます。詳細については、「Buildkite エージェントキュータグ」を参照してください。

image: "<environment-type>-<image-identifier>"

  • 例:image: "arm-3.0"

  • 選別されたイメージを使用したセルフホスト型ランナーのビルドの開始時に使用するイメージと環境タイプを上書きします。サポートされている値については、「CodeBuild がホストする Buildkite ランナーでサポートされているコンピューティングイメージ」を参照してください。

    1. カスタムイメージで使用されるイメージと環境タイプを上書きするには、「image: "custom-<environment-type>-<custom-image-identifier>"」を使用します。

    2. 例: 

      image:
      "custom-arm-public.ecr.aws/codebuild/amazonlinux-aarch64-standard:3.0"
    注記

    カスタムイメージがプライベートレジストリに存在する場合は、CodeBuild プロジェクトで適切なレジストリ認証情報を設定する必要があります。

instance-size: "<instance-size>"

fleet: "<fleet-name>"

buildspec-override: "<boolean>"

  • 例:buildspec-override: "true"

  • true に設定されている場合、ビルドが INSTALL、PRE_BUILD、および POST_BUILD フェーズで buildspec コマンドを実行できるようにします。