Tutorial: Configurar un ejecutor CodeBuild de BuildKite alojado

Generación de un token de agente de Buildkite

1. En el clúster de Buildkite, elija Tokens de agente y, a continuación, Nuevo token.

2. Agregue una descripción al token y haga clic en Crear token.

3. Guarda el valor del token del agente, ya que se utilizará más adelante durante la configuración del proyecto. CodeBuild

   

Para crear un CodeBuild proyecto con un webhook

1. Abre la AWS CodeBuild consola en https://console.aws.amazon.com/codesuite/codebuild/home.

2. Cree un proyecto de compilación autoalojado. Para obtener más información, consulte Creación de un proyecto de compilación (consola) y Ejecutar una compilación (consola).

   • En Project Configurator, seleccione Proyecto de ejecutor. En Ejecutor:

     • En Proveedor de ejecutor, elija Buildkite.

     • En Token de agente de Buildkite, seleccione Crear un nuevo token de agente mediante la página de creación de secreto. Se te pedirá que crees un nuevo código secreto AWS Secrets Manager con un valor secreto igual al token de agente de Buildkite que generaste anteriormente.

     • (Opcional) Si quieres usar credenciales CodeBuild administradas para tu trabajo, selecciona el proveedor del repositorio de origen de tu trabajo en las opciones de credenciales de origen de Buildkite y verifica que las credenciales estén configuradas para tu cuenta. Además, verifique que la canalización de Buildkite utilice Extracción mediante HTTPS.

     nota

     Buildkite requiere credenciales de código fuente en el entorno de compilación para poder extraer el código fuente del trabajo. Consulte en Autenticación de Buildkite en un repositorio privado las opciones de credenciales de código fuente disponibles.

   • (Opcional) En Entorno:

     • Elija una Imagen del entorno y una Computación compatibles.

       Tenga en cuenta que tiene la opción de anular la configuración de imagen e instancia mediante una etiqueta en los pasos de YAML de Buildkite. Para obtener más información, consulte Paso 4: actualización de los pasos de la canalización de Buildkite.

   • (Opcional) En Buildspec:

     • La buildspec se ignorará de forma predeterminada a menos que se agregue buildspec-override: "true" como etiqueta. En su lugar, las CodeBuild anulará para usar comandos que configurarán el ejecutor autohospedado.

       nota

       CodeBuild no admite archivos de especificaciones de compilación para compilaciones de ejecutores autohospedados por Buildkite. Para las especificaciones de compilación integradas, tendrás que habilitarlas en tu especificación de compilación si has configurado las credenciales de fuente git-credential-helperadministrada CodeBuild

3. Continúe con los valores predeterminados y, a continuación, elija Crear el proyecto de compilación.

4. Guarde los valores de URL de carga útil y Secreto de la ventana emergente Crear webhook. Siga las instrucciones de la ventana emergente para crear un nuevo webhook de organización de Buildkite o continúe con la siguiente sección.

Cómo crear un nuevo webhook en Buildkite

1. Vaya a la página Configuración de la organización de Buildkite.

2. En Integraciones, seleccione Servicios de notificación.

3. Seleccione Agregar junto a la casilla Webhook. En la página Agregar notificación de webhook, use la siguiente configuración:

   1. En URL de webhook, agregue el valor de URL de carga útil guardado.

   2. En Token, verifica que la opción Enviar el token como X-Buildkite-Token esté seleccionada. Agregue el valor de Secreto de webhook al campo Token.

   3. En, compruebe que esté seleccionada la opción Enviar el token como X-Buildkite-Token. Agregue el valor de Secreto de webhook al campo Token.

   4. En Eventos, seleccione el evento del webhook job.scheduled.

   5. (Opcional) En Canalizaciones, puede elegir opcionalmente desencadenar solo las compilaciones de una canalización específica.

4. Seleccione Agregar notificación de webhook.

Actualización de los pasos de la canalización

1. Vaya a la página de pasos de la canalización de Buildkite seleccionando la canalización de Buildkite, luego Configuración y, por último, Pasos.

   Si aún no lo ha hecho, elija Convertir a pasos de YAML.

   

