容器与云原生 / 系统课时

Dockerfile 的作用与结构

Dockerfile 的作用与结构

Dockerfile 把“镜像里应该有什么、按什么顺序构建、容器默认怎么启动”写成可审查的文本。本篇会用一个最小镜像串起基础指令、构建层次与文件组织,让你能独立读懂并维护常见 Dockerfile。

学习目标

  • 说明 Dockerfile、构建上下文与最终镜像之间的关系
  • 读懂 FROM、WORKDIR、COPY、RUN、CMD 等核心指令
  • 用可维护的顺序组织 Dockerfile,并完成一次构建与运行验证

Dockerfile 描述的是构建过程

Dockerfile 不是正在运行的容器配置清单,而是一组交给镜像构建器顺序处理的指令。构建器读取 Dockerfile,并结合构建上下文中的文件生成镜像;以后创建容器时,才会使用镜像中的文件系统和默认启动配置。

Dockerfile 从构建描述到镜像的关系

FROM 决定基础镜像,也是后续指令的起点。WORKDIR 设置后续指令的工作目录;COPY 把构建上下文中的文件复制进镜像;RUN 在构建阶段执行命令并把结果写入镜像;CMD 保存容器启动时的默认命令,不会在构建阶段执行。

多数会改变文件系统的构建步骤会影响镜像层和缓存;CMD、ENV、EXPOSE 等指令更多是在修改镜像配置。维护时应把稳定、变化少的步骤放前面,把频繁变化的源码复制和构建步骤放后面,以提高缓存复用率。

写一个最小可用 Dockerfile

下面的示例只依赖一个文本文件。它先选择基础镜像,再固定工作目录并复制文件,最后声明容器启动时读取该文件。

dockerfile
FROM alpine:3.22

WORKDIR /app

COPY message.txt .

CMD ["cat", "/app/message.txt"]

这里使用 JSON 数组形式的 CMD,容器启动时会直接执行 cat,避免额外经过 shell 解析。Dockerfile 默认文件名就是 Dockerfile;如果使用其他文件名,可以在构建时通过 -f 指定。

在同一目录创建 message.txt 后构建并运行:

bash
printf 'Dockerfile works\n' > message.txt
docker build -q -t dockerfile-structure-demo . >/dev/null
docker run --rm dockerfile-structure-demo

预期输出

text
Dockerfile works

若本机首次使用 alpine:3.22,构建器可能先拉取基础镜像,因此耗时会更长,但最终容器输出应保持一致。

按变化频率组织指令

可维护的 Dockerfile 不只是“能构建”。构建器会尽量复用没有变化的缓存结果;一旦某一步的输入改变,该步骤以及依赖它的后续步骤通常需要重新执行。因此,依赖清单和安装依赖常常放在源码复制之前。

例如 Node.js 项目通常先复制 package.json 与锁文件、安装依赖,再复制应用源码。这样只改业务代码时,不必反复执行完整依赖安装。相反,如果一开始就 COPY . .,任何源码改动都可能让后续依赖安装失去缓存价值。

区分构建阶段和运行阶段

最容易混淆的是 RUN 与 CMD。RUN 发生在 docker build 期间,例如安装软件、编译程序或创建目录;它的结果进入镜像。CMD 则只是镜像的默认启动配置,真正执行发生在 docker run 或编排系统启动容器时。

如果一个 Dockerfile 有多条 CMD,只有最后一条生效。需要在构建时执行多步准备,应使用合适的 RUN;需要定义容器默认启动程序,则保留一个清晰的 CMD 或 ENTRYPOINT。能把这两个阶段分清,就能避免“构建时为什么没启动服务”或“容器启动后为什么命令被覆盖”这类常见误判。

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

目录与阅读设置

阅读设置

17

记录一个想法

Dockerfile 的作用与结构

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

登录哪都通