Accueil › Docker & conteneurs › Étapes nommées et étape cible
Étapes nommées et étape cible
Construction multi-étapesintermediaire
Une étape se nomme au moment où elle s'ouvre :
FROM node:22 AS build
Le nom sert à trois choses : désigner l'étape dans une copie
(COPY --from=build), lui faire servir de base à une autre étape
(FROM build AS test), et la demander comme cible de construction.
Construire une étape précise
docker build --target test -t mon-api:test .
Le constructeur s'arrête à l'étape demandée et publie son résultat. C'est la façon habituelle d'obtenir une image de test, une image de développement et une image de production depuis un seul Dockerfile, donc avec une seule base, un seul ordre d'instructions et un seul cache.
BuildKit ne construit que le nécessaire
BuildKit déduit un graphe de dépendances des FROM et des COPY --from, puis
n'exécute que les étapes dont la cible descend. Une étape de test placée au
milieu du fichier n'est pas exécutée lors d'une construction de production, et
une étape qu'aucune autre n'utilise n'est jamais construite. Les étapes
indépendantes, elles, peuvent avancer en parallèle.
Sans cible explicite, la cible est la dernière étape du fichier.
Les termes à connaître
- Étape nommée
Une étape déclarée
FROM image AS nom. Le nom sert à la désigner dans une copie, dans unFROMultérieur ou comme cible de construction.- Étape cible
L'étape demandée par
--target. Le constructeur s'arrête à elle, et c'est son résultat qui devient l'image produite.- Graphe des étapes
La dépendance entre étapes, déduite par BuildKit des
FROMet desCOPY --from. Elle décide de ce qui est construit, et dans quel ordre.- Étape de dépendances
Une étape dédiée à l'installation des dépendances, dont plusieurs étapes descendent. Elle n'est installée qu'une fois pour toutes les branches.
- Branche parallèle
Deux étapes qui ne dépendent pas l'une de l'autre. BuildKit peut les exécuter en même temps.
- Cache monté
Un répertoire persistant entre constructions, déclaré par
RUN --mount=type=cache. Il est partagé par toutes les étapes qui visent le même chemin, et n'entre dans aucune couche.
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.