Dockerfile 中的 COPY
和 ADD
命令有什么区别,我什么时候可以使用其中一个?
COPY <src> <dest>
COPY 指令将从
ADD <src> <dest>
ADD 指令将从
docker cp
会将文件复制到/从正在运行的容器中。 COPY 指令是用于构建镜像的 Dockerfile。
您应该查看 ADD
和 COPY
文档以更详细地描述它们的行为,但简而言之,主要区别在于 ADD
可以做的不仅仅是 COPY
:
ADD 允许
参考下面的评论,ADD 文档指出:
如果是可识别压缩格式(identity、gzip、bzip2 或 xz)的本地 tar 存档,则将其解压缩为目录。来自远程 URL 的资源不会被解压缩。
请注意,Best practices for writing Dockerfiles 建议在不需要 ADD
的魔力的情况下使用 COPY
。否则,当您打算将 keep_this_archive_intact.tar.gz
复制到您的容器中时,您(因为您必须查找此答案)可能会感到惊讶,而是将内容喷射到您的文件系统中。
关于这一点有一些官方文档:Best Practices for Writing Dockerfiles
因为图像大小很重要,所以强烈建议不要使用 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 的 tar 自动提取功能的其他项目(文件、目录),您应该始终使用 COPY。
来自 Docker 文档:
ADD 或 COPY 虽然 ADD 和 COPY 在功能上相似,但一般来说,首选 COPY。那是因为它比 ADD 更透明。 COPY 仅支持将本地文件基本复制到容器中,而 ADD 具有一些不是立即显而易见的功能(如仅本地 tar 提取和远程 URL 支持)。因此,ADD 的最佳用途是将本地 tar 文件自动提取到映像中,如 ADD rootfs.tar.xz /。
更多:Best practices for writing 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 支持仅本地的 tar 提取。除此之外,COPY 将使用三层,而 ADD 仅使用一层。
COPY
将文件/目录从您的主机复制到您的映像。
ADD
将文件/目录从您的主机复制到您的图像,但也可以获取远程 URL、提取 TAR 文件等...
使用 COPY
将文件和/或目录简单地复制到构建上下文中。
使用 ADD
下载远程资源、提取 TAR 文件等。
创建 Dockerfile 时,您可以使用两个命令将文件/目录复制到其中 - ADD
和 COPY
。尽管它们的功能范围略有不同,但它们基本上执行相同的任务。
那么,为什么我们有两个命令,我们怎么知道什么时候使用其中一个呢?
码头工人 ADD
命令
===
我们首先要注意 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 下载和提取压缩文件/目录。该命令在将外部包复制到本地文件系统时不会对其进行解包。
码头工人 COPY
命令
===
由于一些功能问题,Docker 不得不引入一个额外的命令来复制内容 - COPY
。
与其密切相关的 ADD
命令不同,COPY
只有一个指定的功能。它的作用是以现有格式复制指定位置的文件/目录。这意味着它不处理提取压缩文件,而是按原样复制它。
该指令只能用于本地存储的文件。因此,您不能将其与 URL 一起使用来将外部文件复制到您的容器中。
要使用 COPY
指令,请遵循基本命令格式:
键入源和您希望命令提取内容的位置,如下所示:
COPY <src> … <dest>
例如:
COPY /source/file/path /destination/path
使用哪个命令? (最佳实践)
考虑到引入 COPY
命令的情况,显然保留 ADD
是必要的。 Docker 发布了一份官方文档,概述了编写 Dockerfile 的最佳实践,其中明确建议不要使用 ADD
命令。
Docker 的官方文档指出,COPY
应该始终是首选指令,因为它比 ADD
更透明。
如果您需要从本地构建上下文复制到容器中,请坚持使用 COPY
。
Docker 团队还强烈反对使用 ADD
从 URL 下载和复制包。相反,在 RUN
命令中使用 wget 或 curl 会更安全、更有效。通过这样做,您可以避免创建额外的图像层并节省空间。
来自 Docker 文档:https://docs.docker.com/engine/userguide/eng-image/dockerfile_best-practices/#add-or-copy
“虽然 ADD 和 COPY 在功能上相似,但总的来说还是首选 COPY。因为它比 ADD 更透明。COPY 只支持将本地文件基本复制到容器中,而 ADD 有一些功能(如仅本地 tar 提取和远程 URL 支持)不是很明显。因此,ADD 的最佳用途是将本地 tar 文件自动提取到图像中,如 ADD rootfs.tar.xz /。
如果您有多个 Dockerfile 步骤使用来自您的上下文的不同文件,请单独复制它们,而不是一次全部复制。这将确保每个步骤的构建缓存仅在特定要求的文件更改时才失效(强制重新运行该步骤)。
例如:
COPY requirements.txt /tmp/
RUN pip install --requirement /tmp/requirements.txt
COPY . /tmp/
与放置 COPY 相比,导致 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,因为它更明确。
由于 Docker 17.05 COPY
与 multi-stage builds 中的 --from
标志一起使用,以将工件从先前的构建阶段复制到当前的构建阶段。
COPY 可选择接受一个标志 --from=
COPY 不支持带有 URL 方案的
ADD
指令从本地或远程源复制文件或文件夹并将它们添加到容器的文件系统中。它用于复制本地文件,这些文件必须在工作目录中。 ADD
指令将本地 .tar
文件解压缩到目标图像目录。
例子
ADD http://someserver.com/filename.pdf /var/www/html
COPY
从工作目录复制文件并将它们添加到容器的文件系统中。无法通过此 Dockerfile 指令使用其 URL
复制远程文件。
例子
COPY Gemfile Gemfile.lock ./
COPY ./src/ /var/www/html/
假设您有一个 tar 文件,并且您想在将其放入容器后将其解压缩,然后将其删除,您可以使用 COPY 命令来执行此操作。但各种命令将是 1) 将 tar 文件复制到目标位置,2)。解压缩,3) 删除 tar 文件。如果您分 3 步执行此操作,那么在每一步之后都会创建一个新图像。您可以使用 & 一步完成此操作,但这会变得很麻烦。
但是您使用了 ADD,那么 Docker 会为您处理所有事情,并且只会创建一个中间映像。
如果您有 foo.tar.gz 文件,请比较以下命令。 ADD 命令创建的层数比 COPY 命令少,并且在推送 docker 镜像时节省了大量的网络流量。
ADD foo.tar.gz /
COPY foo.tar.gz /
RUN tar -zxvf foo.tar.gz
RUN rm -rf foo.tar.gz
ADD 和 COPY 都具有将文件和目录从源复制到目标的相同功能,但 ADD 具有额外的文件提取和 URL 文件提取功能。最好的做法是在只复制操作中使用 COPY,只避免 ADD 是许多区域。该链接将通过一些简单的示例对其进行解释difference between COPY and ADD in dockerfile
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
不定期副业成功案例分享