Formations — 1 037 leçons en français

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 un FROM ulté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 FROM et des COPY --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.

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.