Formations — 1 037 leçons en français

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-on la 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é container exécute toutes les étapes dans une image donnée. L'environnement devient reproductible et indépendant de l'image de l'exécuteur.

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.