В чём разница между COPY и ADD в Dockerfile, и когда предпочтительнее использовать COPY?

Короткий ответ

COPY копирует локальные файлы и папки без дополнительной логики; ADD умеет дополнительно автоматически распаковывать локальные tar-архивы и скачивать файлы по URL, что делает её менее предсказуемой — поэтому по умолчанию рекомендуют COPY.

Как это работает подробнее

обе инструкции копируют содержимое из контекста сборки (или, для ADD, из внешнего URL) в указанный путь внутри образа, создавая новый слой. ADD дополнительно проверяет, является ли источник локальным tar/tar.gz/tar.bz2-архивом — если да, автоматически распаковывает его в целевую директорию.

Пример кода

DockerfileКопировать

ADD app-dist.tar.gz /app/
COPY app-dist.tar.gz /app/

Что использовать на практике

• Практика. COPY предсказуема и явна — что скопировали, то и получили; ADD стоит использовать только когда осознанно нужна автораспаковка локального архива. Скачивание файлов через ADD URL по URL в современных Dockerfile не рекомендуется — лучше явный RUN curl -o ... && ..., потому что так можно проверить контрольную сумму и управлять кэшированием слоя точнее.

Подводные камни

• Риск. используют ADD "по привычке" для обычного копирования файлов, из-за чего поведение сборки для других членов команды становится менее очевидным; не замечают, что ADD с архивом неожиданно распаковывает файлы там, где ожидалось просто скопировать архив целиком.