Formations — 1 037 leçons en français

Accueil › Docker & conteneurs › Ce qu'on copie d'une étape à l'autre

Ce qu'on copie d'une étape à l'autre

Construction multi-étapesintermediaire

Le lien entre deux étapes tient dans une seule instruction : une copie dont la source est une autre étape.

FROM eclipse-temurin:21-jdk AS build
WORKDIR /src
COPY . .
RUN ./mvnw -B package -DskipTests

FROM eclipse-temurin:21-jre
WORKDIR /app
COPY --from=build /src/target/application.jar ./application.jar
CMD ["java", "-jar", "application.jar"]

Deux côtés, deux résolutions

La source est lue depuis la racine du système de fichiers de l'étape désignée. Le WORKDIR de cette étape n'intervient pas : COPY --from=build dist ./public ne cherche pas /src/dist, mais dist à la racine. On écrit donc la source en chemin absolu, toujours.

La destination suit les règles habituelles : relative, elle est résolue depuis le WORKDIR de l'étape courante.

Copier le moins possible

L'intérêt de la construction multi-étapes se joue ici. Copier /src/target entier emporte les classes intermédiaires, les rapports de test et parfois le dépôt de dépendances. Copier le seul fichier produit n'emporte que lui. La règle tient en une phrase : on nomme ce qu'on veut, on ne balaie pas un répertoire parce que c'est plus court à écrire.

Propriété des fichiers

Les fichiers copiés appartiennent à la racine par défaut. Une image qui tourne en utilisateur non privilégié doit le corriger à la copie :

COPY --from=build --chown=node:node /app/dist ./dist

Les termes à connaître

`COPY --from`

La copie dont la source n'est pas le contexte de construction mais le système de fichiers d'une autre étape, ou d'une image externe.

Source de la copie

Un chemin lu dans le système de fichiers de l'étape désignée. Il est résolu depuis la racine de cette étape, pas depuis son répertoire de travail.

Destination de la copie

Un chemin dans l'étape courante. S'il est relatif, il est résolu depuis le WORKDIR de l'étape courante.

Propriété des fichiers copiés

Par défaut, les fichiers copiés appartiennent à l'utilisateur racine. L'option --chown fixe un autre propriétaire au moment de la copie.

Surface copiée

L'ensemble des chemins réellement emportés dans l'image finale. Plus elle est restreinte, moins il y a de chances d'emporter un secret ou un outil.

Copie depuis une image

COPY --from accepte aussi un nom d'image. Le constructeur la tire et y lit les chemins demandés, sans jamais l'exécuter.

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.