Accueil › Git & CI/CD › La matrice et les exécuteurs
La matrice et les exécuteurs
Construire un pipelineintermediaire
Une matrice décrit des axes de variation. La plateforme en déduit le produit cartésien et crée un travail par combinaison.
jobs:
test:
runs-on: ${{ matrix.os }}
strategy:
fail-fast: false
matrix:
node: ["18", "20", "22"]
os: [ubuntu-latest, windows-latest]
steps:
- uses: "actions/checkout@v4"
- uses: "actions/setup-node@v4"
with:
node-version: ${{ matrix.node }}
- run: npm ci
- run: npm test
Six combinaisons, six travaux indépendants, exécutés en parallèle dans la limite des exécuteurs disponibles. Chacun a sa machine et son disque.
Ajuster le produit
exclude:
- node: "18"
os: windows-latest # retire une combinaison
include:
- node: "22"
os: ubuntu-latest
couverture: true # enrichit une combinaison existante
exclude retire du produit. include fusionne ses clés dans les
combinaisons qui lui correspondent ; s'il n'en trouve aucune, il ajoute une
combinaison à lui seul.
L'exécuteur
runs-on choisit la machine. ubuntu-latest, windows-latest,
macos-latest sont des images fournies et détruites après usage. Une liste
d'étiquettes désigne un exécuteur auto-hébergé :
runs-on: [self-hosted, linux, arm64]
Les termes à connaître
- Matrice
Déclaration d'axes de variation sous
strategy.matrix. La plateforme en déduit le produit cartésien et crée un travail par combinaison, tous indépendants.- include
Ajoute des clés à une combinaison existante quand elle correspond, ou ajoute une combinaison entière quand elle ne correspond à aucune. L'ordre d'application compte.
- exclude
Retire du produit cartésien les combinaisons qui correspondent. Il s'applique au produit, pas aux combinaisons venues de
include.- fail-fast
Vrai par défaut : le premier échec annule toutes les autres combinaisons. Le mettre à faux coûte du temps de calcul mais donne la carte complète des échecs.
- Exécuteur
La machine qui exécute un travail.
runs-onla choisit : image hébergée par la plateforme, ou exécuteur auto-hébergé désigné par ses étiquettes.- Exécuteur auto-hébergé
Machine fournie par l'équipe, désignée par un jeu d'étiquettes. Utile pour un matériel particulier ou un réseau privé, au prix de la sécurité et de l'entretien.
- Conteneur de travail
La clé
containerexécute toutes les étapes dans une image donnée. L'environnement devient reproductible et indépendant de l'image de l'exécuteur.
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.