Formations — 1 037 leçons en français

Accueil › Docker & conteneurs › Le cache de construction distant

Le cache de construction distant

Conteneurs dans la chaîneavance

Le cache de construction local n'existe pas sur un exécuteur éphémère. Si on veut un cache, il faut l'écrire quelque part qui survive, et le relire au début de la construction suivante.

BuildKit sépare les deux directions :

docker buildx build \
  --cache-from type=registry,ref=registre.interne/ci/api:cache \
  --cache-to   type=registry,ref=registre.interne/ci/api:cache,mode=max \
  --tag registre.interne/ci/api:sha-${COMMIT_COURT} \
  --push .

--cache-from déclare où chercher. --cache-to déclare où écrire. Les deux sont nécessaires : importer sans exporter ne gagne rien après la première exécution, exporter sans importer paie un coût sans contrepartie.

Deux emplacements

Le registre est le plus simple : le cache vit dans un dépôt, accessible à tous les exécuteurs, sans configuration supplémentaire. Le stockage de la plateforme d'intégration est l'autre voie, souvent plus rapide quand il est proche des exécuteurs, mais limité en taille et en durée.

Minimal ou complet

En mode minimal, seules les entrées des couches de l'image finale sont exportées. Dans une construction multi-étapes, c'est précisément ce qui coûte le moins. Le mode complet conserve aussi les étapes intermédiaires — compilation, installation des dépendances — au prix d'un cache plus volumineux.

Ce qui invalide

La clé d'une entrée dépend de l'instruction et de ce qui entre dedans. Pour une copie, c'est l'empreinte du contenu copié. Une entrée invalidée rend inutilisables toutes celles qui la suivent.

Les termes à connaître

Cache exporté

Les entrées de cache d'une construction, écrites ailleurs que sur le disque de l'exécuteur pour être relues par une construction ultérieure.

Cache importé

Un cache distant déclaré en entrée de construction. Le constructeur y cherche les entrées correspondant à ses étapes avant de les exécuter.

Mode minimal

Un export qui ne conserve que les entrées de l'image finale. Léger, mais aveugle aux étapes intermédiaires d'une construction multi-étapes.

Mode complet

Un export qui conserve toutes les entrées, y compris celles des étapes intermédiaires. Plus lourd, nécessaire quand les étapes de dépendances comptent.

Clé de cache

Ce qui identifie une entrée : l'instruction, l'entrée de l'étape précédente, et pour une copie l'empreinte du contenu copié.

Invalidation en cascade

Le fait qu'une entrée invalidée rende inutilisables toutes les entrées qui en dépendent, jusqu'à la fin de l'étape.

Cache embarqué au registre

Un export qui place les entrées de cache dans le même dépôt que l'image, sous une étiquette dédiée ou dans le manifeste.

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.