Ejecuta el ejemplo de filtro de solicitudes de GitHub extracción y webhook para CodeBuild

AWS CodeBuild admite webhooks cuando el repositorio fuente lo es GitHub. Esto significa que, en el caso de un proyecto de CodeBuild compilación que tiene su código fuente almacenado en un GitHub repositorio, los webhooks se pueden usar para reconstruir el código fuente cada vez que se introduce un cambio de código en el repositorio. Para ver CodeBuild ejemplos, consulta AWS CodeBuild Ejemplos.

nota

Al usar webhooks, es posible que un usuario active una compilación de forma inesperada. Para mitigar este riesgo, consulte Prácticas recomendadas para utilizar webhooks.

Paso 1: Crea un proyecto de compilación con webhooks GitHub y actívalos

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

2. Si aparece una página de CodeBuild información, elija Crear proyecto de compilación. De lo contrario, en el panel de navegación, expanda Compilar, elija Proyectos de compilación y, a continuación, elija Crear proyecto de compilación.

3. Elija Crear el proyecto de compilación.

4. En Project configuration (Configuración del proyecto):

   Nombre del proyecto

   Introduzca un nombre para este proyecto de compilación. Los nombres de los proyectos de compilación deben ser únicos en cada AWS cuenta. También puede introducir una descripción opcional del proyecto de compilación para ayudar a otros usuarios a entender para qué se utiliza el proyecto.

5. En Source (Código fuente):

   Proveedor de fuentes

   Elige GitHub. Sigue las instrucciones para conectarte (o volver a conectarte) GitHub y, a continuación, selecciona Autorizar.

   Repositorio

   Selecciona Repositorio en mi GitHub cuenta.

   GitHub repositorio

   Introduzca el URL para su GitHub repositorio.

6. En Eventos de webhook de origen principal, seleccione lo siguiente.

   nota

   La sección de eventos de webhook de la fuente principal solo está visible si seleccionaste Repositorio en mi GitHub cuenta en el paso anterior.

   1. Cuando cree el proyecto, seleccione Rebuild every time a code change is pushed to this repository (Volver a compilar cada vez que se inserte un cambio de código en este repositorio).

   2. En Event type (Tipo de evento), seleccione uno o varios eventos.

   3. Para filtrar en función de cuándo un evento va a desencadenar una compilación, en Start a build under these conditions (Iniciar una compilación en estas condiciones), añada uno o varios filtros opcionales.

   4. Para filtrar en función de cuándo no se va a desencadenar un evento, en Don't start a build under these conditions (No iniciar una compilación en estas condiciones), añada uno o varios filtros opcionales.

   5. Seleccione Añadir grupo de filtros para añadir otro grupo de filtros.

   Para obtener más información sobre los filtros y tipos de eventos de GitHub webhook, consulte. GitHub eventos de webhook

7. En Environment (Entorno):

   Imagen del entorno

   Seleccione una de las siguientes opciones:

   Para usar una imagen de Docker gestionada por: AWS CodeBuild

   Elija Imagen administrada y después elija opciones en Sistema operativo, Tiempo de ejecución, Imagen y Versión de imagen. Realice una selección en Environment type (Tipo de entorno) si está disponible.

   Para utilizar otra imagen de Docker:

   Elija Imagen personalizada. En el tipo de entorno ARM, elija LinuxGPU, Linux o Windows. Si elige Otro registro, en Registro externo URL, introduzca el nombre y la etiqueta de la imagen de Docker en Docker Hub, utilizando el formato. docker repository/docker image name Si eliges Amazon ECR, usa el ECRrepositorio de Amazon y la ECRimagen de Amazon para elegir la imagen de Docker en tu AWS cuenta.

   Para usar una imagen de Docker privada:

   Elija Imagen personalizada. En el tipo de entorno ARM, elige LinuxGPU, Linux o Windows. En Registro de imágenes, selecciona Otro registro y, a continuación, introduce las credenciales ARN de tu imagen privada de Docker. Es necesario crear las credenciales con Secrets Manager. Para obtener más información, consulte ¿Qué es? AWS Secrets Manager en la Guía AWS Secrets Manager del usuario.

   Rol de servicio

   Seleccione una de las siguientes opciones:

   • Si no tiene un rol de CodeBuild servicio, elija Nuevo rol de servicio. Escriba un nombre para el nuevo rol en el campo Role Name.

   • Si tiene un rol CodeBuild de servicio, elija el rol de servicio existente. En Función ARN, elija la función de servicio.

   nota

   Cuando utilizas la consola para crear o actualizar un proyecto de compilación, puedes crear un rol de CodeBuild servicio al mismo tiempo. De forma predeterminada, el rol funciona solamente con ese proyecto de compilación. Si utiliza la consola para asociar este rol de servicio a otro proyecto de compilación, el rol se actualizará para que funcione con el otro proyecto de compilación. Un rol de servicio puede funcionar con hasta diez proyectos de compilación.

