Una automatización comienza a trabajar sin que nadie la solicite cada vez: se ejecuta según un horario o cuando ocurre algo: se abre un pull request, se registra un incidencia, o falla una comprobación o un despliegue.
Cada automatización aparece en la fábrica bajo el apartado Automatizaciones, indicando qué la activa y qué hace. Crea una en Nuevo trabajo: selecciona Automatización y luego el momento en que debe ejecutarse.
- ProgramarHora
- Automatización de eventosAlgo ocurre.
Una tarea ordinaria
Especificación, plan, desarrollo, verificación, revisión. Utiliza un espacio de agente; asigna una prioridad más baja.
P2P3Una solicitud de incorporación de cambios de pull request
No puede fusionarse por sí mismo ni confirmar cambios en tu rama base.
Tú apruebas
Dos tipos de desencadenadores
| Desencadenador | Ejecuciones | Ejemplo |
|---|---|---|
| Un horario | A una hora determinada, a intervalos o una vez ahora mismo. | Preguntar a Sentry cada hora por nuevos errores y abrir una tarea para cada uno. |
| Ocurre algo | Cuando GitHub o Coroid envían el evento. | Revisar cada pull request abierto en un proyecto. |
Utiliza un horario cuando el desencadenador depende realmente del tiempo, o cuando lo que hay que vigilar reside en otro sistema que no envía eventos Coroid, como Sentry o Jira. El horario consulta ese sistema a través de tu . Servidores MCP y genera trabajo según lo que encuentre. Consulta Programaciones.
Usa un evento cuando Coroid puede notificarlo en el instante en que ocurre. Realiza menos trabajo innecesario que un horario que sigue preguntando.
Eventos que puedes elegir en Nuevo trabajo
Desde GitHub, lo cual requiere el GitHub App:
- Se abre, actualiza o fusiona un pull request.
- Se abre una incidencia.
- Un comentario menciona a Coroid; solo cuenta si su autor tiene acceso de escritura al repositorio.
Desde Coroid:
- Falla una tarea, un plan, una comprobación de Calidad, un despliegue o una comprobación de salud del despliegue.
- Se revierte una versión.
Los mensajes de Slack y Telegram, las nuevas incidencias de Jira y los eventos que generan tus propios sistemas necesitan un filtro o una cuenta de servicio. Inícialos desde una plantilla en Configuración, dentro de Automatización, o modifica el evento de una automatización en su editor. Consulta . Enlaces.
Qué hace
Cuando se dispara su evento, una automatización realiza una de estas tres acciones:
- Revisar el pull request. Coroid Check lo revisa y publica su reseña en GitHub, con comentarios sobre las líneas detectadas y una comprobación llamada Coroid Revisión. Disponible para pull requests que se abren o actualizan.
- Convertirlo en trabajo. El evento se registra como solicitud. Una vez que la Calificación la apruebe, Coroid crea la tarea o el plan. Disponible para incidencias y para comentarios que mencionen a Coroid.
- Seguir las instrucciones. Un agente sigue las instrucciones que tú escribiste, con acceso de solo lectura, y puede abrir tareas. Disponible para cualquier evento.
Ninguna de ellas modifica tu código directamente. El trabajo que abre una automatización sigue el mismo proceso de especificación, planificación, compilación, verificación y revisión que cualquier otra cosa, y termina en un pull request que tú apruebas.
Revisar cada pull request
Para que Coroid revise los pull requests que abren los usuarios, no solo los propios:
- Abre Nuevo trabajo y selecciona Automatización.
- Elige el proyecto o déjalo vacío para abarcar todos los proyectos.
- En Desencadenador, selecciona Cuando ocurra algo. En Evento, elige Pull request abierto y luego Revisar el pull request.
- Dale un título y un breve resumen, y luego continúa.
La automatización revisa cada nuevo pull request y cada actualización del mismo en ese proyecto. El repositorio necesita la GitHub App y el proyecto no debe estar configurado como Local únicamente. Los pull requests provenientes de tareas de Coroid no se revisan de nuevo: su revisión forma parte de la tarea.
También puedes activar Pull requests para el proyecto en Control de Calidad. Entonces las comprobaciones del proyecto se ejecutarán en cada pull request y Coroid Check lo revisará como parte de la misma ejecución.
Supervisar una automatización
Abre una automatización en la fábrica para ver cada ejecución: cuándo se realizó, cuánto costó, qué abrió y por qué una ejecución no finalizó. Desde allí, los propietarios y administradores pueden pausarla, probarla, editarla o eliminarla. Todas las personas de la organización pueden ver las automatizaciones y sus ejecuciones.
Mantener las automatizaciones útiles
El trabajo que abre una automatización compite por los mismos espacios de agente que todo lo demás. Una que se active con frecuencia puede consumir silenciosamente tu capacidad.
- Dale una prioridad más baja que el trabajo solicitado por las personas.
P2oP3. - Haz el desencadenador específico. "Falla una comprobación" se activa constantemente en un repositorio muy concurrido. "Esta comprobación falló en la rama base" se activa cuando realmente hay un problema.
- Observa lo que produjo. Si una automatización abrió veinte tareas y tú fusionaste solo dos, está generando ruido y gastos, no valor.
La medida objetiva de una automatización es cuánto del trabajo que abre se fusiona, no con qué frecuencia se activa.
Sentinel
Versiones anteriores de estos documentos describían a Sentinel, un monitor que vigila una condición. No es una función separada. Una condición es bien un evento, que una automatización puede utilizar, o algo que un horario comprueba.