GitHub ejemplo de solicitud de extracción y filtro de webhook para CodeBuild - AWS CodeBuild
Crear proyecto de GitHub compilaciónComprobaciones de verificación

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

GitHub ejemplo de solicitud de extracción y filtro de webhook para CodeBuild

AWS CodeBuildadmite webhooks cuando el repositorio de origen es GitHub. Esto significa que para un proyecto de CodeBuild compilación que tiene el código fuente almacenado en un GitHub repositorio, los webhooks se pueden utilizar para volver a compilar el código fuente cada vez que un cambio de código se introduce en el repositorio.

nota

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

Cree un proyecto de compilación GitHub como repositorio de origen y habilite webhooks (consola)

  1. Abra laAWS CodeBuild consola en https://console.aws.amazon.com/codesuite/codebuild/home.

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

  3. Elija Create build project (Crear proyecto de compilación).

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

    Project name (Nombre de proyecto)

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

  5. En Source (Código fuente):

    Proveedor de origen

    Escoja GitHub. Siga las instrucciones para conectarse (o volver a conectarse) con GitHub y, a continuación, seleccione Autorizar.

    Repositorio

    Selecciona Repositorio en mi GitHub cuenta.

    GitHub repositorio

    Introduce la URL de tu 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. Elija Agregar grupo de filtros para agregar otro grupo de filtros, si es necesario.

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

  7. En Environment (Entorno):

    Imagen del entorno

    Elija una de las siguientes opciones:

    Para usar una imagen de Docker gestionada porAWS CodeBuild:

    Seleccione Imagen gestionada y, a continuación, seleccione el sistema operativo, el tiempo de ejecución, la imagen y la versión de la imagen. Realice una selección en Environment type (Tipo de entorno) si está disponible.

    Para usar otra imagen de Docker:

    Elige Imagen personalizada. Para el tipo de entorno, elija ARM, Linux, GPU Linux o Windows. Si elige Other registry (Otro registro), para External registry URL (URL de registro externo), introduzca el nombre y etiqueta de la imagen de Docker en Docker Hub, usando el formato docker repository/docker image name. Si elige Amazon ECR, utilice el repositorio de Amazon ECR y la imagen de Amazon ECR para elegir la imagen de Docker en suAWS cuenta.

    Para usar una imagen privada de Docker:

    Elige Imagen personalizada. Para el tipo de entorno, elija ARM, Linux, GPU Linux o Windows. En Image registry (Registro de imagen), elija Other registry (Otro registro) y, a continuación, introduzca el ARN de las credenciales para su imagen de Docker privada. Secrets Manager debe crear las credenciales. Para obtener más información, consulte ¿Qué es AWS Secrets Manager? en la Guía del usuario de AWS Secrets Manager.

    Función de servicio

    Elija una de las siguientes opciones:

    • Si no tiene un rol CodeBuild de 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 Función de servicio existente. En Role ARN, elija el rol de servicio.

    nota

    Cuando utiliza la consola de para crear o actualizar un proyecto de compilación, puede 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 Buildspec, lleve a cabo una de las siguientes operaciones:

    • Elija Usar un archivo buildspec para usar el archivo buildspec.yml 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

    Elija 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 el resultado de la compilación en un bucket de S3, elija Amazon S3 y, a continuación, haga lo siguiente:

      • Si desea utilizar su nombre de proyecto para el archivo ZIP o carpeta de salida de la compilación, deje en blanco Name (Nombre). 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 desea producir un archivo ZIP, incluya la extensión zip.

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

      • Si eligió Insert build commands (Insertar comandos de compilación) anteriormente en este procedimiento, en Output files (Archivos de salida), escriba las ubicaciones de los archivos de la compilación que desea incluir en el archivo ZIP 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 Create build project (Crear proyecto de compilación). En la página Review (Revisar), elija Start build (Comenzar compilación) para ejecutar la compilación.

Comprobaciones de verificación

  1. Abra laAWS CodeBuild consola en https://console.aws.amazon.com/codesuite/codebuild/home.

  2. En el panel de navegación, elija Build projects.

  3. Haga una de las siguientes acciones:

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

    • Selecciona el botón situado junto al proyecto de compilación con los webhooks que deseas verificar, selecciona Ver detalles y, a continuación, elige la pestaña Detalles de la compilación.

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

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

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