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
runou une actionuses. 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()
ifconditionne 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.
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.