Formations — 1 037 leçons en français

Accueil › Git & CI/CD › Travaux, étapes et graphe de dépendances

Travaux, étapes et graphe de dépendances

Construire un pipelineintermediaire

Un workflow contient des travaux. Un travail contient des étapes.

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: "actions/checkout@v4"
      - uses: "actions/setup-node@v4"
        with:
          node-version: "20"
      - run: npm ci
      - run: npm test

Les étapes d'un travail s'exécutent dans l'ordre, sur la même machine. La première qui renvoie un code non nul arrête les suivantes.

Les travaux, eux, s'exécutent en parallèle par défaut. L'ordre d'écriture dans le fichier ne veut rien dire. Pour ordonner, une seule clé :

jobs:
  lint:
    runs-on: ubuntu-latest
    steps: [{ run: npm run lint }]
  test:
    runs-on: ubuntu-latest
    steps: [{ run: npm test }]
  build:
    needs: [lint, test]       # attend les deux
    runs-on: ubuntu-latest
    steps: [{ run: npm run build }]

lint et test partent ensemble, build attend que les deux aient réussi. La durée totale n'est pas la somme : c'est la longueur du chemin le plus long du graphe.

Deux travaux ne partagent rien

Chaque travail obtient une machine neuve et un disque vide. Un fichier produit par build n'existe pas pour deploy, même avec needs. Il faut le faire voyager explicitement, par artefact.

Les termes à connaître

Travail

Un job : l'unité d'ordonnancement. Il obtient sa propre machine, son propre disque, son propre système de fichiers. Deux travaux ne partagent rien par défaut.

Étape

Un step : une commande run ou une action uses. Les étapes d'un travail s'exécutent séquentiellement sur la même machine, et la première qui échoue arrête les suivantes.

needs

Déclare qu'un travail attend la fin réussie d'un ou plusieurs autres. C'est cette clé, et elle seule, qui construit le graphe d'exécution de GitHub Actions.

Graphe acyclique dirigé

La forme que prend un pipeline : des travaux reliés par des dépendances, sans boucle. Un cycle rend le pipeline non ordonnançable, et la plateforme refuse le fichier.

Sortie de travail

Valeur publiée par un travail via outputs, lisible par ses successeurs. C'est le seul canal de données entre travaux qui ne passe pas par un artefact.

Artefact

Fichier produit par un travail, téléversé puis retéléchargé par un autre. Indispensable puisque les travaux ne partagent pas de disque.

if et always()

if conditionne une étape ou un travail. Par défaut un travail dont une dépendance a échoué est sauté ; if: always() force son exécution, ce qui sert aux rapports de tests.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.