Formations — 1 037 leçons en français

Accueil › Git & CI/CD › La clé de cache et ses replis

La clé de cache et ses replis

Artefacts, cache et duréeavance

Une entrée de cache est retrouvée par une clé. Sur GitHub Actions, trois champs suffisent à comprendre le mécanisme :

- uses: actions/cache@v4
  id: npm-cache
  with:
    path: ~/.npm
    key: npm-${{ runner.os }}-${{ hashFiles('package-lock.json') }}
    restore-keys: |
      npm-${{ runner.os }}-

La règle de la clé

La clé doit changer exactement quand le contenu attendu change.

hashFiles('package-lock.json') calcule une empreinte du fichier qui fige les versions. Une dépendance ajoutée, retirée ou mise à jour change le verrou, donc l'empreinte, donc la clé : le cache précédent n'est plus retrouvé, et c'est voulu.

Deux erreurs symétriques :

Clé Conséquence
npm-${{ github.run_id }} jamais retrouvée : on écrit sans jamais lire
npm-cache jamais invalidée : on sert un contenu périmé indéfiniment

Ce que cache-hit veut dire

- run: npm ci
  if: steps.npm-cache.outputs.cache-hit != 'true'

cache-hit vaut true seulement sur une correspondance exacte. Un repli restaure des fichiers mais laisse la sortie à faux — ce qui est correct : le contenu est approximatif, il faut relancer l'installation, qui sera rapide puisque l'essentiel du téléchargement est déjà là.

Les termes à connaître

Clé exacte

La chaîne qui identifie une entrée de cache. Si une entrée porte exactement cette clé, elle est restaurée et le cache n'est pas réécrit en fin de travail.

Clé de repli

Une liste de préfixes essayés dans l'ordre quand la clé exacte est absente. Le cache restauré est alors incomplet mais proche, et sera réécrit sous la clé exacte.

Empreinte d'un fichier de verrou

La valeur calculée à partir du contenu du fichier qui fige les versions des dépendances. Elle change dès qu'une dépendance change, et seulement dans ce cas.

Fichier de verrou

package-lock.json, yarn.lock, pom.xml avec versions fixées, gradle.lockfile. C'est l'entrée exacte dont le cache est la sortie.

cache-hit

Sortie booléenne de l'action de cache, vraie uniquement si la clé exacte a été trouvée. Un repli utilisé laisse cette sortie à faux.

Éviction

Suppression automatique d'entrées de cache quand le quota de dépôt est atteint ou qu'une entrée n'a pas servi depuis un certain temps. Elle arrive sans prévenir.

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.