容器与云原生 / 系统课时

COPY 和 ADD 应该怎么选

COPY 和 ADD 应该怎么选

COPY 和 ADD 都能把构建上下文中的文件放进镜像,但它们的职责并不完全相同。日常构建通常优先用 COPY,因为行为单一、容易审查;只有明确需要自动解包本地归档或其他 ADD 特性时,再选择 ADD。

学习目标

  • 理解 COPY 与 ADD 的共同点和关键差异
  • 验证本地压缩归档在两种指令下的不同结果
  • 根据构建意图选择更清晰的文件导入方式

COPY 的定位是显式复制

最常见的需求只是把源码、配置或静态文件从构建上下文复制到镜像。此时 COPY 最容易读懂:

dockerfile
COPY app.conf /app/app.conf

这行只表达一件事:把 app.conf 放到镜像中的 /app/app.conf。它不会因为文件扩展名看起来像压缩包就自动展开,因此 Dockerfile 的结果更容易从文本本身判断。

ADD 多了额外行为

ADD 也能复制本地文件,但还支持额外语义,其中最容易影响构建结果的是:本地 tar 归档会在复制时自动解包。此外,ADD 还支持从远程 URL 等来源取得内容。

这意味着下面两行看起来很像,结果却不同:

dockerfile
COPY files.tar.gz /tmp/
ADD files.tar.gz /tmp/

前者会把 files.tar.gz 作为文件保留在 /tmp/;后者会识别本地 tar 归档并把其中内容展开到 /tmp/。

实际构建验证差异

先准备一个归档文件:

bash
mkdir -p files
echo hello > files/hello.txt
tar -czf files.tar.gz files

预期结果:

text
当前目录生成 files.tar.gz,归档中包含 files/hello.txt。

创建 Dockerfile.copy:

dockerfile
FROM alpine:3.20

COPY files.tar.gz /tmp/
CMD ["sh", "-c", "test -f /tmp/files.tar.gz && echo copied"]

再创建 Dockerfile.add:

dockerfile
FROM alpine:3.20

ADD files.tar.gz /tmp/
CMD ["sh", "-c", "test -f /tmp/files/hello.txt && cat /tmp/files/hello.txt"]

分别构建并运行:

bash
docker build -f Dockerfile.copy -t copy-demo . >/dev/null 2>&1
docker build -f Dockerfile.add -t add-demo . >/dev/null 2>&1
docker run --rm copy-demo
docker run --rm add-demo

预期输出:

text
copied
hello

这组结果说明:COPY 保留了归档文件本身,而 ADD 对本地 tar 归档执行了解包。

为什么日常构建优先 COPY

选择 Dockerfile 指令时,可读性比“少写一步”更重要。源码、配置、证书、公钥、静态资源等普通文件,都适合直接使用 COPY。阅读者看到指令后,可以立即确定它只是复制,不需要继续判断是否发生下载或解包。

需求 更合适的选择 原因
复制源码或配置 COPY 行为单一、意图明确
复制压缩包但保持原文件 COPY 不会自动展开本地 tar
构建时自动展开本地 tar 归档 ADD 正是 ADD 的额外语义
下载远程文件后还要校验、解压或清理 通常使用 RUN 配合下载工具 下载、校验和清理步骤更显式

选择时先问“是否需要额外语义”

如果目标只是“把文件放进去”,用 COPY;如果确实要利用 ADD 的自动解包或其他特性,再使用 ADD。对于需要认证、校验哈希、控制重试或清理临时文件的远程下载,通常把这些步骤写在 RUN 中会更清楚,也更方便审计构建过程。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

COPY 和 ADD 应该怎么选

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通