容器与云原生 / 系统课时

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 时,只需问一个问题:这条命令是在“制作镜像”时完成,还是应该在“启动容器”时发生。

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

目录与阅读设置

阅读设置

17

记录一个想法

RUN 和 CMD 有什么区别

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

登录哪都通