容器与云原生 / 系统课时
使用 RUN COPY 与 ADD
使用 RUN COPY 与 ADD
本课解决“如何在构建阶段执行命令并把文件放进镜像”的问题。完成后,你将能正确使用 RUN、COPY 和 ADD,并避免因缓存、路径或误用自动解包造成的构建异常。
学习目标
- 使用
RUN执行构建期命令 - 使用
COPY从构建上下文复制文件 - 判断何时可以使用
ADD
三条指令的职责
RUN 在镜像构建期间执行命令,常用于安装依赖、创建目录或转换文件。它不会在每次容器启动时再次执行。
COPY 只负责把构建上下文中的文件或目录复制到镜像,行为直接、可预测,是复制本地内容时的默认选择。
ADD 除复制外,还能自动解压本地 tar 归档,并支持从 URL 获取内容。因为隐式行为更多,只有明确需要这些能力时才使用;普通文件复制仍优先选 COPY。
完整构建示例
准备以下目录:
copy-run-demo/
├── Dockerfile
└── message.txtmessage.txt 内容:
hello dockerDockerfile 内容:
FROM alpine:3.20
WORKDIR /app
COPY message.txt .
RUN tr 'a-z' 'A-Z' < message.txt > upper.txt
CMD ["cat", "/app/upper.txt"]COPY message.txt . 中的目标 . 指向当前 WORKDIR,即 /app。RUN 在构建时生成 upper.txt,因此容器运行时只需读取结果文件。构建镜像:
docker build -q -t copy-run-demo:1.0 .预期输出:
<IMAGE_ID>运行容器:
docker run --rm copy-run-demo:1.0预期输出:
HELLO DOCKERADD 的适用边界
下面是片段示例,依赖构建上下文中已存在 package.tar:
ADD package.tar /opt/package/构建时,Docker 会把本地 tar 归档内容解压到目标目录。若只是复制 package.tar 文件本身,应改用:
COPY package.tar /opt/package.tar不要使用 ADD 下载需要校验的重要安装包。更可控的做法是在 RUN 中使用下载工具,并同时校验摘要、删除缓存;这样网络行为和失败原因更清晰。
缓存与路径问题
当 COPY 的源文件发生变化时,该指令及其后的缓存层通常会失效。因此可先复制依赖清单并安装依赖,再复制频繁变化的源码,减少重复安装。
源路径始终相对于构建上下文,而不是 Dockerfile 所在位置。若使用 docker build -f docker/Dockerfile .,上下文仍是命令末尾的 .。出现文件不存在时,应同时检查上下文路径和 .dockerignore。