容器与云原生 / 系统课时
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 中会更清楚,也更方便审计构建过程。
按自己的节奏,确认真正理解。