As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Substituições de etiquetas suportadas com o executor CodeBuild-hosted Buildkite
<a name="buildkite-runner-update-labels"></a>

Nos rótulos de tag do agente das etapas do pipeline do Buildkite, você pode fornecer uma variedade de substituições de rótulo que modificam a compilação do executor auto-hospedado. Todas as compilações não reconhecidas por CodeBuild serão ignoradas, mas não falharão em sua solicitação de webhook. Por exemplo, o YAML do fluxo de trabalho a seguir inclui substituições para imagem, tamanho da instância, frota e 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>}}`(obrigatório)
+ Exemplo: `project: "codebuild-myProject"`
+ Necessário para todas as configurações de etapas do pipeline do Buildite. {{<project name>}}deve ser igual ao nome do projeto para o qual o webhook do executor auto-hospedado está configurado.

`queue: "{{<queue-name>}}"`
+ Exemplo: `queue: "{{<queue-name>}}"`
+ Usado para rotear trabalhos do Buildkite para uma fila específica. Consulte mais informações em [Buildkite Agent Queue Tag](https://buildkite.com/docs/agent/v3/cli-start#the-queue-tag).

 `image: "{{<environment-type>}}-{{<image-identifier>}}"` 
+ Exemplo: `image: "arm-3.0"`
+ Substitui a imagem e o tipo de ambiente usados ao iniciar a compilação do executor auto-hospedado com uma imagem selecionada. Para saber mais sobre os valores compatíveis, consulte [Imagens de computação compatíveis com o executor CodeBuild-hosted Buildkite](buildkite-runner-update-yaml.images.md).

  1. Para substituir a imagem e o tipo de ambiente usados por uma imagem personalizada, use `image: "custom-{{<environment-type>}}-{{<custom-image-identifier>}}"`

  1. Exemplo: 

     ```
     image:
           "custom-arm-public.ecr.aws/codebuild/amazonlinux-aarch64-standard:3.0"
     ```
**nota**  
Se a imagem personalizada residir em um registro privado, você deverá configurar as credenciais de registro apropriadas em seu CodeBuild projeto.

`instance-size: "{{<instance-size>}}"`
+ Exemplo: `instance-size: "medium"`
+ Substitui o tipo de instância usado ao iniciar a compilação do executor auto-hospedado. Para saber mais sobre os valores compatíveis, consulte [Imagens de computação compatíveis com o executor CodeBuild-hosted Buildkite](buildkite-runner-update-yaml.images.md).

`fleet: "{{<fleet-name>}}"`
+ Exemplo: `fleet: "myFleet"`
+ Substitui as configurações de frota definidas no projeto para usar a frota especificada. Consulte mais informações em [ Executar compilações em frotas de capacidade reservada](https://docs.aws.amazon.com/codebuild/latest/userguide/fleets.html).

`buildspec-override: "{{<boolean>}}"`
+ Exemplo: `buildspec-override: "true"`
+ Permite que a compilação execute comandos buildspec nas fases `INSTALL`, `PRE_BUILD` e `POST_BUILD` se definida como `true`.