Accueil › Git & CI/CD › Modèles de dépôt et chaînes réutilisables
Modèles de dépôt et chaînes réutilisables
Industrialiser la chaîneavance
Vingt dépôts, vingt fichiers de chaîne copiés-collés, et une faute dans l'étape de publication. La corriger coûte vingt demandes de fusion — et il en restera trois non corrigées que personne ne retrouvera.
GitHub Actions offre trois formes de partage, qui ne font pas la même chose.
# 1. Action composite — des étapes, dans le travail de l'appelant
- uses: org/actions-node/setup@v2
with:
node-version: "20"
# 2. Workflow réutilisable — des travaux entiers
jobs:
ci:
uses: org/chaines/.github/workflows/node.yml@v2
secrets: inherit
Le troisième, le workflow de départ, est un modèle proposé à la création d'une chaîne. Il est copié : bon point de départ, il ne propage plus rien.
| Forme | Unité partagée | Propage une correction |
|---|---|---|
| Action composite | des étapes | oui, par le uses |
| Workflow réutilisable | des travaux | oui, par le uses |
| Workflow de départ | un fichier complet | non, il est copié |
La règle de choix : si ce que vous partagez doit choisir son agent ou sa matrice, c'est un workflow réutilisable ; sinon une action composite suffit.
Les termes à connaître
- Action composite
Un paquet d'étapes regroupées sous un seul
uses. Elle s'insère dans un travail existant et hérite de son agent, de son système de fichiers et de son jeton.- Workflow réutilisable
Un fichier de chaîne déclaré
on: workflow_callet appelé par un autre. Il apporte ses propres travaux, donc ses agents, sa matrice et ses conditions.- Workflow de départ
Un modèle proposé à la création d'une chaîne, copié une fois dans le dépôt. Après la copie, il n'existe plus de lien avec l'original.
- Contrat d'appel
L'ensemble des entrées, secrets et sorties qu'une chaîne partagée expose. Le modifier sans compatibilité casse tous les dépôts appelants à la fois.
- Épinglage de version
La référence utilisée dans le
uses— étiquette mobile, étiquette figée ou empreinte de commit. Elle décide qui subit une mise à jour et quand.- Couplage par factorisation
L'effet de bord d'une chaîne partagée trop généreuse : chaque cas particulier ajoute un paramètre, et plus personne ne peut la modifier sans risque.
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.