Accueil › Git & CI/CD › Un cache mal invalidé est pire que pas de cache
Un cache mal invalidé est pire que pas de cache
Artefacts, cache et duréeavance
Un cache absent coûte du temps. Un cache faux coûte une journée d'enquête, et il se propage : toutes les exécutions suivantes héritent du contenu périmé.
L'invalidation n'est pas une opération qu'on déclenche. C'est une propriété de la clé :
Si la clé ne change pas quand l'entrée change, le cache ment.
# ⛔ la clé ne dépend de rien
key: npm-cache
# ⛔ on met en cache ce qu'on produit, avec une clé indifférente aux sources
path: dist
key: build-${{ runner.os }}
# ✅ la clé dépend exactement de ce dont le contenu dépend
key: npm-${{ runner.os }}-${{ hashFiles('package-lock.json') }}
Le symptôme
Un échec en intégration qui disparaît quand on relance sur un agent sans cache, ou qui n'est pas reproductible en local. Le code est correct ; l'état restauré ne l'est pas.
Le seul levier fiable
Changer la clé. Un préfixe de version en tête rend toutes les entrées existantes inatteignables :
key: v3-npm-${{ runner.os }}-${{ hashFiles('package-lock.json') }}
restore-keys: v3-npm-${{ runner.os }}-
Relancer l'exécution ne sert à rien : la clé est la même, le contenu aussi. Le préfixe doit aussi figurer dans les replis, sans quoi on retombe dans les anciennes entrées par la porte de derrière.
Les termes à connaître
- Invalidation
Le fait qu'une clé cesse de correspondre quand l'entrée change. Ce n'est pas une opération qu'on déclenche : c'est une propriété de la clé, ou son absence.
- Clé trop large
Une clé qui ne dépend pas de tout ce dont le contenu dépend. Elle continue de correspondre après un changement réel et sert un contenu périmé.
- Cache empoisonné
Une entrée de cache dont le contenu est incorrect mais dont la clé correspond toujours. Toutes les exécutions suivantes héritent de la faute.
- Échec non reproductible
Un échec qui disparaît sur un agent neuf et revient sur un agent qui a restauré le cache. Symptôme caractéristique d'un cache mal invalidé.
- Reconstruction forcée
Changer volontairement la clé — en général par un préfixe de version — pour écarter toutes les entrées existantes. Le seul levier fiable quand un cache est suspect.
- Chemin produit
Un chemin écrit par la chaîne elle-même. Le mettre en cache revient à cacher sa propre sortie, et c'est la première cause de contenu périmé.
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.