容器与云原生 / 系统课时
RUN 和 CMD 有什么区别
RUN 和 CMD 有什么区别
RUN 和 CMD 都能写命令,但它们发生在完全不同的阶段:RUN 在构建镜像时执行并把结果保存进镜像,CMD 不在构建时执行,而是记录容器启动时默认要运行的命令。混用两者会直接导致镜像行为异常。
学习目标
- 区分
RUN的构建时行为和CMD的运行时行为。 - 能通过实际构建观察
RUN产生的文件如何进入镜像。 - 理解容器启动参数为什么可以覆盖
CMD。
两条指令发生在不同阶段
| 对比项 | RUN |
CMD |
|---|---|---|
| 执行时机 | docker build 构建阶段 |
docker run 启动容器时 |
| 主要用途 | 安装软件、编译、生成固定文件 | 提供默认前台进程或默认参数 |
| 是否在构建时真正执行命令 | 是 | 否 |
能否被 docker run IMAGE ... 直接替换 |
不适用 | 可以,镜像没有 ENTRYPOINT 时会被替换 |
因此,安装依赖应该写在 RUN 中;启动 Web 服务、任务进程或应用程序的默认命令通常写在 CMD 中。
用一个镜像同时观察 RUN 和 CMD
创建下面的 Dockerfile:
dockerfile
FROM alpine:3.20
RUN printf 'built at image build\n' > /build.txt
CMD ["sh", "-c", "cat /build.txt && echo 'started at container run'"]RUN 在构建阶段创建 /build.txt,这个文件会随镜像保存下来。CMD 只是写入默认启动配置,此时并不会读取该文件。
先构建镜像:
bash
docker build -q -t run-cmd-demo:1.0 .预期输出
text
sha256:<ID>再分别使用默认命令和自定义命令启动容器:
bash
docker run --rm run-cmd-demo:1.0
docker run --rm run-cmd-demo:1.0 sh -c 'cat /build.txt && echo overridden'预期输出
text
built at image build
started at container run
built at image build
overridden第一段结果证明 /build.txt 已在构建阶段生成。第二次启动时,镜像原有 CMD 被 sh -c ... 替换,但 /build.txt 仍然存在,因为它属于镜像文件系统,而不是 CMD 的执行结果。
什么时候分别使用
需要把结果固化进镜像时使用 RUN,例如安装系统包、执行编译、下载并整理构建期依赖。需要定义“用户不额外传命令时容器做什么”时使用 CMD,例如启动应用主进程。
对于不需要 Shell 语法的启动命令,通常优先使用 JSON 数组形式的 CMD,这样进程接收参数和操作系统信号的行为更直接。示例中使用 sh -c,是因为命令包含 && 这样的 Shell 操作符。
常见混用问题
把安装命令写进 CMD,会让容器每次启动都重新安装依赖;把长期运行的服务写进 RUN,服务只会在构建步骤中短暂启动,构建结束后进程不会继续存在。
同一个构建阶段里如果写多条 CMD,只有最后一条会成为镜像默认命令。判断该写 RUN 还是 CMD 时,只需问一个问题:这条命令是在“制作镜像”时完成,还是应该在“启动容器”时发生。
按自己的节奏,确认真正理解。