ADD

Syntaxe

Paramètres

Description

Cette instruction permet d'effectuer l'extraction automatique du fichier tar local dans l'image.

Remarques

• Bien que les instructions ADD et COPY soient fonctionnellement similaires, de manière générale, COPY est préféré. C'est parce qu'il est plus transparent que l'instruction ADD. L'instruction COPY ne prend en charge que la copie de base des fichiers locaux dans le conteneur, tandis que ADD possède certaines fonctionnalités (comme l'extraction de tar local uniquement et la prise en charge d'URL à distance) n'étant pas immédiatement évidentes.
• Si vous avez plusieurs étapes Dockerfile utilisant des fichiers différents de votre contexte, copiez-les individuellement, plutôt que toutes en même temps. Cette situation garantira que le cache de génération de chaque étape est invalidé (ceci obligeant à réexécuter l'étape) que si les fichiers spécifiquement requis changent.
• La taille de l'image étant importante, l'utilisation de l'instruction ADD pour récupérer des paquets à partir d'URL à distances est fortement déconseillée; vous devez utiliser à la place curl ou wget. De cette façon, vous pouvez supprimer les fichiers dont vous n'avez plus besoin après leur extraction et vous n'aurez pas à ajouter un autre couche dans votre image.
• Pour les autres éléments (fichiers, répertoires) ne nécessitant pas la fonction d'extraction automatique de tar de l'instruction ADD, vous devez toujours utiliser l'instruction COPY.

Exemple

L'exemple suivant permet de copier le fichier de configuration Apache 2 de la machine vers l'image Docker :