Accueil › Docker & conteneurs › Copier des fichiers : COPY, ADD et le contexte
Copier des fichiers : COPY, ADD et le contexte
Écrire un Dockerfiledebutant
Avant d'exécuter la première instruction, le constructeur reçoit un contexte : l'arborescence que vous lui désignez, généralement le répertoire courant. Seul ce qui s'y trouve peut être copié.
COPY, la règle
COPY package*.json ./ # plusieurs fichiers, destination relative au WORKDIR
COPY src/ ./src/ # un répertoire et son contenu
COPY --chown=node:node . . # copie et change le propriétaire en une fois
COPY --from=build /app/dist ./dist # depuis une étape précédente
COPY ne fait que copier. C'est exactement ce qu'on attend d'une recette qui
doit se relire sans surprise.
ADD, l'exception
ADD outils.tar.gz /opt/ # extrait l'archive — c'est son seul vrai intérêt
ADD https://exemple.fr/x.jar /opt/ # télécharge, sans extraire
Deux comportements implicites. Une archive que vous vouliez laisser compressée sera décompressée. Une adresse distante introduit un téléchargement au milieu de la recette.
La règle : COPY partout, ADD uniquement pour extraire une archive
locale.
.dockerignore, avant tout le reste
.git
node_modules
*.log
.env*
!.env.exemple
Ce fichier retire des chemins du contexte avant qu'il parte vers le
constructeur. Ce qui n'est pas envoyé ne peut ni alourdir le transfert, ni
casser le cache, ni finir dans l'image par un COPY . . distrait.
Les termes à connaître
- Contexte de construction
L'ensemble des fichiers envoyés au constructeur au lancement de la construction, généralement le répertoire courant. Seul ce qui est dans le contexte peut être copié.
- COPY
Copie des fichiers du contexte, ou d'une étape précédente, vers le système de fichiers de l'image. C'est l'instruction de copie par défaut.
- ADD
Copie aussi, mais avec deux comportements implicites en plus : extraction d'archives locales et téléchargement d'adresses distantes.
- .dockerignore
Le fichier placé à la racine du contexte qui liste ce qui ne doit pas être envoyé au constructeur. Il agit avant la construction.
- Ré-inclusion
Une ligne de
.dockerignorecommençant par!qui réintègre un chemin exclu par une règle précédente.- Dernière correspondance
La règle qui décide du sort d'un fichier dans
.dockerignoreest la dernière qui lui correspond, pas la première.
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.