Formations — 1 037 leçons en français

Accueil › Git & CI/CD › Ce qui déclenche un pipeline

Ce qui déclenche un pipeline

Construire un pipelineintermediaire

Un pipeline ne se lance pas tout seul : il répond à un événement. Dans GitHub Actions, l'événement se déclare sous la clé on, en tête du fichier.

# .github/workflows/ci.yml
name: CI
on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
  workflow_dispatch:

Ces trois déclencheurs couvrent la quasi-totalité des besoins : vérifier ce qui entre sur la branche principale, vérifier ce qu'on propose d'y faire entrer, et pouvoir relancer à la main.

Filtrer pour ne pas tout rejouer

on:
  pull_request:
    paths:
      - "backend/**"
      - "pom.xml"

Sur un dépôt qui contient plusieurs applications, un filtre de chemins évite de compiler le backend Java parce que quelqu'un a corrigé une faute de frappe dans le README.

Une exécution par poussée, et c'est le problème

Trois poussées en deux minutes lancent trois pipelines complets. Les deux premiers travaillent sur du code déjà périmé.

concurrency:
  group: ci-${{ github.ref }}
  cancel-in-progress: true

Le groupe est une chaîne : les exécutions qui partagent la même chaîne forment une file, et cancel-in-progress annule celle qui tourne quand une nouvelle arrive. C'est trois lignes et c'est souvent la plus grosse économie de temps de calcul d'un dépôt actif.

Les termes à connaître

Déclencheur

L'événement qui fait démarrer une exécution. Dans GitHub Actions il est déclaré sous la clé on, et un même fichier de workflow peut en avoir plusieurs.

Workflow

Un fichier YAML dans .github/workflows/. Une exécution de ce fichier s'appelle un run. Plusieurs workflows peuvent répondre au même événement, et ils s'exécutent indépendamment.

push

Événement émis quand des commits arrivent sur une référence du dépôt. Filtrable par branche, par étiquette et par chemin de fichier.

pull_request

Événement émis à l'ouverture d'une demande de fusion et à chaque nouvelle poussée dessus. Par défaut il s'exécute sur la fusion simulée entre la branche et sa cible.

workflow_dispatch

Déclenchement manuel depuis l'interface ou l'API, avec des paramètres d'entrée typés. C'est ce qui transforme un workflow en bouton de déploiement.

Filtre de chemins

paths et paths-ignore limitent le déclenchement aux exécutions qui touchent certains fichiers. Indispensable sur un dépôt qui héberge plusieurs applications.

Concurrence

La clé concurrency regroupe les exécutions par nom et annule les précédentes du même groupe. Sans elle, trois poussées rapides lancent trois pipelines complets.

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.