Saltar al contenido
Visualización CI/CD

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.

graph TD A[Start] --> B[Input YAML] B --> C[Visualize]

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.

    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.

    Guía

    Có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.
    Ejemplos

    Ejemplos de entrada y salida

    Dependencias básicas entre trabajos

    Entrada
    jobs:
      build:
        runs-on: ubuntu-latest
      test:
        needs: build
        runs-on: ubuntu-latest
      deploy:
        needs: test
        runs-on: ubuntu-latest
    Salida
    graph TD
      build
      test
      build --> test
      deploy
      test --> deploy
    FAQ

    Preguntas 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 uso

    Casos 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.
    Notas

    Notas 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 de

    Acerca 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 needs refleja 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

    Artículos recientes