2. Como mínimo, tendrás que especificar una etiqueta de agente de Buildkite que haga referencia al nombre de tu canalización. CodeBuild El nombre del proyecto es necesario para vincular los ajustes AWS relacionados con tu trabajo de Buildkite a un proyecto específico. CodeBuild Al incluir el nombre del proyecto en el YAML, CodeBuild se pueden invocar trabajos con la configuración de proyecto correcta.

   agents:
     project: "codebuild-<project name>"

   A continuación, se muestra un ejemplo de pasos de canalización de Buildkite solo con la etiqueta del proyecto:

   agents:
     project: "codebuild-myProject"
   steps:
     - command: "echo \"Hello World\""

   También puede anular el tipo de computación e imagen en la etiqueta. Consulte Calcule imágenes compatibles con el CodeBuild ejecutor Buildkite alojado para obtener una lista de las imágenes disponibles. El tipo de computación y la imagen de la etiqueta anularán la configuración del entorno en el proyecto. Para anular la configuración de su entorno para una compilación de procesamiento Lambda CodeBuild EC2 o Lambda, utilice la siguiente sintaxis:

   agents:
     project: "codebuild-<project name>"
     image: "<environment-type>-<image-identifier>"
     instance-size: "<instance-size>"

   A continuación, se muestra un ejemplo de pasos de canalización de Buildkite con anulaciones de tamaño de imagen e instancia:

   agents:
     project: "codebuild-myProject"
     image: "arm-3.0"
     instance-size: "small"
   steps:
     - command: "echo \"Hello World\""

   Puede anular la flota utilizada para su compilación en la etiqueta. Al hacerlo, se anularán los valores de flota configurados en el proyecto para usar la flota especificada. Para obtener más información, consulte Ejecución de compilaciones en flotas de capacidad reservada.

   Para anular la configuración de tu flota para una compilación de Amazon EC2 Compute, usa la siguiente sintaxis:

   agents:
     project: "codebuild-<project name>"
     fleet: "<fleet-name>"
   

   Para anular tanto la flota como la imagen utilizadas para la compilación, utilice la sintaxis siguiente:

   agents:
     project: "codebuild-<project name>"
     fleet: "<fleet-name>"
     image: "<environment-type>-<image-identifier>"

   A continuación, se muestra un ejemplo de pasos de canalización de Buildkite con anulaciones de flota e imagen:

   agents:
     project: "codebuild-myProject"
     fleet: "myFleet"
     image: "arm-3.0"
   steps:
     - command: "echo \"Hello World\""

3. Puede optar por ejecutar comandos buildspec integrados durante la compilación del ejecutor autoalojado en Buildkite (consulte Ejecución de comandos buildspec durante las fases INSTALL, PRE_BUILD y POST_BUILD para obtener más información). Para especificar que la CodeBuild compilación debe ejecutar los comandos buildspec durante la compilación del ejecutor autohospedado de Buildkite, usa la siguiente sintaxis:

   agents:
     project: "codebuild-<project name>"
     buildspec-override: "true"

   A continuación, se muestra un ejemplo de canalización de Buildkite con anulaciones de buildspec:

   agents:
     project: "codebuild-myProject"
     buildspec-override: "true"
   steps:
     - command: "echo \"Hello World\""

4. Opcionalmente, puedes proporcionar etiquetas distintas de las compatibles. CodeBuild Estas etiquetas se ignorarán para el fin de anular los atributos de la compilación, pero no provocarán un error de la solicitud de webhook. Por ejemplo, agregar myLabel: “testLabel" como etiqueta no impedirá que la compilación se ejecute.

Para autenticarte con CodeBuild

CodeBuild ofrece la gestión de credenciales gestionadas para los tipos de fuentes compatibles. Para usar las credenciales de CodeBuild origen para acceder al repositorio de fuentes de su trabajo, puede seguir los siguientes pasos:

1. En la CodeBuild consola, vaya a Editar proyecto o cree un CodeBuild proyecto nuevo siguiendo los pasos que se indicanPaso 2: Crea un CodeBuild proyecto con un webhook.

2. En Opciones de credenciales de código fuente de Buildkite, seleccione el proveedor de repositorio de código fuente del trabajo.

   1. Si desea utilizar CodeBuild credenciales a nivel de cuenta, compruebe que estén configuradas correctamente. Además, si tu proyecto tiene una especificación de compilación integrada configurada, comprueba que esté habilitada. git-credential-helper

   2. Si quieres usar credenciales a nivel de proyecto, selecciona Usar CodeBuild credenciales de anulación solo para este proyecto y configura las credenciales para tu proyecto.

3. En la configuración de la canalización de Buildkite, vaya a Configuración del repositorio. Establezca la configuración de extracción del repositorio de código fuente en Extracción mediante HTTPS

   

Cómo autenticarse con secretos de Buildkite

Buildkite mantiene un complemento ssh-checkout que se puede utilizar para autenticar el ejecutor autoalojado en un repositorio de código fuente externo mediante una clave ssh. El valor de clave se guarda como Secreto de Buildkite y el agente de ejecutor autoalojado en Buildkite lo recupera automáticamente al intentar acceder a un repositorio privado. Para configurar el complemento ssh-checkout para la canalización de Buildkite, puede seguir estos pasos:

1. Genere una clave ssh privada y pública con su dirección de correo electrónico, p. ej. ssh-keygen -t rsa -b 4096 -C "myEmail@address.com"

2. Agregue la clave pública al repositorio de código fuente privado. Por ejemplo, puedes seguir esta guía para añadir una clave a una GitHub cuenta.

3. Agregue una nueva clave SSH secreta al clúster de Buildkite. En el clúster de Buildkite, seleccione Secretos → Nuevo secreto. Agregue un nombre para el secreto en el campo Clave y agregue la clave SSH privada al campo Valor:

   

4. En la canalización de Buildkite, navegue hasta la configuración del repositorio y configure el proceso de extracción para que use SSH.

   

5. Actualice los pasos de YAML de la canalización para usar el complemento git-ssh-checkout. Por ejemplo, el siguiente archivo YAML de canalización utiliza la acción de extracción con la clave del secreto de Buildkite anterior:

   agents:
     project: "codebuild-myProject"
   steps:
     - command: "npm run build"
       plugins:
         - git-ssh-checkout#v0.4.1:
             ssh-secret-key-name: 'SOURCE_SSH_KEY'

6. Al ejecutar un trabajo de ejecución autohospedado en Buildkite CodeBuild, Buildkite ahora usará automáticamente el valor secreto que hayas configurado al acceder a tu repositorio privado