8. En Archivo de especificación de compilación, realice alguna de las operaciones siguientes:

   • Seleccione Usar un archivo de especificaciones de compilación para utilizar el archivo buyildspec.yml que figura en el directorio raíz del código fuente.

   • Elija Insertar comandos de compilación para usar la consola para insertar comandos de compilación.

   Para obtener más información, consulte Referencia de la especificación de compilación.

9. En Artifacts (Artefactos):

   Tipo

   Seleccione una de las siguientes opciones:

   • Si no desea crear ningún artefacto de salida de la compilación, elija No artifacts (Sin artefactos).

   • Para almacenar la salida de la compilación en un bucket de S3, seleccione Amazon S3 y, a continuación, haga lo siguiente:

     • Si quieres usar el nombre de tu proyecto como ZIP archivo o carpeta de salida de la compilación, deja el campo Nombre en blanco. De lo contrario, escriba el nombre. De forma predeterminada, el nombre del artefacto es el nombre del proyecto. Si desea usar otro nombre, escríbalo en el cuadro de nombre de artefactos. Si quieres generar un ZIP archivo, incluye la extensión zip.

     • En Bucket name (Nombre del bucket), seleccione el nombre del bucket de salida.

     • Si eligió Insertar comandos de compilación al principio de este procedimiento, en Archivos de salida, introduzca las ubicaciones de los archivos de la compilación que desee colocar en el ZIP archivo o carpeta de salida de la compilación. Si hay varias ubicaciones, separe cada una de las ubicaciones con una coma (por ejemplo, appspec.yml, target/my-app.jar). Para obtener más información, consulte la descripción de files en Sintaxis de buildspec.

   Configuración adicional

   Expanda Additional configuration (Configuración adicional) y establezca las opciones según sea necesario.

10. Elija Crear el proyecto de compilación. En la página Review (Revisar), elija Start build (Comenzar compilación) para ejecutar la compilación.

Paso 2: Compruebe que los webhooks estén habilitados

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

2. En el panel de navegación, elija Proyectos de compilación.

3. Realice una de las siguientes acciones siguientes:

   • Elija el enlace del proyecto de compilación con webhooks que desea verificar y, a continuación, seleccione Build details (Detalles de compilación).

   • Seleccione el botón de opción situado junto al proyecto de compilación con webhooks que desea verificar, elija Ver detalles y, a continuación, elija la pestaña Detalles de compilación.

4. En los eventos de webhook de origen principal, selecciona el enlace de Webhook. URL

5. En tu GitHub repositorio, en la página de configuración, en Webhooks, comprueba que estén seleccionadas las solicitudes de extracción y inserción.

6. En la configuración GitHub de tu perfil, en Configuración personal, Aplicaciones y OAuthAplicaciones autorizadas, verás que tu aplicación está autorizada a acceder a la AWS región que seleccionaste.