本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# CodeBuild 託管的 Buildkite 執行器支援標籤覆寫
<a name="buildkite-runner-update-labels"></a>

在 Buildkite 管道步驟代理程式標籤標籤中，您可以提供各種標籤覆寫，以修改您的自我託管執行器建置。CodeBuild 無法辨識的任何建置都會遭到忽略，但不會讓您的 Webhook 請求失敗。例如，下列工作流程 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>* 應等於設定自我託管執行器 Webhook 的專案名稱。

`queue: "<queue-name>"`
+ 範例：`queue: "<queue-name>"`
+ 用來將 Buildkite 任務路由到特定佇列。如需詳細資訊，請參閱 [ Buildkite 代理程式佇列標籤](https://buildkite.com/docs/agent/v3/cli-start#the-queue-tag)。

 `image: "<environment-type>-<image-identifier>"` 
+ 範例：`image: "arm-3.0"`
+ 覆寫使用精選映像啟動自我託管執行器建置時所使用的映像和環境類型。若要了解支援的值，請參閱 [CodeBuild 託管的 Buildkite 執行器支援運算映像](buildkite-runner-update-yaml.images.md)。

  1. 若要覆寫與自訂映像搭配使用的映像和環境類型，請使用 `image: "custom-<environment-type>-<custom-image-identifier>"`

  1. 範例：

     ```
     image:
           "custom-arm-public.ecr.aws/codebuild/amazonlinux-aarch64-standard:3.0"
     ```
**注意**  
如果自訂映像位於私有登錄檔中，您必須在 CodeBuild 專案中設定適當的登錄檔登入資料。

`instance-size: "<instance-size>"`
+ 範例：`instance-size: "medium"`
+ 覆寫啟動自我託管執行器建置時所使用的執行個體類型。若要了解支援的值，請參閱 [CodeBuild 託管的 Buildkite 執行器支援運算映像](buildkite-runner-update-yaml.images.md)。

`fleet: "<fleet-name>"`
+ 範例：`fleet: "myFleet"`
+ 覆寫專案上設定的機群設定，以使用指定的機群。如需詳細資訊，請參閱[在預留容量機群上執行組建。 ](https://docs.aws.amazon.com/codebuild/latest/userguide/fleets.html)

`buildspec-override: "<boolean>"`
+ 範例：`buildspec-override: "true"`
+ 如果設為 `PRE_BUILD`，允許組建在 `INSTALL`、 和 `POST_BUILD`階段中執行 buildspec 命令`true`。