Яка різниця між командами COPYта ADDкомандами в Dockerfile, і коли я буду використовувати одну над іншою?

COPY <src> <dest>

Інструкція COPY скопіює нові файли з <src>та додасть їх у файлову систему контейнера на шляху<dest>

ADD <src> <dest>

Інструкція ADD буде копіювати нові файли з них <src>та додавати їх до файлової системи контейнера на шляху <dest>.

Ви повинні перевірити ADDта COPYдокументацію для більш детального опису їх поведінки, але в двох словах, головна різниця полягає в тому, що ADDможна зробити більше, ніж COPY:

• ADDдозволяє <src>бути URL-адресою
• Посилаючись на коментарі нижче, у ADD документації зазначено, що:

  Якщо локальний архів tar у розпізнаному форматі стиснення (ідентифікація, gzip, bzip2 або xz), він розпаковується як каталог. Ресурси з віддалених URL-адрес не декомпресуються.

Зауважте, що кращі практики написання Dockerfiles пропонують використовувати COPYтам, де магія ADDне потрібна. В іншому випадку ви ( оскільки вам довелося шукати цю відповідь ), ймовірно, ви здивуєтесь колись, коли маєте намір скопіювати keep_this_archive_intact.tar.gzу свій контейнер, але натомість ви розпорошите вміст на вашу файлову систему.

COPY є

Те саме, що "ADD", але без дьогтю та віддаленої обробки URL-адрес.

Посилання прямо з вихідного коду .

На цю тему існує офіційна документація: Кращі практики написання докерфілів

Оскільки розмір зображення має значення, використання ADDдля отримання пакетів з віддалених URL-адрес сильно не рекомендується; ви повинні використовувати curlабо wgetзамість цього. Таким чином ви можете видалити файли, які вам більше не потрібні після їх вилучення, і вам не доведеться додавати ще один шар у зображення.

RUN mkdir -p /usr/src/things \
  && curl -SL http://example.com/big.tar.gz \
    | tar -xJC /usr/src/things \
  && make -C /usr/src/things all

Для інших елементів (файлів, каталогів), які не потребують ADDможливості автоматичного вилучення дьогтю, завжди слід використовувати COPY.

З Докерів Docs:

ДОДАТИ або КОПІЮЙТЕ

Хоча ADD і COPY функціонально схожі, загалом кажучи, COPY є кращим. Це тому, що вона прозоріша, ніж додавання. COPY підтримує лише основне копіювання локальних файлів у контейнер, тоді як ADD має деякі функції (наприклад, лише видобуток смоли та підтримка віддаленої URL-адреси), які не відразу очевидні. Отже, найкращим використанням для ADD є локальне автоматичне вилучення файлу tar на зображення, як у ADD rootfs.tar.xz /.

Докладніше: Кращі практики написання Dockerfiles

Якщо ви хочете додати xx.tar.gz до /usr/localконтейнера, розпакуйте його та видаліть непотрібний стислий пакет.

Для КОПІЇ:

COPY resources/jdk-7u79-linux-x64.tar.gz /tmp/
RUN tar -zxvf /tmp/jdk-7u79-linux-x64.tar.gz -C /usr/local
RUN rm /tmp/jdk-7u79-linux-x64.tar.gz

ДОДАТИ:

ADD resources/jdk-7u79-linux-x64.tar.gz /usr/local/

ADD підтримує видобуток лише смоли. Крім цього, COPY використовуватиме три шари, але ADD використовує лише один шар.

COPY копіює файл / каталог з вашого хоста на ваше зображення.

ADD копіює файл / каталог з вашого хоста на ваше зображення, але також може отримати віддалені URL-адреси, витягувати файли TAR тощо.

Використовуйте COPYдля простого копіювання файлів та / або каталогів у контекст збірки.

Використовується ADDдля завантаження віддалених ресурсів, вилучення файлів TAR тощо.

З Докерів Документів: https://docs.docker.com/engine/userguide/eng-image/dockerfile_best-practices/#add-or-copy

