Disparadores de las automatizaciones

Traducción asistida por IA · idioma: ES · fuente: pt-br/fluxos/automacoes-gatilhos.md · fuenteHash: sha256:6a4fbb51f866c2ad3820ebf2c52e5bef843c85a2966978a92c1cea93af16c890 · revisión humana pendiente.

El disparador es el “cuándo” de la automatización. En la frase del editor, haz clic en cuando esto ocurra y elige uno de los cinco tipos.

Disparador	Se dispara cuando	Necesita
Horario	Llega la hora marcada	Elyra abierto
Git del proyecto	Hay un commit, push, cambio de branch, merge o conflicto en el repositorio del proyecto	Elyra abierto
Evento de Elyra	Un agente termina o te espera, llega un mensaje a una tarjeta, o un comando falla	Elyra abierto
GitHub o GitLab	Se abre o se fusiona un PR, se pide una revisión, falla el CI o se abre una issue	Elyra Cloud activo
Webhook	Otro sistema hace una llamada firmada a la URL de la automatización	Elyra Cloud activo

Los dos últimos aparecen como Requiere Elyra Cloud activo y quedan no disponibles mientras el Cloud no esté activo en este computador.

Horario

Elige la repetición:

Forma	Ejemplo	Cuándo usarla
Todos los días	Todos los días a las 9:00	Casi siempre
Días laborables	Días laborables a las 9:00	Rutina de trabajo
Semanal	Lunes a las 9:00	Una vez por semana
Cada hora	Cada hora, en el minuto 30	Se elige el minuto
Cron	0 9 * * 1-5	Un horario específico

El cron tiene cinco campos: minuto, hora, día, mes y día de la semana. El editor dice si la expresión es válida. También se elige la zona horaria (por defecto, la de este computador): un “a las 9” en la zona equivocada se ejecuta a la hora equivocada.

Si Elyra está cerrado a la hora marcada, la ejecución no ocurre y queda registrada en el historial.

Git del proyecto

Marca uno o más eventos:

Evento	Cuándo
commit	Un commit nuevo en el repositorio
push	El push se percibe por el avance de la branch remota; es una aproximación
cambio de branch	La branch en uso cambió
merge	Hubo un merge
conflicto	Apareció un conflicto

El campo Solo en la branch limita el disparador: vacío, vale cualquier branch; con un nombre, solo se dispara cuando el evento ocurre con esa branch en uso.

Elyra observa el repositorio del proyecto, también por SSH, sin instalar nada en la carpeta .git.

Evento de Elyra

Evento	Cuándo
un agente termine	Un agente de una tarjeta del proyecto termina su trabajo
un agente te espere	Un agente queda esperando una respuesta o una decisión
llegue un mensaje a una tarjeta	Llega un mensaje a una tarjeta
un comando falle o el terminal salga con error	Un terminal termina con error
se cree una tarea en el tablero	Se guarda una tarea nueva en el tablero de trabajo del proyecto
una tarea pase a una columna	Una tarea cambia de columna; elige la columna de destino en el editor

Los eventos del tablero salen de la propia mutación guardada, sin polling. La automatización que hizo el cambio no se dispara a sí misma; otras automatizaciones pueden reaccionar y el límite de disparos evita ciclos. De qué tarjeta filtra los eventos de tarjetas; el valor por defecto es Cualquier tarjeta del proyecto.

GitHub o GitLab

Indica el proveedor, el repositorio con el formato propietario/nombre y los eventos:

Evento	GitHub	GitLab
PR abierto	Pull request abierto	Merge request abierto
PR fusionado	Pull request cerrado como fusionado	Merge request fusionado
Revisión solicitada	Revisión solicitada en un pull request	No hay un evento equivalente
CI falló	Ejecución de workflow, check suite o check run con fallo	Pipeline con fallo
Issue abierta	Issue abierta	Issue abierta

Después de guardar, abre el detalle de la automatización: allí están la URL (Copiar URL) y el secreto, que pegas en el proveedor. El paso a paso está en Webhook, GitHub y GitLab.

Webhook

Una llamada de otro sistema dispara la automatización. También depende de Elyra Cloud, una URL y un secreto. El paso a paso, con curl, está en Webhook, GitHub y GitLab.

Por la línea de comandos

El disparador va en --trigger-json, un objeto JSON con el campo kind:

kind	Campos	Ejemplo
schedule	expression (cron o RRULE), timezone; opcional dtstart	{"kind":"schedule","timezone":"America/Sao_Paulo","expression":"0 22 * * *"}
git-local	repoId, events (commit, push, branch-change, merge, conflict), branch (opcional)	{"kind":"git-local","repoId":"mi-proyecto","events":["commit"]}
elyra-event	events (agent-finished, agent-waiting, card-message, terminal-error, work-item-created, work-item-moved), cardId (opcional), columnId (obligatorio con work-item-moved)	{"kind":"elyra-event","events":["work-item-moved"],"columnId":"done"}
git-remote	provider (github o gitlab), repo (propietario/nombre), events (pr-opened, pr-merged, review-requested, ci-failed, issue-opened)	{"kind":"git-remote","provider":"github","repo":"empresa/proyecto","events":["pr-opened"]}
webhook	ninguno	{"kind":"webhook"}

• En un disparador schedule, los campos de horario vienen del propio JSON; no lo combines con --trigger, --schedule, --time, --day ni --timezone.
• Para cualquier otro kind, --trigger, --prompt y --provider siguen siendo obligatorios: son el texto que leen las versiones antiguas de Elyra.
• Al editar con elyra automations edit, --trigger-json reemplaza el disparador entero.

Límites que valen para todos

• Un disparo cada 30 segundos, por automatización. Si el disparador se activa de nuevo antes de eso, la ejecución siguiente no ocurre y queda en el historial como “No ejecutada: límite de disparos”.
• Cola de apertura. Si llegan más de 50 eventos mientras Elyra se abre, los sobrantes se descartan y el historial muestra “No ejecutada: cola de eventos llena”.
• Sin Cloud, sin cola. Si el Cloud está apagado cuando llama GitHub, GitLab o el otro sistema, este tiene que reenviar la llamada: Elyra no guarda una cola.

Ver también

• Crear una automatización
• Acciones
• Ejecutar ahora y leer el historial