Formations — 1 037 leçons en français

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 .dockerignore commenç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 .dockerignore est la dernière qui lui correspond, pas la première.

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.