"Хоча ADD і COPY функціонально схожі, загалом кажучи, COPY є кращим. Це тому, що це прозоріше, ніж ADD. COPY підтримує лише основне копіювання локальних файлів у контейнер, тоді як ADD має деякі особливості (наприклад, видобуток лише місцевих смол та підтримка віддаленої URL-адреси), які не відразу очевидні, отже, найкращим використанням для ADD є локальне автоматичне вилучення файлу tar на зображення, як у ADD rootfs.tar.xz /.

Якщо у вас є кілька кроків Dockerfile, які використовують різні файли з вашого контексту, КОПУЙТЕ їх окремо, а не всі відразу. Це забезпечить, що кеш збірки кожного кроку буде недійсним (змушує повторно виконувати крок), якщо зміниться спеціально необхідні файли.

Наприклад:

 COPY requirements.txt /tmp/
 RUN pip install --requirement /tmp/requirements.txt
 COPY . /tmp/

Результати мають меншу кількість недійсних кеш-пам’яті для кроку RUN, ніж якщо ви ставите КОПІЮВАННЯ. / tmp / перед цим.

Оскільки розмір зображення має значення, використання ADD для отримання пакетів з віддалених URL-адрес сильно не рекомендується; ви повинні використовувати замість curl або wget. Таким чином ви можете видалити файли, які вам більше не потрібні після їх вилучення, і вам не доведеться додавати ще один шар у зображення. Наприклад, вам слід уникати таких дій, як:

 ADD http://example.com/big.tar.xz /usr/src/things/
 RUN tar -xJf /usr/src/things/big.tar.xz -C /usr/src/things
 RUN make -C /usr/src/things all

А натомість зробіть щось на кшталт:

 RUN mkdir -p /usr/src/things \
     && curl -SL htt,p://example.com/big.tar.xz \
     | tar -xJC /usr/src/things \
     && make -C /usr/src/things all

Для інших елементів (файлів, каталогів), які не потребують можливості автоматичного вилучення ADD tar, завжди слід використовувати COPY. "

Джерело: https://nickjanetakis.com/blog/docker-tip-2-the-difference-between-copy-and-add-in-a-dockerile :

COPY і ADD - це інструкції Dockerfile, які служать подібним цілям. Вони дозволяють вам копіювати файли з певного місця в зображення Docker.

COPY приймає в src та пункт призначення. Це дозволяє лише скопіювати локальний файл або каталог зі свого хоста (машина, що будує зображення Docker), у сам Docker-образ.

ADD дозволяє зробити це теж, але він також підтримує 2 інших джерела. По-перше, ви можете використовувати URL, а не локальний файл / каталог. По-друге, ви можете витягнути файл tar з джерела безпосередньо в пункт призначення

Дійсний випадок використання ADD - це коли потрібно витягнути локальний файл tar в певний каталог вашого зображення Docker.

Якщо ви копіюєте в локальні файли на зображення Docker, завжди використовуйте COPY, оскільки це більш явно.

Під час створення Dockerfile є дві команди, які можна використовувати для копіювання файлів / каталогів у нього - ADDі COPY. Хоча є незначні відмінності в обсязі їх функції, вони по суті виконують одне і те ж завдання.

Отже, чому у нас є дві команди, і як ми знаємо, коли використовувати ту чи іншу?

DOCKER ADDCOMMAND

Почнемо з того, що ADDкоманда старша за COPY. З моменту запуску платформи Docker ADDінструкція входила до її списку команд.

Команда копіює файли / каталоги у файлову систему вказаного контейнера.

Основний синтаксис ADDкоманди:

ADD <src> … <dest>

Він включає джерело, яке ви хочете скопіювати ( <src>), а потім місце призначення, де ви хочете його зберегти ( <dest>). Якщо джерелом є каталог, ADDскопіюйте все, що знаходиться всередині нього (включаючи метадані файлової системи).

Наприклад, якщо файл локально доступний і ви хочете додати його до каталогу зображення, ви вводите:

ADD /source/file/path  /destination/path

ADDтакож можна копіювати файли з URL-адреси. Він може завантажити зовнішній файл і скопіювати його до потрібного пункту призначення. Наприклад:

ADD http://source.file/url  /destination/path

Додатковою особливістю є те, що вона копіює стиснуті файли, автоматично витягуючи вміст у вказане призначення. Ця функція стосується лише локально збережених стислих файлів / каталогів.

