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 de ações CodeBuild hospedado GitHub
<a name="sample-github-action-runners-update-labels"></a>

Em seu fluxo de trabalho de GitHub ações YAML, você pode fornecer uma variedade de substituições de rótulos que modificam sua compilação de executores auto-hospedados. 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:

```
name: Hello World
on: [push]
jobs:
  Hello-World-Job:
    runs-on:
      - codebuild-myProject-${{ github.run_id }}-${{ github.run_attempt }}
        image:${{ matrix.os }}
        instance-size:${{ matrix.size }}
        fleet:myFleet
        buildspec-override:true
    strategy:
      matrix:
        include:
          - os: arm-3.0
            size: small
          - os: linux-5.0
            size: large
    steps:
      - run: echo "Hello World!"
```

**nota**  
Se seu trabalho de fluxo de trabalho estiver suspenso GitHub, consulte [Solucionar problemas do webhook](action-runner-troubleshoot-webhook.md) e [Usando rótulos personalizados para rotear trabalhos](https://docs.github.com/en/enterprise-server@3.12/actions/hosting-your-own-runners/managing-self-hosted-runners/using-self-hosted-runners-in-a-workflow?learn=hosting_your_own_runners&learnProduct=actions#using-custom-labels-to-route-jobs).

`codebuild-<project-name>-${{github.run_id}}-${{github.run_attempt}}`(obrigatório)
+ Exemplo: `codebuild-fake-project-${{ github.run_id }}-${{ github.run_attempt }}`
+ Necessário para todo o fluxo de trabalho de GitHub ações YAMLs. *<project name>*deve ser igual ao nome do projeto para o qual o webhook do executor auto-hospedado está configurado.

`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 de ações hospedado GitHub](sample-github-action-runners-update-yaml.images.md).
  + Para substituir a imagem e o tipo de ambiente usados por uma imagem personalizada, use `image:custom-<environment-type>-<custom-image-identifier>`
  + Exemplo: `image:custom-arm-public.ecr.aws/codebuild/amazonlinux-aarch64-standard:3.0`
**nota**  
Se a imagem personalizada residir em um registro privado, consulte [Configurar uma credencial de registro privada para executores auto-hospedados](private-registry-sample-configure-runners.md).

`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 de ações hospedado GitHub](sample-github-action-runners-update-yaml.images.md).

`fleet:<fleet-name>`
+ Exemplo: `fleet:myFleet`
+ Substitui as configurações de frota definidas no projeto para usar a frota especificada. Para obter mais informações, consulte [Executar compilações em frotas de capacidade reservada](fleets.md).

`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`.

## Substituição de rótulo único (herdado)
<a name="sample-github-action-runners-update-single-labels"></a>

CodeBuild permite que você forneça várias substituições em uma única etiqueta usando o seguinte:
+ Para substituir as configurações de ambiente para uma compilação computacional do Amazon EC2/Lambda, use a seguinte sintaxe:

  ```
  runs-on: codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}-<environment-type>-<image-identifier>-<instance-size>
  ```
+ Para substituir as configurações da frota para a compilação computacional do Amazon EC2, use a seguinte sintaxe:

  ```
  runs-on: codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}-fleet-<fleet-name>
  ```
+ Para substituir a frota e a imagem usadas para a compilação, use a seguinte sintaxe:

  ```
  runs-on: codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}-image-<image-version>-fleet-<fleet-name>
  ```
+ Para executar comandos buildspec durante a compilação, `-with-buildspec` pode ser adicionado como sufixo ao rótulo:

  ```
  runs-on: codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}-<image>-<image-version>-<instance-size>-with-buildspec
  ```
+ Opcionalmente, você pode fornecer uma substituição do tamanho da instância sem substituir a imagem. Para compilações do Amazon EC2, você pode excluir o tipo de ambiente e o identificador de imagem. Para compilações do Lambda, você pode excluir o identificador da imagem.