Accueil › Git & CI/CD › Actions réutilisables et épinglage
Actions réutilisables et épinglage
Construire un pipelineintermediaire
Une action est une unité réutilisable appelée par uses.
steps:
- uses: "actions/checkout@v4"
- uses: "actions/setup-java@v4"
with:
java-version: "21"
distribution: temurin
cache: maven
La valeur suit la forme proprietaire/depot@reference. Et c'est cette
référence qui pose un problème de sécurité réel.
v4 n'est pas une version, c'est un pointeur
Une étiquette Git peut être redéplacée. La convention du catalogue est
justement de faire suivre v4 à chaque publication 4.x.y. Conséquence :
votre fichier ne change pas, et le code exécuté change.
# Mobile : reçoit les correctifs, et tout le reste
- uses: "actions/checkout@v4"
# Épinglé : le contenu exécuté ne peut plus changer
- uses: "actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8" # v5.0.0
Une empreinte de commit est calculée à partir du contenu : il n'existe aucun moyen de la redéployer sur autre chose. Le commentaire de fin de ligne n'est pas décoratif — sans lui, personne ne sait plus quelle version est épinglée.
Ce que coûte une action tierce
Elle s'exécute dans votre travail, sur votre machine, avec le jeton du workflow. Deux réflexes limitent la casse :
permissions:
contents: read # tout le reste est refusé
Et l'épinglage par empreinte, qui empêche une mise à jour silencieuse de changer ce qui s'exécute.
Les termes à connaître
- Action
Unité réutilisable appelée par
usesdans une étape. Elle vient d'un dépôt public, d'un dossier du dépôt courant, ou d'une image de conteneur.- uses
La clé qui appelle une action. Sa valeur suit la forme
proprietaire/depot@reference, où la référence est une étiquette, une branche ou une empreinte de commit.- Épinglage
Fixer la référence appelée à une empreinte de commit complète plutôt qu'à une étiquette. C'est la seule forme d'appel qui ne peut pas changer de contenu sans que le fichier change.
- Étiquette mobile
Une étiquette comme
v4que le mainteneur redéplace à chaque version mineure. Pratique pour recevoir les correctifs, mais le contenu exécuté change sans que votre dépôt bouge.- Action composite
Action définie par un fichier
action.ymlqui enchaîne des étapes. C'est la façon de mutualiser une séquence d'étapes à l'intérieur d'un travail.- Workflow réutilisable
Workflow déclaré
on: workflow_callet appelé parusesau niveau d'un travail. Il apporte ses propres travaux, à la différence d'une action composite.- permissions
Clé qui restreint les droits du jeton fourni au workflow. Partir de
contents: readet n'ouvrir que ce qui est nécessaire limite les dégâts d'une action compromise.
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.