Formations — 1 037 leçons en français

Accueil › Docker & conteneurs › Construire et paramétrer : RUN, ARG et ENV

Construire et paramétrer : RUN, ARG et ENV

Écrire un Dockerfiledebutant

RUN exécute une commande pendant la construction. Le résultat est figé dans une couche.

Une instruction, une couche

# ⛔ trois couches : l'index des paquets reste dans la deuxième
RUN apt-get update
RUN apt-get install -y curl
RUN rm -rf /var/lib/apt/lists/*

# ✅ une couche, qui ne contient que ce qui sert
RUN apt-get update \
 && apt-get install -y --no-install-recommends curl \
 && rm -rf /var/lib/apt/lists/*

Une couche est immuable. Supprimer dans une instruction ultérieure masque le fichier sans le retirer de l'image. Installer, utiliser et nettoyer tiennent dans une seule instruction.

ARG : pendant la construction

ARG VERSION_NODE=22
FROM node:${VERSION_NODE}-alpine

Passée au lancement de la construction, la valeur paramètre la fabrication. Elle n'apparaît pas dans l'environnement du conteneur.

ENV : dans le conteneur

ENV NODE_ENV=production

Écrite dans les métadonnées, elle vaut pour la suite de la construction, pour le conteneur, et pour toute image bâtie sur celle-ci.

Ni l'une ni l'autre pour un secret

Un argument de construction reste lisible dans l'historique de l'image. Toute personne qui possède l'image peut le lire. Un secret se passe par un montage de secret, qui n'écrit rien dans aucune couche.

Les termes à connaître

RUN

Exécute une commande pendant la construction et fige le résultat dans une couche. Chaque instruction produit sa propre couche.

Enchaînement

Réunir installation, usage et nettoyage dans une seule instruction, afin que la couche ne contienne que le résultat utile.

ARG

Une variable qui n'existe que pendant la construction. Elle disparaît de l'image finale, mais sa valeur reste lisible dans l'historique.

ENV

Une variable enregistrée dans les métadonnées de l'image. Elle vaut pendant la construction et dans le conteneur, et s'hérite.

Historique d'image

La liste des instructions ayant produit chaque couche, conservée dans l'image et consultable par quiconque la possède.

Montage de secret

Un fichier rendu disponible à une seule instruction de construction, sans jamais être écrit dans une couche ni dans l'historique.

Cache de paquets

Les fichiers que les gestionnaires de paquets conservent après une installation. Inutiles dans l'image, ils doivent disparaître dans la même instruction.

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.