Ejecución condicional y dependencias entre jobs

No todos los pasos deben ejecutarse siempre. Puede que quiera que un paso de despliegue se ejecute solo en la rama main o que un paso de notificación se ejecute solo cuando algo falle.

GitHub Actions permite asociar una condición if a cualquier paso o trabajo para controlar si se ejecuta.

Añada una clave if: a un paso. El paso solo se ejecuta cuando la expresión se evalúa como true.

Las expresiones dentro de if no necesitan el envoltorio ${{ }}, aunque se permite usarlo.

Las condiciones se leen de los objetos de contexto que describen la ejecución:

• github — event, ref, actor, sha
• env — variables de entorno
• job y steps — estado del trabajo anterior
• runner — sistema operativo y arquitectura

Por ejemplo, github.event_name le indica si un push o un pull_request desencadenó la ejecución.

De forma predeterminada, un paso se omite si un paso anterior falla. Para anular este comportamiento, utilice las funciones de estado:

• success() — verdadero si ningún paso anterior falló (opción predeterminada)
• failure() — verdadero si algún paso anterior falló
• always() — se ejecuta pase lo que pase
• cancelled() — verdadero si se canceló la ejecución

Un patrón habitual es un paso de limpieza que debe ejecutarse aunque fallen pasos anteriores. Utilice if: always().

Esto garantiza que los recursos temporales, los contenedores o los informes de pruebas se gestionen independientemente del resultado.

La palabra clave needs hace que un trabajo espere a otros. Sin ella, los trabajos se ejecutan en paralelo.

Un trabajo incluido en needs debe finalizar correctamente antes de que se inicie el trabajo dependiente.

Un trabajo puede depender de varios trabajos pasando una lista a needs. Espera a que todos terminen.

Así se crean patrones de convergencia, en los que un trabajo final se ejecuta solo después de que todos los trabajos paralelos hayan finalizado correctamente.

La clave if también funciona en los trabajos, no solo en los pasos. Una condición a nivel de trabajo decide si se ejecuta el trabajo completo.

Aquí, el trabajo de despliegue se ejecuta únicamente para los push a main, aunque sigue dependiendo de las pruebas.

Los trabajos pueden pasar datos a trabajos posteriores mediante outputs. Un trabajo dependiente los lee a través del contexto needs.

Esto permite que una condición dependa de un valor calculado anteriormente, como si ha cambiado una versión.

Puede combinar expresiones con && (y), || (o) y ! (no).

Este ejemplo se ejecuta únicamente para un push correcto a main que no procede de un fork.

Atención: un trabajo con needs se omite si falla una dependencia. Para ejecutar un trabajo final de generación de informes independientemente del resultado, combine needs con if: always().

Dentro puede inspeccionar needs.<job>.result para decidir qué informar.

Compruebe su comprensión de la ejecución condicional.

Ha aprendido a controlar el flujo de trabajo con condiciones y dependencias.

• if controla los pasos y trabajos mediante expresiones
• Las funciones de estado, como failure() y always(), anulan la omisión tras un fallo
• needs crea patrones de ordenación y convergencia
• Los outputs de los trabajos proporcionan valores para condiciones posteriores

Estas primitivas le permiten crear canalizaciones precisas y eficientes.