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

# Configurar um executor do Buildkite programaticamente
<a name="sample-runner-buildkite-CLI"></a>

Para configurar um projeto de execução do Buildkite programaticamente, você precisa configurar os seguintes recursos:

**Como criar um executor do Buildkite programaticamente**

1. Crie um token de agente do Buildkite e salve o token em texto simples no AWS Secrets Manager.

1. Configure um CodeBuild projeto com sua configuração preferida. Você precisa configurar os seguintes atributos adicionais:

   1. Um valor de ambiente com nome `CODEBUILD_CONFIG_BUILDKITE_AGENT_TOKEN`, tipo `SECRETS_MANAGER` e um valor igual ao do token de agente do Buildkite associado ao cluster do Buildkite.

   1. Tipo de origem igual a `NO_SOURCE`

   1. Permissões para acessar o segredo criado na etapa 1 na função de serviço do seu projeto

   Por exemplo, é possível usar o seguinte comando para criar um projeto de executor válido do Buildkite por meio da CLI:

   ```
   aws codebuild create-project \
   --name buildkite-runner-project \
   --source "{\"type\": \"NO_SOURCE\",\"buildspec\":\"\"}" \
   --environment "{\"image\":\"aws/codebuild/amazonlinux-x86_64-standard:5.0\",\"type\":\"LINUX_CONTAINER\",\"computeType\":\"BUILD_GENERAL1_MEDIUM\",\"environmentVariables\":[{\"name\":\"CODEBUILD_CONFIG_BUILDKITE_AGENT_TOKEN\",\"type\":\"SECRETS_MANAGER\",\"value\":\"<buildkite-secret-name>\"}]}" \
   --artifacts "{\"type\": \"NO_ARTIFACTS\"}" \
   --service-role {{<service-role>}}
   ```

1. Crie um webhook do executor do Buildkite no projeto criado na etapa 2. Você precisa usar as seguintes opções de configuração ao criar o webhook:

   1. O **tipo de compilação** deve ser igual a `RUNNER_BUILDKITE_BUILD`

   1. Um filtro com tipo `EVENT` e padrão igual a `WORKFLOW_JOB_QUEUED` 

   Por exemplo, é possível usar o seguinte comando para criar um webhook de executor válido do Buildkite por meio da CLI:

   ```
   aws codebuild create-webhook \
   --project-name buildkite-runner-project \
   --filter-groups "[[{\"type\":\"EVENT\",\"pattern\":\"WORKFLOW_JOB_QUEUED\"}]]" \
   --build-type RUNNER_BUILDKITE_BUILD
   ```

1. Salve os valores de **URL da carga útil** e **Segredo** retornados pela chamada a `create-webhook` e use as credenciais para criar um webhook no console do Buildkite. Você pode consultar a Etapa 3: Crie um CodeBuild webhook no Buildkite [Tutorial: Configurar um executor do CodeBuild-hosted Buildkite](sample-runner-buildkite.md) para obter um guia sobre como configurar esse recurso.