Jaka jest różnica między poleceniami COPYi ADDw pliku Docker i kiedy miałbym używać jednego nad drugim?

COPY <src> <dest>

Instrukcja COPY skopiuje nowe pliki <src>i doda je do systemu plików kontenera pod ścieżką<dest>

ADD <src> <dest>

Instrukcja ADD skopiuje nowe pliki <src>i doda je do systemu plików kontenera pod ścieżką <dest>.

Powinieneś sprawdzić dokumentację ADDi COPYuzyskać bardziej szczegółowy opis ich zachowań, ale w skrócie, główną różnicą jest to, że ADDmożna zrobić więcej niż COPY:

• ADDpozwala <src>być adresem URL
• Odnosząc się do poniższych komentarzy, ADD dokumentacja stwierdza, że:

  Jeśli jest to lokalne archiwum tar w rozpoznanym formacie kompresji (tożsamość, gzip, bzip2 lub xz), wówczas jest rozpakowywane jako katalog. Zasoby ze zdalnych adresów URL nie są dekompresowane.

Zauważ, że najlepsze praktyki pisania Dockerfiles sugerują używanie COPYtam, gdzie magia ADDnie jest wymagana. W przeciwnym razie możesz ( ponieważ musiałeś poszukać tej odpowiedzi ) pewnego dnia zdziwić się, gdy będziesz chciał skopiować keep_this_archive_intact.tar.gzdo swojego kontenera, ale zamiast tego rozpylisz zawartość na swój system plików.

COPY jest

Taki sam jak „DODAJ”, ale bez obsługi tar i zdalnej obsługi adresów URL.

Odwołanie prosto z kodu źródłowego .

Istnieje na ten temat oficjalna dokumentacja: Najlepsze praktyki pisania plików Docker

Ponieważ rozmiar obrazu ma znaczenie, ADDzdecydowanie zaleca się używanie do pobierania pakietów ze zdalnych adresów URL; powinieneś użyć curllub wgetzamiast tego. W ten sposób możesz usunąć niepotrzebne pliki po ich wyodrębnieniu i nie będziesz musiał dodawać kolejnej warstwy na obrazie.

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

W przypadku innych elementów (plików, katalogów), które nie wymagają ADDfunkcji automatycznego wyodrębniania tar, należy zawsze używać COPY.

Z dokumentów Docker:

DODAJ lub KOPIUJ

Chociaż funkcje DODAJ i KOPIUJ są funkcjonalnie podobne, ogólnie mówiąc, preferowana jest KOPIA. To dlatego, że jest bardziej przejrzysty niż ADD. Funkcja COPY obsługuje tylko podstawowe kopiowanie plików lokalnych do kontenera, podczas gdy ADD ma pewne funkcje (takie jak lokalna ekstrakcja tar i obsługa zdalnego adresu URL), które nie są od razu oczywiste. W związku z tym najlepszym zastosowaniem ADD jest automatyczna ekstrakcja lokalnego pliku tar do obrazu, tak jak w ADD rootfs.tar.xz /.

Więcej: Najlepsze praktyki pisania Dockerfiles

Jeśli chcesz dodać plik xx.tar.gz do /usr/localkontenera, rozpakuj go, a następnie usuń niepotrzebny skompresowany pakiet.

Do kopiowania:

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

Do dodania:

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

ADD obsługuje tylko lokalną ekstrakcję smoły. Poza tym COPY będzie używać trzech warstw, ale ADD używa tylko jednej warstwy.

COPY kopiuje plik / katalog z twojego hosta na twój obraz.

ADD kopiuje plik / katalog z twojego hosta na obraz, ale może również pobierać zdalne adresy URL, wyodrębniać pliki TAR itp.

Służy COPYdo prostego kopiowania plików i / lub katalogów w kontekście kompilacji.

Służy ADDdo pobierania zdalnych zasobów, wypakowywania plików TAR itp.

Z Docker docs: https://docs.docker.com/engine/userguide/eng-image/dockerfile_best-practices/#add-or-copy

