容器与云原生 / 系统课时
Dockerfile 的作用与结构
Dockerfile 的作用与结构
Dockerfile 把“镜像里应该有什么、按什么顺序构建、容器默认怎么启动”写成可审查的文本。本篇会用一个最小镜像串起基础指令、构建层次与文件组织,让你能独立读懂并维护常见 Dockerfile。
学习目标
- 说明 Dockerfile、构建上下文与最终镜像之间的关系
- 读懂
FROM、WORKDIR、COPY、RUN、CMD等核心指令 - 用可维护的顺序组织 Dockerfile,并完成一次构建与运行验证
Dockerfile 描述的是构建过程
Dockerfile 不是正在运行的容器配置清单,而是一组交给镜像构建器顺序处理的指令。构建器读取 Dockerfile,并结合构建上下文中的文件生成镜像;以后创建容器时,才会使用镜像中的文件系统和默认启动配置。

FROM 决定基础镜像,也是后续指令的起点。WORKDIR 设置后续指令的工作目录;COPY 把构建上下文中的文件复制进镜像;RUN 在构建阶段执行命令并把结果写入镜像;CMD 保存容器启动时的默认命令,不会在构建阶段执行。
多数会改变文件系统的构建步骤会影响镜像层和缓存;CMD、ENV、EXPOSE 等指令更多是在修改镜像配置。维护时应把稳定、变化少的步骤放前面,把频繁变化的源码复制和构建步骤放后面,以提高缓存复用率。
写一个最小可用 Dockerfile
下面的示例只依赖一个文本文件。它先选择基础镜像,再固定工作目录并复制文件,最后声明容器启动时读取该文件。
FROM alpine:3.22
WORKDIR /app
COPY message.txt .
CMD ["cat", "/app/message.txt"]这里使用 JSON 数组形式的 CMD,容器启动时会直接执行 cat,避免额外经过 shell 解析。Dockerfile 默认文件名就是 Dockerfile;如果使用其他文件名,可以在构建时通过 -f 指定。
在同一目录创建 message.txt 后构建并运行:
printf 'Dockerfile works\n' > message.txt
docker build -q -t dockerfile-structure-demo . >/dev/null
docker run --rm dockerfile-structure-demo预期输出
Dockerfile works若本机首次使用 alpine:3.22,构建器可能先拉取基础镜像,因此耗时会更长,但最终容器输出应保持一致。
按变化频率组织指令
可维护的 Dockerfile 不只是“能构建”。构建器会尽量复用没有变化的缓存结果;一旦某一步的输入改变,该步骤以及依赖它的后续步骤通常需要重新执行。因此,依赖清单和安装依赖常常放在源码复制之前。
例如 Node.js 项目通常先复制 package.json 与锁文件、安装依赖,再复制应用源码。这样只改业务代码时,不必反复执行完整依赖安装。相反,如果一开始就 COPY . .,任何源码改动都可能让后续依赖安装失去缓存价值。
区分构建阶段和运行阶段
最容易混淆的是 RUN 与 CMD。RUN 发生在 docker build 期间,例如安装软件、编译程序或创建目录;它的结果进入镜像。CMD 则只是镜像的默认启动配置,真正执行发生在 docker run 或编排系统启动容器时。
如果一个 Dockerfile 有多条 CMD,只有最后一条生效。需要在构建时执行多步准备,应使用合适的 RUN;需要定义容器默认启动程序,则保留一个清晰的 CMD 或 ENTRYPOINT。能把这两个阶段分清,就能避免“构建时为什么没启动服务”或“容器启动后为什么命令被覆盖”这类常见误判。