Configurar um executor do Buildkite programaticamente

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.

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

   2. Tipo de origem igual a NO_SOURCE

   3. Permissões para acessar o segredo criado na etapa 1 no perfil de serviço do 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>

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

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

4. 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 CodeBuild Buildite hospedado para obter um guia sobre como configurar esse recurso.