Visualizador de GitLab CI

Cómo funciona

1. 01

   Pega o suelta .gitlab-ci.yml

   El archivo de pipeline de la raíz de tu proyecto. Las anclas de YAML, las plantillas de extends y las etiquetas !reference no son problema, y una cabecera spec de componente de CI/CD al principio se omite.

2. 02

   Mira el pipeline por columnas

   Los stages se convierten en columnas de izquierda a derecha, cada job queda en la columna de su stage, y needs conecta los jobs que empiezan antes que su stage.

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 .gitlab-ci.yml

El diagrama sigue estas palabras clave de tu archivo de pipeline:

• stagesstage

  Los stages como columnas, en el orden de tu lista stages, o build, test y deploy si no hay lista. Un job sin stage va a test, y los stages sin jobs no se dibujan.

• script

  Cada job como una tarjeta en la columna de su stage. Las claves que empiezan por un punto son plantillas: no se dibujan como jobs, pero siguen dando forma a los jobs que heredan de ellas.

• needsneeds: []

  Una conexión desde cada job listado en needs, para que destaquen los jobs que empiezan antes que su stage. needs: [] marca un job que empieza enseguida. Una conexión se dibuja discontinua cuando la entrada de needs es opcional o el job que espera tiene rules, only o except.

• extends

  extends resuelto a través de hasta 11 niveles de plantillas, junto con las anclas de YAML y las claves de fusión, para que se dibujen los valores heredados de stage, needs, when, parallel, trigger y environment.

• parallelparallel:matrix

  parallel: 3 o parallel:matrix mantiene el job como una sola tarjeta, marcada ×3 o con el número de combinaciones de la matriz.

• trigger

  Los jobs de disparo conectados con una tarjeta de lo que inician: el archivo del pipeline hijo indicado en trigger: include, o el proyecto downstream de trigger: project.

• environment

  Cada entorno, como review, staging o production, como una tarjeta conectada desde los jobs que despliegan en él.

• when: manual

  Los jobs manuales marcados con · manual, para que destaquen los pasos de aprobación de tu pipeline.

Qué deja fuera un diagrama de GitLab CI

• La configuración añadida con include, ya sean archivos locales, otros proyectos, URL remotas, plantillas o componentes de CI/CD: no se descarga, y los jobs que heredan de una plantilla de esos archivos se listan en las advertencias.
• Si rules, only o except añadirían u omitirían un job: no se evalúan, así que se dibujan todos los jobs.
• Las variables y sus valores, los scripts, las imágenes, las cachés y las rutas de artefactos.
• Las ejecuciones del pipeline: estado de los jobs, duraciones, logs y artefactos. El diagrama muestra la configuración, no una ejecución concreta.