Formations — 1 037 leçons en français

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 uses dans 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 v4 que 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.yml qui 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_call et appelé par uses au 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: read et n'ouvrir que ce qui est nécessaire limite les dégâts d'une action compromise.

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.