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.
Añadir activadores a los flujos de trabajo
Sigue las siguientes instrucciones para añadir un activador de inserción, extracción o programación a tu CodeCatalyst flujo de trabajo de Amazon.
Para obtener más información acerca de los disparadores, consulte Iniciar un flujo de trabajo, ejecutarlo automáticamente mediante activadores.
- Visual
-
Para añadir un disparador (editor visual)
Abra la CodeCatalyst consola en https://codecatalyst.aws/
. -
Elija el proyecto.
-
En el panel de navegación, elija CI/CD y, a continuación, elija Flujos de trabajo.
-
Elija el nombre de su flujo de trabajo. Puede filtrar por el nombre del repositorio o la rama de origen donde está definido el flujo de trabajo, o bien filtrar por nombre o estado del flujo de trabajo.
-
Elija Editar.
-
Elija Visual.
-
En el diagrama de flujo de trabajo, seleccione las casillas Origen y Desencadenadores.
-
En el panel de configuración, seleccione Añadir disparador.
-
En el cuadro de diálogo Agregar activador, introduzca la información en los campos, de la siguiente manera.
Tipo de disparador
Especifique el tipo de disparador. Puede utilizar uno de los siguientes valores:
-
Push (editor visual) o
PUSH
(YAMLeditor)Un pulsador inicia la ejecución de un flujo de trabajo cuando se envía un cambio a tu repositorio de origen. La ejecución del flujo de trabajo utilizará los archivos de la rama a la que vayas a enviar (es decir, la rama de destino).
-
Pull request (editor visual) o
PULLREQUEST
(YAMLeditor)Un activador de solicitudes de extracción inicia la ejecución de un flujo de trabajo cuando se abre, actualiza o cierra una solicitud de extracción en tu repositorio de origen. La ejecución del flujo de trabajo utilizará los archivos de la rama de la que estás extrayendo (es decir, la rama de origen).
-
Programación (editor visual) o
SCHEDULE
(YAMLeditor)Un activador de programación inicia las ejecuciones del flujo de trabajo según una programación definida por una expresión cron que usted especifique. Se iniciará una ejecución de flujo de trabajo independiente para cada rama del repositorio de origen utilizando los archivos de la rama. (Para limitar las ramas en las que se activa el activador, usa el campo Ramas (editor visual) o la
Branches
propiedad (YAMLeditor).)Al configurar un activador programado, siga estas pautas:
-
Utilice solo un activador de programación por flujo de trabajo.
-
Si ha definido varios flujos de trabajo en su CodeCatalyst espacio, le recomendamos que no programe más de 10 de ellos para que se inicien simultáneamente.
-
Asegúrese de configurar la expresión cron del disparador con el tiempo adecuado entre ejecuciones. Para obtener más información, consulte Expression.
-
Para ver ejemplos, consulte Ejemplos: desencadenantes en los flujos de trabajo.
Eventos para la solicitud de cambios
Este campo solo aparece si seleccionaste el tipo de activación de la solicitud de extracción.
Especifica el tipo de eventos de solicitud de extracción que iniciarán la ejecución de un flujo de trabajo. Los valores válidos son los siguientes:
-
Se crea una solicitud de extracción (editor visual) o
OPEN
(YAMLeditor)La ejecución del flujo de trabajo se inicia cuando se crea una solicitud de extracción.
-
La solicitud de extracción está cerrada (editor visual) o
CLOSED
(YAMLeditor)La ejecución del flujo de trabajo se inicia cuando se cierra una solicitud de extracción. El comportamiento del
CLOSED
evento es complicado y se entiende mejor con un ejemplo. Para obtener más información, consulte Ejemplo: un gatillo al que se tira, se ramifica y se produce un evento CLOSED «». -
Se realiza una nueva revisión a través de pull request (editor visual) o
REVISION
(YAMLeditor)La ejecución del flujo de trabajo se inicia cuando se crea una revisión de una solicitud de extracción. La primera revisión se crea cuando se crea la solicitud de extracción. Después, se crea una nueva revisión cada vez que alguien envía una nueva confirmación a la rama de origen especificada en la solicitud de extracción. Si incluyes el
REVISION
evento en el activador de la solicitud de cambios, puedes omitirlo, ya queREVISION
es un superconjunto de.OPEN
OPEN
Puedes especificar varios eventos en el mismo activador de la solicitud de atracción.
Para ver ejemplos, consulte Ejemplos: desencadenantes en los flujos de trabajo.
Programación
Este campo solo aparece si seleccionaste el tipo de activación Programar.
Especifique la expresión cron que describe cuándo desea que se ejecute el flujo de trabajo programado.
Las expresiones cron utilizadas CodeCatalyst utilizan la siguiente sintaxis de seis campos, en la que cada campo está separado por un espacio:
minutes
hours
days-of-month
month
days-of-week
year
Ejemplos de expresiones cron
Minutos Horas Días del mes Mes Días de la semana Año Significado 0
0
?
*
MON-FRI
*
Ejecuta un flujo de trabajo a medianoche (UTC+0) de lunes a viernes.
0
2
*
*
?
*
Ejecuta un flujo de trabajo a las 2:00 a.m. (UTC+0) todos los días.
15
22
*
*
?
*
Ejecuta un flujo de trabajo a las 22:15 (UTC+0) todos los días.
0/30
22-2
?
*
SAT-SUN
*
Ejecuta un flujo de trabajo cada 30 minutos de sábado a domingo, entre las 22:00 del día de inicio y las 2:00 del día siguiente (UTC+0).
45
13
L
*
?
2023-2027
Ejecuta un flujo de trabajo a las 13:45 (UTC+0) del último día del mes entre los años 2023 y 2027, ambos inclusive.
Al especificar las expresiones cron CodeCatalyst, asegúrate de seguir estas pautas:
-
Especifique una sola expresión cron por
SCHEDULE
activador. -
Escriba la expresión cron entre comillas dobles (
"
) en el editor. YAML -
Especifique la hora en Hora universal coordinada (). UTC No se admiten otras zonas horarias.
-
Configure al menos 30 minutos entre ejecuciones. No se admite una cadencia más rápida.
-
Especifique el
days-of-month
odays-of-week
campo, pero no ambos. Si especifica un valor o un asterisco (*
) en uno de los campos, debe utilizar un signo de interrogación (?
) en el otro. El asterisco significa «todos» y el signo de interrogación significa «cualquiera».
Para obtener más ejemplos de expresiones cron e información sobre caracteres comodín
?
, como, y*
L
, consulte la referencia sobre expresiones cron en la Guía del usuario de Amazon EventBridge . Las expresiones cron CodeCatalyst funcionan exactamente de EventBridge la misma manera.Para ver ejemplos de activadores de horarios, consulteEjemplos: desencadenantes en los flujos de trabajo.
Ramas y patrón de ramas
(Opcional)
Especifique las ramas del repositorio de origen que el activador supervisa para saber cuándo iniciar la ejecución de un flujo de trabajo. Puedes usar patrones de expresiones regulares para definir los nombres de tus ramas. Por ejemplo, úsalo
main.*
para hacer coincidir todas las ramas que comiencen por.main
Las ramas que se deben especificar son diferentes en función del tipo de disparador:
-
En el caso de un disparador automático, especifique las ramas a las que va a enviar el mensaje, es decir, las sucursales de destino. Se iniciará una ejecución de flujo de trabajo por cada sucursal coincidente, utilizando los archivos de la sucursal coincidente.
Ejemplos:
main.*
,mainline
-
Para activar una solicitud de cambios, especifica las sucursales a las que vas a enviar mensajes, es decir, las sucursales de destino. Se iniciará una ejecución de flujo de trabajo por cada rama coincidente, utilizando el archivo de definición del flujo de trabajo y los archivos fuente de la rama de origen (no de la rama coincidente).
Ejemplos:
main.*
,mainline
,v1\-.*
(coincide con las ramas que comienzan conv1-
) -
Para activar una programación, especifique las ramas que contienen los archivos que desea que utilice la ejecución programada. Se iniciará una ejecución de flujo de trabajo por cada rama coincidente, utilizando el archivo de definición del flujo de trabajo y los archivos fuente de la rama coincidente.
Ejemplos:
main.*
,version\-1\.0
nota
Si no especificas las ramas, el activador monitoriza todas las ramas del repositorio de origen e iniciará una ejecución de flujo de trabajo con el archivo de definición del flujo de trabajo y los archivos fuente de:
-
La rama hacia la que estás presionando (para los activadores de pulsación). Para obtener más información, consulte Ejemplo: un simple disparador de código.
-
La sucursal desde la que realizas la extracción (para activar las solicitudes de extracción). Para obtener más información, consulte Ejemplo: un sencillo disparador de solicitudes de extracción.
-
Todas las sucursales (para programar activaciones). Se iniciará una ejecución de flujo de trabajo por cada rama del repositorio de origen. Para obtener más información, consulte Ejemplo: un sencillo disparador programado.
Para obtener más información sobre las ramas y los activadores, consultePautas de uso para activadores y ramificaciones.
Para obtener más ejemplos, consulte Ejemplos: desencadenantes en los flujos de trabajo.
Se han modificado los archivos
Este campo solo aparece si ha seleccionado el tipo de activación de la solicitud Push o Pull.
Especifique los archivos o carpetas del repositorio de origen que el activador supervisa para saber cuándo iniciar la ejecución de un flujo de trabajo. Puede utilizar expresiones regulares para hacer coincidir los nombres o las rutas de los archivos.
Para ver ejemplos, consulte Ejemplos: desencadenantes en los flujos de trabajo.
-
-
(Opcional) Elija Validar para validar el YAML código del flujo de trabajo antes de confirmarlo.
-
Selecciona Confirmar, introduce un mensaje de confirmación y vuelve a seleccionar Confirmar.
- YAML
-
Para añadir un activador (YAMLeditor)
Abra la CodeCatalyst consola en https://codecatalyst.aws/
. -
Elija el proyecto.
-
En el panel de navegación, elija CI/CD y, a continuación, elija Flujos de trabajo.
-
Elija el nombre de su flujo de trabajo. Puede filtrar por el nombre del repositorio o la rama de origen donde está definido el flujo de trabajo, o bien filtrar por nombre o estado del flujo de trabajo.
-
Elija Editar.
-
Elija YAML.
-
Añada una
Triggers
sección y propiedades subyacentes utilizando el siguiente ejemplo como guía. Para obtener más información, consulte Triggers en la YAMLDefinición del flujo de trabajo.Un disparador de inserción de código podría tener este aspecto:
Triggers: - Type: PUSH Branches: - main
Un activador de pull request podría tener este aspecto:
Triggers: - Type: PULLREQUEST Branches: - main.* Events: - OPEN - REVISION - CLOSED
Un activador programado podría tener este aspecto:
Triggers: - Type: SCHEDULE Branches: - main.* # Run the workflow at 1:15 am (UTC+0) every Friday until the end of 2023 Expression: "15 1 ? * FRI 2022-2023"
Para ver más ejemplos de expresiones cron que puede utilizar en la
Expression
propiedad, consulteExpression.Para ver más ejemplos de activadores push, pull request y schedule, consulteEjemplos: desencadenantes en los flujos de trabajo.
-
(Opcional) Selecciona Validar para validar el YAML código del flujo de trabajo antes de confirmarlo.
-
Selecciona Confirmar, introduce un mensaje de confirmación y vuelve a seleccionar Confirmar.