ADD source.file.tar.gz /temp

Майте на увазі, що ви не можете завантажити та витягнути стислий файл / каталог з URL-адреси. Команда не розпаковує зовнішні пакети при копіюванні їх у локальну файлову систему.

DOCKER COPYCOMMAND

Через деякі проблеми з функціональністю, Докер повинен був ввести додаткову команду для дублювання вмісту - COPY.

На відміну від тісно пов'язаної ADDкоманди, COPYмає лише одну призначену функцію. Його роль полягає у копіюванні файлів / каталогів у визначеному місці у їх наявному форматі. Це означає, що він не займається вилученням стислого файлу, а скопіює його як є.

Інструкцію можна використовувати лише для локально збережених файлів. Тому ви не можете використовувати його з URL-адресами для копіювання зовнішніх файлів у ваш контейнер.

Щоб використовувати COPYінструкцію, дотримуйтесь основного формату команд:

Введіть джерело і де ви хочете, щоб команда витягувала вміст наступним чином:

COPY <src> … <dest> 

Наприклад:

COPY /source/file/path  /destination/path 

Яку команду використовувати? (Найкраща практика)

З огляду на обставини, за яких COPYкоманда була введена, очевидно, що зберігання ADDбуло необхідним. Docker опублікував офіційний документ, в якому викладені кращі практики написання Dockerfiles, який прямо не рекомендує використовувати ADDкоманду.

В офіційній документації Докера зазначається, що COPYзавжди слід використовувати інструкцію, оскільки вона є більш прозорою, ніж ADD.

Якщо вам потрібно скопіювати з контексту локальної збірки в контейнер, дотримуйтесь використання COPY.

Команда Docker також сильно відмовляє ADDвід завантаження та копіювання пакету з URL-адреси. Натомість безпечніше та ефективніше використовувати wget чи curl у межах RUNкоманди. Тим самим ви уникаєте створення додаткового шару зображення та заощаджуєте простір.

Важлива примітка

Мені довелося COPYзнімати пакет java в моєму докерському образі. Коли я порівнював розмір зображення докера, створеного за допомогою ADD, він був на 180 Мб більший за розмір, створений за допомогою COPY, tar -xzf * .tar.gz та rm * .tar.gz

Це означає, що хоч ADD видаляє файл tar, він все ще зберігається десь. І це робить зображення більшим !!

Оскільки Docker 17.05 COPYвикористовується з --fromпрапором у багатоетапних складах для копіювання артефактів з попередніх етапів збірки на поточну стадію збірки.

з документації

За бажанням COPY приймає прапор, --from=<name|index>який може бути використаний для встановлення місця розташування джерела на попередньому етапі збірки (створеному з FROM .. AS), який буде використовуватися замість контексту збірки, надісланого користувачем.

docker build -t {image name} -v {host directory}:{temp build directory} .

Це ще один спосіб копіювання файлів у зображення. Параметр -v тимчасово створює об'єм, який ми використовували під час збирання.

Це відрізняється від інших томів, оскільки він монтує хост-каталог лише для збірки. Файли можна скопіювати за допомогою стандартної команди cp.

Крім того, як curl і wget, він може бути запущений у командному стеку (працює в одному контейнері) і не примножувати розмір зображення. ADD і COPY не підлягають складенню, оскільки вони працюють у окремому контейнері, і наступні команди на тих файлах, які виконуються в додаткових контейнерах, збільшать розмір зображення:

Завдяки таким параметрам:

-v /opt/mysql-staging:/tvol

У одному контейнері буде виконано наступне:

RUN cp -r /tvol/mysql-5.7.15-linux-glibc2.5-x86_64 /u1 && \
    mv /u1/mysql-5.7.15-linux-glibc2.5-x86_64 /u1/mysql && \

    mkdir /u1/mysql/mysql-files && \
    mkdir /u1/mysql/innodb && \
    mkdir /u1/mysql/innodb/libdata && \
    mkdir /u1/mysql/innodb/innologs && \
    mkdir /u1/mysql/tmp && \

    chmod 750 /u1/mysql/mysql-files && \
    chown -R mysql /u1/mysql && \
    chgrp -R mysql /u1/mysql