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