Formations — 1 037 leçons en français

Accueil › Docker & conteneurs › Anatomie d'un Dockerfile

Anatomie d'un Dockerfile

Écrire un Dockerfiledebutant

Un Dockerfile est une recette lue de haut en bas. Chaque instruction part de l'état laissé par la précédente.

Le squelette d'une image Node

FROM node:22-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY . .
ENV NODE_ENV=production
EXPOSE 3000
USER node
CMD ["node", "serveur.js"]

Neuf lignes, et déjà la structure complète : une base, un répertoire de travail, les dépendances, le code, la configuration, le port déclaré, l'identité, la commande de démarrage.

Deux familles d'instructions

Famille Instructions Effet
Écrivent des fichiers COPY, ADD, RUN une couche, qui pèse
Écrivent des métadonnées FROM, WORKDIR, ENV, ARG, USER, EXPOSE, CMD, ENTRYPOINT, HEALTHCHECK rien dans le système de fichiers

La distinction compte : seules les premières font grossir l'image.

Ce qu'EXPOSE ne fait pas

EXPOSE 3000 n'ouvre aucun port. C'est une déclaration lisible par les outils et par les humains. Le port devient joignable depuis l'hôte uniquement si on le publie au lancement.

Ce que USER fait

Sans USER, le conteneur s'exécute en utilisateur privilégié. L'instruction change l'identité pour toutes les instructions suivantes et pour le conteneur final. Elle se place après les installations, qui, elles, ont souvent besoin des droits.

Les termes à connaître

Dockerfile

Le fichier texte qui décrit, instruction par instruction, comment fabriquer une image. Il est lu de haut en bas, et chaque instruction part de l'état laissé par la précédente.

Instruction

Une ligne de recette, par convention en majuscules. Certaines produisent une couche de fichiers, d'autres n'écrivent que des métadonnées dans l'image.

Métadonnée d'image

Une information enregistrée dans le manifeste et non dans le système de fichiers : le répertoire de travail, l'utilisateur, les variables, la commande de démarrage.

WORKDIR

Fixe le répertoire courant pour toutes les instructions suivantes et pour le conteneur. Il crée le répertoire s'il n'existe pas.

EXPOSE

Déclare le port sur lequel l'application écoute. C'est une documentation lisible par les outils, pas une ouverture de port.

USER

Change l'identité sous laquelle s'exécutent les instructions suivantes et le conteneur. Sans elle, tout tourne en utilisateur privilégié.

HEALTHCHECK

Une commande que le moteur exécute périodiquement dans le conteneur pour décider s'il est en bonne santé. Elle ne redémarre rien par elle-même.

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.