Visualiseur GitHub Actions

Comment ça marche

1. 01

   Collez un fichier de workflow

   N’importe quel fichier YAML de .github/workflows, comme ci.yml ou deploy.yml. Pour comparer plusieurs workflows, collez-les ensemble en les séparant par une ligne ---.

2. 02

   Voyez le pipeline

   Une carte de déclenchement lance le flux, les jobs suivent de gauche à droite dans l’ordre fixé par needs, et chaque job est relié aux environnements où il déploie et aux conteneurs de service qu’il utilise.

3. 03

   Ouvrez-le dans Archboard

   Enregistrez-le comme nouveau diagramme pour réorganiser les jobs, ajouter des notes, partager un lien ou l’exporter en SVG et PNG. Un compte Google ou GitHub suffit pour s’inscrire.

Ce qui est dessiné à partir d’un fichier de workflow

Ces clés du workflow façonnent le diagramme :

• on

  Une carte de déclenchement par workflow, qui affiche ses deux premiers événements et le nombre des autres, comme push · pull_request +1, reliée à chaque job qui démarre en premier. workflow_call et workflow_run ont leurs propres cartes.

• jobs

  Chaque job sous forme de carte avec son nom, ou son identifiant de job lorsque le nom contient une expression. Les étapes sont comptées plutôt que dessinées, et les jobs avec une condition if reçoivent des lignes entrantes en pointillés.

• needs

  Un lien depuis chaque job listé sous needs vers le job qui l’attend, pour lire l’ordre que suit une exécution. Les identifiants de job inconnus et les cycles apparaissent comme avertissements.

• strategy.matrix

  Un job de matrice reste une seule carte marquée du nombre de jobs qu’il crée, par exemple ×6, compté comme GitHub l’étend, avec include et exclude appliqués. Une matrice construite à partir d’une expression affiche ×?.

• environment

  Chaque environnement de déploiement, comme staging ou production, sous forme de carte, relié aux jobs qui y déploient.

• services

  Les conteneurs de service sous forme de cartes rattachées à leur job : les images postgres, redis et mongo ont leurs cartes de base de données, et toute autre image une carte de conteneur.

• uses

  Un job qui utilise un workflow réutilisable est une seule carte avec son nom ou le chemin du workflow, reliée par needs comme n’importe quel autre job.

Ce qu’un diagramme de workflow laisse de côté

• Les étapes individuelles, leurs scripts run et les actions qu’elles utilisent : les étapes sont seulement comptées.
• Les résultats d’exécution : si une exécution a réussi ou échoué, la durée des jobs et leurs logs. Le diagramme montre le workflow tel qu’il est écrit.
• Les jobs d’un workflow réutilisable, qu’il se trouve dans le même dépôt ou dans un autre : son fichier n’est pas récupéré, il reste donc une seule carte.
• Le résultat des conditions if et des expressions : un job est dessiné même si sa condition le ferait sauter, et env, secrets et les entrées with ne sont pas lus.