Visualizador de GitHub Actions

Cómo funciona

1. 01

   Pega un archivo de workflow

   Cualquier archivo YAML de .github/workflows, como ci.yml o deploy.yml. Para comparar varios workflows, pégalos juntos separados por una línea ---.

2. 02

   Mira el pipeline

   Una tarjeta de disparador inicia el flujo, los jobs siguen de izquierda a derecha en el orden que marca needs, y cada job se conecta con los entornos en los que despliega y con los contenedores de servicio que usa.

3. 03

   Ábrelo en Archboard

   Guárdalo como un diagrama nuevo para reorganizar los jobs, añadir notas, compartir un enlace o exportarlo en SVG y PNG. Para registrarte basta una cuenta de Google o GitHub.

Qué se dibuja a partir de un archivo de workflow

Estas claves del workflow dan forma al diagrama:

• on

  Una tarjeta de disparador por workflow con sus dos primeros eventos y el número de los demás, como push · pull_request +1, conectada con cada job que empieza primero. workflow_call y workflow_run tienen sus propias tarjetas.

• jobs

  Cada job como una tarjeta con su nombre, o con su ID de job cuando el nombre contiene una expresión. Los pasos se cuentan en lugar de dibujarse, y los jobs con una condición if reciben líneas de entrada discontinuas.

• needs

  Una conexión desde cada job listado en needs hasta el job que lo espera, para que puedas leer el orden que sigue una ejecución. Los ID de job desconocidos y los ciclos aparecen como advertencias.

• strategy.matrix

  Un job de matriz se queda en una sola tarjeta marcada con el número de jobs que crea, como ×6, contado como lo expande GitHub, con include y exclude aplicados. Una matriz construida a partir de una expresión muestra ×?.

• environment

  Cada entorno de despliegue, como staging o production, como su propia tarjeta, conectada desde los jobs que despliegan en él.

• services

  Los contenedores de servicio como tarjetas unidas a su job: las imágenes postgres, redis y mongo reciben sus tarjetas de base de datos, y cualquier otra imagen, una tarjeta de contenedor.

• uses

  Un job que usa un workflow reutilizable es una sola tarjeta con su nombre o la ruta del workflow, conectada mediante needs como cualquier otro job.

Qué deja fuera un diagrama de workflow

• Los pasos individuales, sus scripts run y las actions que usan: los pasos solo se cuentan.
• Los resultados de ejecución: si una ejecución pasó o falló, cuánto tardaron los jobs y sus logs. El diagrama muestra el workflow tal como está escrito.
• Los jobs dentro de un workflow reutilizable, esté en el mismo repositorio o en otro: su archivo no se descarga, así que queda como una sola tarjeta.
• El resultado de las condiciones if y de las expresiones: un job se dibuja aunque su condición lo omitiera, y env, secrets y las entradas with no se leen.