容器与云原生 / 系统课时

使用 RUN COPY 与 ADD

使用 RUN COPY 与 ADD

本课解决“如何在构建阶段执行命令并把文件放进镜像”的问题。完成后,你将能正确使用 RUN、COPY 和 ADD,并避免因缓存、路径或误用自动解包造成的构建异常。

学习目标

  • 使用 RUN 执行构建期命令
  • 使用 COPY 从构建上下文复制文件
  • 判断何时可以使用 ADD

三条指令的职责

RUN 在镜像构建期间执行命令,常用于安装依赖、创建目录或转换文件。它不会在每次容器启动时再次执行。

COPY 只负责把构建上下文中的文件或目录复制到镜像,行为直接、可预测,是复制本地内容时的默认选择。

ADD 除复制外,还能自动解压本地 tar 归档,并支持从 URL 获取内容。因为隐式行为更多,只有明确需要这些能力时才使用;普通文件复制仍优先选 COPY。

完整构建示例

准备以下目录:

text
copy-run-demo/
├── Dockerfile
└── message.txt

message.txt 内容:

text
hello docker

Dockerfile 内容:

dockerfile
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,因此容器运行时只需读取结果文件。构建镜像:

bash
docker build -q -t copy-run-demo:1.0 .

预期输出:

text
<IMAGE_ID>

运行容器:

bash
docker run --rm copy-run-demo:1.0

预期输出:

text
HELLO DOCKER

ADD 的适用边界

下面是片段示例,依赖构建上下文中已存在 package.tar:

dockerfile
ADD package.tar /opt/package/

构建时,Docker 会把本地 tar 归档内容解压到目标目录。若只是复制 package.tar 文件本身,应改用:

dockerfile
COPY package.tar /opt/package.tar

不要使用 ADD 下载需要校验的重要安装包。更可控的做法是在 RUN 中使用下载工具,并同时校验摘要、删除缓存;这样网络行为和失败原因更清晰。

缓存与路径问题

当 COPY 的源文件发生变化时,该指令及其后的缓存层通常会失效。因此可先复制依赖清单并安装依赖,再复制频繁变化的源码,减少重复安装。

源路径始终相对于构建上下文,而不是 Dockerfile 所在位置。若使用 docker build -f docker/Dockerfile .,上下文仍是命令末尾的 .。出现文件不存在时,应同时检查上下文路径和 .dockerignore。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 RUN COPY 与 ADD

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

登录哪都通