Formations — 1 037 leçons en français

Accueil › Docker & conteneurs › Le cache de construction

Le cache de construction

Images et couchesdebutant

Le constructeur réutilise les couches déjà produites tant que rien n'a changé en amont. C'est ce qui fait passer une construction de trois minutes à trois secondes — et c'est ce qu'on détruit sans s'en apercevoir.

Les deux questions du constructeur

Pour chaque étape, dans l'ordre :

  1. L'étape précédente a-t-elle été réutilisée ?
  2. Cette instruction est-elle identique, et les fichiers qu'elle copie ont-ils la même empreinte ?

Si les deux réponses sont oui, la couche sort du cache. Sinon, elle est recalculée — et toutes les suivantes aussi.

La cascade

FROM node:22-alpine      # 1  ✓ cache
WORKDIR /app             # 2  ✓ cache
COPY package*.json ./    # 3  ✓ cache
RUN npm ci --omit=dev    # 4  ✓ cache
COPY . .                 # 5  ✗ le code a changé
RUN npm run build        # 6  ✗ cascade

L'étape 6 est reconstruite non parce qu'elle dépend du code, mais parce que l'étape 5 l'a été. Cette propagation vers le bas est la règle la plus utile du chapitre : on place en haut ce qui change rarement.

Ce qui invalide une copie

Le contenu des fichiers, par leur empreinte. Pas leur date de modification. Toucher un fichier sans le modifier ne casse rien ; en modifier un caractère casse tout ce qui suit.

Les termes à connaître

Cache de construction

L'ensemble des couches déjà produites que le constructeur réutilise au lieu de les recalculer, tant que rien n'a changé en amont.

Invalidation

Le moment où une étape ne peut plus être réutilisée. Elle survient si l'instruction a changé, ou si ce qu'elle copie a changé.

Cascade

La propriété centrale du cache : dès qu'une étape est invalidée, toutes les suivantes le sont, même si elles n'ont rien à voir avec la modification.

BuildKit

Le constructeur utilisé par défaut. Il analyse le graphe des étapes, ne transfère que les fichiers nécessaires, exécute les étapes indépendantes en parallèle et gère des caches externes.

Contexte de construction

L'ensemble des fichiers que le constructeur peut lire pendant la construction. Il est envoyé au moteur avant la première instruction.

Empreinte de contexte

Pour une instruction de copie, le constructeur calcule l'empreinte des fichiers copiés. C'est elle, et non leur date de modification, qui décide de la réutilisation.

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.