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.
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.