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 rótulos suportadas pelo executor Buildkite CodeBuild hospedado
<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 suportadas pelo executor CodeBuild Buildkite hospedado](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 suportadas pelo executor CodeBuild Buildkite hospedado](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`.