В чем разница между COPY и ADD в Docker?

Question

deepseek-v3.2 · Accepted Answer

## Разница между инструкциями COPY и ADD в Docker Обе инструкции `COPY` и `ADD` используются в Dockerfile для копирования файлов и директорий из хост-системы в образ контейнера, но они имеют **существенные различия** в функциональности и рекомендуемом использовании. ### Основные различия #### **Инструкция COPY** `COPY` — это базовая инструкция, которая выполняет прямую задачу: копирует файлы и директории из локальной файловой системы (контекста сборки) в файловую систему образа. **Синтаксис:** ```dockerfile COPY [--chown=:] ... ``` **Ключевые особенности:** - Копирует только локальные файлы из **контекста сборки Docker** - Не поддерживает автоматическую распаковку архивов - Не поддерживает загрузку файлов из URL - Более предсказуема и явна в поведении - **Рекомендуется для большинства случаев** согласно best practices Docker **Пример использования:** ```dockerfile COPY package.json /app/ COPY ./src /app/src COPY --chown=node:node config/ /app/config/ ``` #### **Инструкция ADD** `ADD` — более функциональная инструкция с дополнительными возможностями, но менее предсказуемая. **Синтаксис:** ```dockerfile ADD [--chown=:] ... ``` **Дополнительные возможности ADD:** 1. **Автоматическая распаковка архивов** (tar, gzip, bzip2, xz) 2. **Поддержка URL в качестве источника** (скачивание файлов из интернета) 3. Поддержка тех же операций, что и `COPY` **Пример использования ADD:** ```dockerfile ADD https://example.com/file.tar.gz /tmp/ ADD application.tar.gz /app/ ADD --chown=user:group ./data.tar.xz /data/ ``` ### Подробное сравнение #### **Работа с архивами** **COPY:** Требует явной распаковки архива ```dockerfile COPY archive.tar.gz /tmp/ RUN tar -xzf /tmp/archive.tar.gz -C /app && \ rm /tmp/archive.tar.gz ``` **ADD:** Автоматически распаковывает архивы ```dockerfile ADD archive.tar.gz /app/ # Архив автоматически распаковывается в /app/ ``` #### **Загрузка из URL** **COPY:** Не поддерживает URL — вызывает ошибку сборки ```dockerfile # Так не сработает: COPY https://example.com/file.txt /app/ ``` **ADD:** Поддерживает загрузку из URL ```dockerfile ADD https://example.com/file.txt /app/ # Файл будет загружен из интернета ``` ### **Рекомендации и best practices** #### **Когда использовать COPY (рекомендуется в 95% случаев):** - Для копирования локальных файлов и директорий - Когда нужна явность и предсказуемость - Для соблюдения принципа минимальной достаточности - В production-сборках для повышения безопасности #### **Когда можно использовать ADD:** 1. **Для автоматической распаковки локальных архивов** ```dockerfile ADD application.tar.gz /app/ ``` 2. **Для загрузки файлов из URL** (хотя лучше использовать `RUN wget` или `RUN curl` для большей контролируемости) ```dockerfile ADD https://go.dev/dl/go1.21.0.linux-amd64.tar.gz /tmp/ ``` ### **Важные предупреждения** #### **Проблемы безопасности ADD:** ```dockerfile # Потенциально опасно - скачивание из непроверенного источника ADD https://untrusted-source.com/script.sh /app/ ``` #### **Непредсказуемое поведение:** ```dockerfile ADD file.tar.gz /app/ # Если file.tar.gz - не архив, а обычный файл с таким расширением, # он будет скопирован без распаковки ``` ### **Практический пример сравнения** **Вариант с COPY (рекомендуемый):** ```dockerfile FROM alpine:latest # Копируем локальные файлы COPY package.json /app/ COPY src/ /app/src/ # Явная распаковка архива COPY dependencies.tar.gz /tmp/ RUN tar -xzf /tmp/dependencies.tar.gz -C /app && \ rm /tmp/dependencies.tar.gz # Явная загрузка из URL RUN wget -O /app/datafile.json https://example.com/data.json ``` **Вариант с ADD:** ```dockerfile FROM alpine:latest ADD package.json /app/ ADD src/ /app/src/ ADD dependencies.tar.gz /app/ # Автоматическая распаковка ADD https://example.com/data.json /app/datafile.json ``` ### **Выводы** 1. **Используйте `COPY` по умолчанию** — это явная, безопасная и предсказуемая инструкция 2. **Используйте `ADD` только когда нужны его специфические функции** (распаковка архивов или загрузка из URL) 3. **Для загрузки из URL лучше использовать `RUN` с `curl`/`wget`** — это дает больше контроля над процессом 4. **Явность лучше магии** — явная распаковка архивов понятнее, чем автоматическая Основное правило: если вам не нужны специальные возможности `ADD`, всегда выбирайте `COPY` — это делает Dockerfile более читаемым, безопасным и соответствующим best practices индустрии.

В чем разница между COPY и ADD в Docker?

Комментарии (1)

Разница между инструкциями COPY и ADD в Docker

Основные различия

Инструкция COPY

Инструкция ADD

Подробное сравнение

Работа с архивами

Загрузка из URL

Рекомендации и best practices

Когда использовать COPY (рекомендуется в 95% случаев):

Когда можно использовать ADD:

Важные предупреждения

Проблемы безопасности ADD:

Непредсказуемое поведение:

Практический пример сравнения

Выводы