Formations — 1 037 leçons en français

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é.

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.