Accueil › Docker & conteneurs › Séparer la construction de l'exécution
Séparer la construction de l'exécution
Construction multi-étapesintermediaire
Construire une application et l'exécuter n'ont pas les mêmes besoins. La construction réclame un compilateur, un gestionnaire de paquets, des en-têtes système, parfois une chaîne complète d'outils. L'exécution ne demande que l'application et son environnement d'exécution. Une construction multi-étapes sépare les deux dans un seul Dockerfile.
Plusieurs FROM, une seule image
# Étape 1 : on compile, avec tous les outils
FROM node:22 AS build
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build
# Étape 2 : on exécute, avec le strict nécessaire
FROM node:22-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY --from=build /app/dist ./dist
USER node
CMD ["node", "dist/serveur.js"]
Chaque FROM ouvre une étape neuve, avec son propre système de fichiers.
L'étape build n'est pas publiée : ses couches servent de source, puis
disparaissent. Seules les couches de la dernière étape composent l'image
livrée.
Ce que cela change
Le compilateur, les dépendances de développement et les fichiers
intermédiaires ne sont plus dans l'image. Ce n'est pas un nettoyage : ils n'y
entrent jamais. La différence avec un rm -rf final est décisive — une couche
déjà écrite est immuable, une suppression ne fait que masquer, et les octets
voyagent quand même à chaque tirage.
Les termes à connaître
- Construction multi-étapes
Un Dockerfile qui contient plusieurs instructions
FROM. ChaqueFROMouvre une étape indépendante, et seule la dernière produit l'image publiée.- Étape
Un bloc de recette allant d'un
FROMauFROMsuivant. Elle a sa propre image de base, son propre système de fichiers et ses propres couches.- Étape finale
La dernière étape du fichier, sauf si une cible est demandée explicitement. C'est elle, et elle seule, dont les couches composent l'image produite.
- Dépendance de construction
Un outil nécessaire pour fabriquer l'application — compilateur, gestionnaire de paquets, en-têtes système — et inutile pour l'exécuter.
- Artefact
Le résultat de la construction qu'on emporte dans l'image finale : un répertoire compilé, une archive exécutable, un binaire.
- Image d'exécution
L'image de base de l'étape finale. Elle ne contient que ce qu'il faut pour lancer l'application, souvent sans compilateur ni gestionnaire de paquets.
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.