Formations — 1 037 leçons en français

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. Chaque FROM ouvre une étape indépendante, et seule la dernière produit l'image publiée.

Étape

Un bloc de recette allant d'un FROM au FROM suivant. 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.

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.