Visualizador de GitHub Actions
Pega el YAML de un workflow de GitHub Actions y lee las dependencias entre jobs (needs) y las convierte en un diagrama de flujo Mermaid. Los jobs son cajas y los needs son flechas, así que se ve qué jobs corren en paralelo y cuáles esperan a otro, lo que ayuda a encontrar por qué el CI es lento. Si un nombre de job en needs no existe, se dibuja con contorno rojo discontinuo para detectar el error antes de ejecutar. La salida es sintaxis Mermaid que puedes pegar directamente en un README, issue o pull request de GitHub, y también puedes introducir nombres de jobs y dependencias para generar un YAML inicial con needs. Los steps, matrix y condiciones if aparecen dentro de las cajas al activar los detalles. Todo se procesa en tu navegador y tu YAML no se envía.
El YAML que introduces y las opciones de vista se guardan automáticamente en este navegador (no se envía nada a ningún servidor), así podrás continuar la próxima vez.
Comprobar la seguridad del workflow
Busca problemas habituales de seguridad y mantenimiento en el YAML de arriba: actions sin fijar, permisos amplios del token, inyección de scripts, pull_request_target y más. Solo lee el texto; no se ejecuta ni se envía nada.
No se encontraron problemas.
Ejecuciones y estimación de coste
Expande la matriz de cada job (también include / exclude) en número de ejecuciones y estima los minutos facturables. Lista los secrets y variables que debes registrar. Solo lee el YAML de arriba.
| Job | Ejecuciones | Runners | Min. c/u | Min. facturables |
|---|
Secrets y variables que debes registrar
Todo lo que el workflow lee de secrets.* y vars.*. Regístralos en Settings del repositorio antes de la primera ejecución.
GITHUB_TOKEN se proporciona automáticamente, por eso no aparece.
GuíaCómo usarlo y características
- Pega tu YAML de GitHub Actions en el cuadro "Introduce el YAML del flujo de trabajo".
- Haz clic en el botón "Visualizar" para renderizar el diagrama a la derecha.
- Las dependencias entre trabajos (needs) se dibujan como flechas (-->).
- Haz clic en "Copiar código Mermaid" para obtener el código y usarlo en el Markdown de GitHub u otras herramientas compatibles con Mermaid.
EjemplosEjemplos de entrada y salida
Dependencias básicas entre trabajos
jobs:
build:
runs-on: ubuntu-latest
test:
needs: build
runs-on: ubuntu-latest
deploy:
needs: test
runs-on: ubuntu-latestgraph TD build test build --> test deploy test --> deploy
FAQPreguntas frecuentes
¿Puede visualizar flujos de trabajo grandes?
Sí, pero para flujos con muchísimos trabajos (decenas o más), el diagrama puede ser enorme y difícil de leer. En esos casos, considera visualizar partes lógicas más pequeñas.¿Admite dependencias que no sean "needs"?
Actualmente, la herramienta solo visualiza dependencias a nivel de trabajo definidas por la propiedad "needs". No se visualizan los pasos individuales dentro de los trabajos.¿Son seguros mis datos YAML?
Totalmente. Todo el procesamiento ocurre localmente en tu navegador. No se envían datos a nuestros servidores, por lo que es seguro para configuraciones privadas o empresariales.
Casos de usoCasos de uso habituales
Ver de un vistazo los vínculos `needs` y el orden de ejecución
Pega el YAML de un workflow y los jobs se convierten en cajas, con `needs` como flechas. Se ve qué jobs corren en paralelo y cuáles esperan a otro, lo que ayuda a encontrar por qué el CI es lento (jobs encadenados en serie).Detectar errores tipográficos en `needs`
Si un nombre de job en `needs` no existe, ese job se dibuja con contorno rojo discontinuo. Un error como `biuld` en lugar de `build` aparece antes de ejecutar el workflow.Incluir diagramas de workflows en README y documentos de diseño
La salida es sintaxis Mermaid. Pégala en un README, issue o pull request de GitHub y se muestra como diagrama. Tras editar el YAML, vuelve a pegar para mantenerlo actualizado.Esbozar un workflow nuevo
Introduce nombres de jobs, `runs-on` y dependencias para generar un YAML inicial con `needs`. Puedes comprobar un flujo build → test → deploy como diagrama antes de escribirlo.
NotasNotas y limitaciones
Solo dibuja `needs` entre jobs
No se muestran el contenido de los steps, `matrix`, las condiciones `if`, los disparadores (`on`) ni la expansión de workflows reutilizables (`uses`). El orden real de ejecución puede variar según estos elementos.No valida el workflow
Si la entrada se lee como YAML y tiene `jobs`, dibuja el diagrama. No comprueba que cumpla el esquema de GitHub, que los valores de `runs-on` o `uses` sean válidos ni que `needs` forme un ciclo. Valida ejecutándolo en GitHub o con `actionlint`.La etiqueta usa `name`, o el ID del job si no existe
Se muestra el `name` del job en la caja y, si no hay, su ID. Los ID con palabras reservadas o símbolos de Mermaid se sustituyen por un nombre interno seguro en el diagrama, pero el texto mostrado no cambia.El YAML generado es una plantilla inicial
Genera un YAML mínimo que se ejecuta con `push`, donde cada job solo ejecuta `echo`. Añade tú los steps reales, los disparadores `on` y los `secrets`. No escribas ni pegues valores secretos en el YAML (la entrada se procesa en el navegador y no se envía).
Acerca deAcerca de esta herramienta
Visualizador de GitHub Actions
Visualiza workflows de GitHub Actions para entender jobs, dependencias y relaciones needs. Ayuda a revisar pipelines complejos y detectar cuellos de botella o dependencias incorrectas.
Usos comunes
- Revisar CI/CD: entiende el orden de ejecución de jobs.
- Depurar dependencias: comprueba si
needsrefleja el flujo esperado. - Documentar pipelines: comparte una vista más clara del workflow.
Antes de modificar un workflow crítico, revisa también permisos, secrets y triggers.
Artículos para esta herramienta
Visualización de flujos de trabajo de GitHub Actions: comprensión de canalizaciones complejas
Visualice las dependencias entre trabajos (needs) de GitHub Actions con Mermaid.js: notación string/array, patrones fan-out/fan-in/matrix y dependencias circulares.
Patrones de diseño de needs en GitHub Actions: acelere la CI y evite los antipatrones
Patrones para dependencias entre jobs (needs) en GitHub Actions: ramificación en diamante, cancelación con concurrency, fail-fast, matrix y workflows reutilizables.