„Chociaż ADD i COPY są funkcjonalnie podobne, ogólnie rzecz biorąc, preferuje się COPY. Jest tak, ponieważ jest bardziej przejrzysty niż ADD. COPY obsługuje tylko podstawowe kopiowanie plików lokalnych do kontenera, podczas gdy ADD ma pewne funkcje (takie jak lokalne wyodrębnianie tar i zdalna obsługa adresów URL), które nie są od razu oczywiste. Dlatego najlepszym rozwiązaniem dla ADD jest lokalna ekstrakcja pliku tar do obrazu, tak jak w ADD rootfs.tar.xz /.

Jeśli masz wiele kroków Dockerfile, które używają innych plików z twojego kontekstu, KOPIUJ je indywidualnie, a nie wszystkie naraz. Zapewni to, że pamięć podręczna kompilacji każdego kroku zostanie unieważniona (wymuszając ponowne uruchomienie kroku), jeśli zmienią się specjalnie wymagane pliki.

Na przykład:

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

Powoduje mniej unieważnień pamięci podręcznej dla kroku RUN, niż jeśli umieścisz KOPIUJ. / tmp / przed nim.

Ponieważ rozmiar obrazu ma znaczenie, użycie ADD do pobierania pakietów ze zdalnych adresów URL jest zdecydowanie odradzane; zamiast tego powinieneś użyć curl lub wget. W ten sposób możesz usunąć niepotrzebne pliki po ich wyodrębnieniu i nie będziesz musiał dodawać kolejnej warstwy na obrazie. Na przykład powinieneś unikać robienia takich rzeczy jak:

 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

Zamiast tego zrób coś takiego:

 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

W przypadku innych elementów (plików, katalogów), które nie wymagają funkcji automatycznego wyodrębniania tar ADD, należy zawsze używać funkcji KOPIUJ ”.

Źródło: https://nickjanetakis.com/blog/docker-tip-2-the-difference-between-copy-and-add-in-a-dockerile :

KOPIUJ i DODAJ to instrukcje Dockerfile, które służą do podobnych celów. Pozwalają kopiować pliki z określonej lokalizacji do obrazu Docker.

Funkcja COPY przyjmuje kod źródłowy i docelowy. Pozwala tylko skopiować lokalny plik lub katalog z hosta (maszyny budującej obraz Docker) do samego obrazu Docker.

ADD pozwala ci to zrobić, ale obsługuje również 2 inne źródła. Po pierwsze, możesz użyć adresu URL zamiast lokalnego pliku / katalogu. Po drugie, możesz wyodrębnić plik tar ze źródła bezpośrednio do miejsca docelowego

Prawidłowym przypadkiem użycia dla ADD jest, gdy chcesz wyodrębnić lokalny plik tar do określonego katalogu w obrazie Docker.

Jeśli kopiujesz w plikach lokalnych do obrazu Docker, zawsze używaj KOPIUJ, ponieważ jest to bardziej wyraźne.

Podczas tworzenia pliku Docker istnieją dwa polecenia, których można użyć do skopiowania do niego plików / katalogów - ADDi COPY. Chociaż istnieją niewielkie różnice w zakresie ich funkcji, zasadniczo wykonują to samo zadanie.

Dlaczego więc mamy dwa polecenia i skąd wiemy, kiedy użyć jednego lub drugiego?

DOKER ADDPOLECENIE

Zacznijmy od zauważenia, że ADDpolecenie jest starsze niż COPY. Od momentu uruchomienia platformy Docker,ADD instrukcja jest częścią listy poleceń.

Polecenie kopiuje pliki / katalogi do systemu plików określonego kontenera.

Podstawowa składnia ADDpolecenia to:

ADD <src> … <dest>

Zawiera źródło, które chcesz skopiować ( <src>), a następnie miejsce docelowe, w którym chcesz je zapisać ( <dest>). Jeśli źródłem jest katalog,ADD skopiuj wszystko z niego (łącznie z metadanymi systemu plików).

Na przykład, jeśli plik jest dostępny lokalnie i chcesz go dodać do katalogu obrazu, wpisz:

ADD /source/file/path  /destination/path

ADDmoże również kopiować pliki z adresu URL. Może pobrać plik zewnętrzny i skopiować go do żądanego miejsca docelowego. Na przykład:

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

Dodatkową funkcją jest to, że kopiuje skompresowane pliki, automatycznie wyodrębniając zawartość w danym miejscu docelowym. Ta funkcja dotyczy tylko lokalnie przechowywanych skompresowanych plików / katalogów.

