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