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 }}-
key— la clé exacte. Une entrée portant exactement cette clé est restaurée, et le cache n'est pas réécrit en fin de travail.restore-keys— des préfixes de repli, essayés dans l'ordre. Ils restaurent un cache voisin, pas identique.path— ce qui est enregistré.
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.xmlavec 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.
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.