Crear desencadenadores de AWS CodeBuild

CrearAWS CodeBuilddisparadores (consola)

Puede crear un disparador en un proyecto para programar una compilación una vez cada hora, día o semana. También puede crear un disparador mediante una regla personalizada con una expresión cron de Amazon CloudWatch. Por ejemplo, mediante una expresión cron puede programar una compilación en un momento específico todos los días de la semana.

nota

No es posible iniciar una compilación por lotes desde un desencadenador de compilación, un evento de Amazon EventBridge o unAWS Step Functionstarea.

Para crear un disparador

1. Abra el iconoAWS CodeBuildConsola dehttps://console.aws.amazon.com/codesuite/codebuild/home.

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

3. Elija el enlace del proyecto de compilación al que desea agregar un disparador y, a continuación, elija la pestaña Build triggers (Disparadores de compilación).

   nota

   De forma predeterminada, se muestran los 100 últimos proyectos de compilación. Para ver más proyectos de compilación, elija el icono de rueda dentada y, a continuación, seleccione un valor diferente para Projects per page (Proyectos por página) o use las flechas atrás y adelante.

4. Elija Create trigger.

5. Escriba un nombre en Trigger name (Nombre del disparador).

6. En la lista desplegable Frequency (Frecuencia), elija la frecuencia del disparador. Si desea crear la frecuencia con una expresión Cron, seleccione Custom (Personalizado).

7. Especifique los parámetros de frecuencia del disparador. Puede introducir los primeros caracteres de su selección en el cuadro de texto para filtrar los elementos del menú desplegable.

   nota

   Las horas de inicio y los minutos se basan en cero. El minuto de inicio es un número entre cero y 59. La hora de inicio es un número comprendido entre cero y 23. Por ejemplo, un disparador diario que comienza todos los días a las 12:15 h tiene una hora de inicio de 12 y un minuto de inicio de 15. Un disparador diario que comienza todos los días a medianoche tiene una hora de inicio cero y un minuto de inicio de cero. Un disparador diario que comienza todos los días a las 23:59 h tiene una hora de inicio de 23 y un minuto de inicio de 59.

   Frecuencia	Parámetros requeridos	Detalles
   Por hora	Minuto de inicio	Utilice el menú desplegable Start minute (Minuto de inicio).
   Por día	Minuto de inicio Hora de inicio	Utilice el menú desplegable Start minute (Minuto de inicio). Utilice el menú desplegable Start hour (Hora de inicio).
   Semanal	Minuto de inicio Hora de inicio Día de inicio	Utilice el menú desplegable Start minute (Minuto de inicio). Utilice el menú desplegable Start hour (Hora de inicio). Utilice el menú desplegable Start day (Día de inicio).
   Personalizado	Expresión Cron	Introduzca una expresión Cron en Cron expression (Expresión Cron). Las expresiones Cron tienen seis campos obligatorios, que están separados por un espacio en blanco. Los campos especifican un valor de inicio de minuto, hora, día del mes, día de la semana y año. Puede utilizar caracteres comodín para especificar un intervalo, valores adicionales, etc. Por ejemplo, la expresión cron0 9 ? * MON-FRI *programa una compilación todos los días de la semana a las 9:00 a. m. Para obtener más información, consulteExpresiones Cronen laGuía del usuario de Amazon CloudWatch Events.

8. Seleccione Enable this trigger (Activar este disparador).

9. (Opcional) Expanda la sección Advanced (Avanzado). En Source version (Versión de código fuente), escriba una versión del código fuente.

   • Para Amazon S3, introduzca el identificador de versión correspondiente a la versión del artefacto de entrada que desea compilar. Si la Source version (Versión del código fuente) se deja en blanco, se usará la versión más reciente.

   • En AWS CodeCommit, especifique un ID de confirmación. Si Source version (Versión del código fuente) se deja en blanco, se utilizará el ID de confirmación HEAD de la ramificación predeterminada.

   • En GitHub o GitHub Enterprise, especifique un ID de confirmación, un ID de solicitud de extracción, un nombre de ramificación o un nombre de etiqueta que se corresponda con la versión del código fuente que desea compilar. Si especifica un ID de solicitud de extracción, este debe tener el formato pr/pull-request-ID (por ejemplo, pr/25). Si especifica un nombre de ramificación, se usa el ID de confirmación HEAD de la ramificación. Si Source version (Versión del código fuente) se deja en blanco, se usa el ID de confirmación HEAD de la ramificación predeterminada.

   • En Bitbucket, especifique un ID de confirmación, un nombre de ramificación o un nombre de etiqueta que se corresponda con la versión de código fuente que desea compilar. Si especifica un nombre de ramificación, se usa el ID de confirmación HEAD de la ramificación. Si Source version (Versión del código fuente) se deja en blanco, se usa el ID de confirmación HEAD de la ramificación predeterminada.

10. (Opcional) Especifique un tiempo de espera entre 5 minutos y 480 minutos (8 horas). Este valor especifica durante cuánto tiempo AWS CodeBuild intenta ejecutar una compilación antes de detenerse. Si los campos Hours (Horas) y Minutes (Minutos) se dejan en blanco, se usa el valor de tiempo de espera predeterminado especificado en el proyecto.

11. Elija Create trigger.

CrearAWS CodeBuildse activa mediante programación

CodeBuild utiliza reglas de Amazon EventBridge para disparadores de compilación. Puede utilizar la API de EventBridge para crear programáticamente activadores de compilación para sus proyectos de CodeBuild. ConsulteReferencia del API de Amazon EventBridgepara obtener más información.