

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

# CodeBuild 託管的 GitLab Runner 支援標籤覆寫
<a name="gitlab-runners-update-labels"></a>

在 GitLab CI/CD 管道 YAML 中，您可以提供各種標籤覆寫，以修改自我管理的執行器建置。CodeBuild 無法辨識的任何建置都會遭到忽略，但不會讓您的 Webhook 請求失敗。例如，下列 YAML 包含映像、執行個體大小、機群和 buildspec 的覆寫：

```
workflow:
  name: HelloWorld
stages:
  - build

build-job:
  stage: build
  script:
    - echo "Hello World!"
  tags:
    - codebuild-myProject-$CI_PROJECT_ID-$CI_PIPELINE_IID-$CI_JOB_NAME
    - image:arm-3.0
    - instance-size:small
    - fleet:myFleet
    - buildspec-override:true
```

`codebuild-<project-name>-$CI_PROJECT_ID-$CI_PIPELINE_IID-$CI_JOB_NAME` (必要)
+ 範例：`codebuild-myProject-$CI_PROJECT_ID-$CI_PIPELINE_IID-$CI_JOB_NAME`
+ 所有 GitLab CI/CD 管道 YAMLs都需要。*<project name>* 應等於設定自我管理執行器 Webhook 的專案名稱。

`image:<environment-type>-<image-identifier>`
+ 範例：`image:arm-3.0`
+ 覆寫啟動自我管理執行器建置時所使用的映像和環境類型。若要了解支援的值，請參閱 [CodeBuild 託管的 GitLab Runner 支援的運算映像](sample-gitlab-runners-gitlab-ci.images.md)。
  + 若要覆寫與自訂映像搭配使用的映像和環境類型，請使用 `image:custom-<environment-type>-<custom-image-identifier>`
  + 範例：`image:custom-arm-public.ecr.aws/codebuild/amazonlinux-aarch64-standard:3.0`
**注意**  
如果自訂映像位於私有登錄檔中，請參閱 [設定自我託管執行器的私有登錄登入資料](private-registry-sample-configure-runners.md)。

`instance-size:<instance-size>`
+ 範例：`instance-size:small`
+ 覆寫啟動自我管理執行器建置時所使用的執行個體類型。若要了解支援的值，請參閱 [CodeBuild 託管的 GitLab Runner 支援的運算映像](sample-gitlab-runners-gitlab-ci.images.md)。

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

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