ADD source.file.tar.gz /temp

Pamiętaj, że nie można pobrać i wyodrębnić skompresowanego pliku / katalogu z adresu URL. Polecenie nie rozpakowuje pakietów zewnętrznych podczas kopiowania ich do lokalnego systemu plików.

DOKER COPYPOLECENIE

Z powodu pewnych problemów z funkcjonalnością Docker musiał wprowadzić dodatkowe polecenie do powielania treści - COPY.

W przeciwieństwie do ściśle powiązanego ADDpolecenia, COPYma tylko jedną przypisaną funkcję. Jego rolą jest duplikowanie plików / katalogów w określonej lokalizacji w ich istniejącym formacie. Oznacza to, że nie zajmuje się wypakowywaniem skompresowanego pliku, a raczej kopiuje go takim, jakim jest.

Z instrukcji można korzystać tylko w przypadku plików przechowywanych lokalnie. Dlatego nie można go używać z adresami URL do kopiowania plików zewnętrznych do kontenera.

Aby skorzystać z COPYinstrukcji, postępuj zgodnie z podstawowym formatem poleceń:

Wpisz źródło i miejsce, w którym polecenie ma wyodrębnić zawartość w następujący sposób:

COPY <src> … <dest> 

Na przykład:

COPY /source/file/path  /destination/path 

Którego polecenia użyć? (Najlepsza praktyka)

Biorąc pod uwagę okoliczności, w których COPYpolecenie zostało wprowadzone, oczywiste jest, że dotrzymywanie go ADDbyło koniecznością. Docker opublikował oficjalny dokument opisujący najlepsze praktyki pisania Dockerfiles, który wyraźnie odradza korzystanie zADD polecenia.

Oficjalna dokumentacja Dockera wskazuje, że COPYpowinna ona zawsze być instrukcją, ponieważ jest bardziej przejrzysta niż ADD.

Jeśli chcesz skopiować z lokalnego kontekstu kompilacji do kontenera, trzymaj się COPY.

Zespół dokerów zdecydowanie odradza również ADDpobieranie i kopiowanie pakietu z adresu URL. Zamiast tego bezpieczniej i wydajniej jest używać wget lub curl w RUNpoleceniu. W ten sposób unikasz tworzenia dodatkowej warstwy obrazu i oszczędzasz miejsce.

Ważna uwaga

Musiałem COPYrozpakować pakiet Java na obrazie dokera. Kiedy porównałem rozmiar obrazu dokera utworzonego za pomocą ADD, był o 180 MB większy niż ten utworzony za pomocą COPY, tar -xzf * .tar.gz i rm * .tar.gz

Oznacza to, że chociaż ADD usuwa plik tar, nadal jest gdzieś przechowywany. I dzięki temu obraz jest większy !!

Ponieważ Docker 17.05 COPYjest używany z --fromflagą w kompilacjach wieloetapowych do kopiowania artefaktów z poprzednich etapów kompilacji do bieżącego etapu kompilacji.

z dokumentacji

Opcjonalnie COPY akceptuje flagę, --from=<name|index>której można użyć, aby ustawić lokalizację źródłową na poprzedni etap kompilacji (utworzony za pomocą FROM .. AS), który będzie używany zamiast kontekstu kompilacji wysłanego przez użytkownika.

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

To kolejny sposób kopiowania plików do obrazu. Opcja -v tymczasowo tworzy wolumin, którego użyliśmy podczas procesu kompilacji.

Różni się to od innych woluminów, ponieważ montuje katalog hosta tylko dla kompilacji. Pliki można skopiować za pomocą standardowej komendy cp.

Podobnie jak curl i wget, można go uruchomić na stosie poleceń (działa w jednym kontenerze) i nie pomnożyć rozmiaru obrazu. ADD i COPY nie można ustawiać jeden na drugim, ponieważ działają w autonomicznym kontenerze, a kolejne polecenia na plikach wykonywanych w dodatkowych kontenerach zwiększają rozmiar obrazu:

Po ustawieniu opcji w ten sposób:

-v /opt/mysql-staging:/tvol

W jednym kontenerze zostaną wykonane następujące czynności:

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