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
pathsetpaths-ignorelimitent le déclenchement aux exécutions qui touchent certains fichiers. Indispensable sur un dépôt qui héberge plusieurs applications.- Concurrence
La clé
concurrencyregroupe 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.
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.