容器与云原生 / 系统课时

Dockerfile 怎样定义一个镜像

Dockerfile 怎样定义一个镜像

Dockerfile 不是已经构建好的镜像,而是一份可重复执行的构建说明。你会用 FROM 选择基础环境,用 WORKDIR 确定后续操作目录,再用 COPY 把应用文件放进镜像,并通过一次实际构建验证结果。

学习目标

  • 理解 Dockerfile、构建上下文与镜像之间的关系。
  • 掌握 FROM、WORKDIR、COPY 的基本作用和执行顺序。
  • 能构建一个最小镜像并验证其中的文件与工作目录。

Dockerfile 描述的是构建过程

执行 docker build 时,Docker 会读取 Dockerfile,同时把指定目录作为构建上下文。Dockerfile 中的指令按顺序生效,最终得到包含文件系统内容和运行配置的镜像。

FROM 决定从什么基础镜像开始;WORKDIR 设置后续指令的默认目录;COPY 从构建上下文复制文件。COPY 不能任意读取上下文之外的文件,被 .dockerignore 排除的路径也不会进入构建上下文。

用三个核心指令组织镜像

在一个空目录中创建 hello.sh:

bash
#!/bin/sh
echo "hello from image"

再创建 Dockerfile:

dockerfile
FROM alpine:3.20
WORKDIR /app
COPY hello.sh .
CMD ["sh", "hello.sh"]

这里的 . 在 COPY hello.sh . 中表示当前 WORKDIR,因此脚本最终位于 /app/hello.sh。CMD 只是为了让这个示例构建后可以直接运行;镜像文件组织的关键仍是前三条指令。

构建镜像:

bash
docker build -q -t dockerfile-demo:1.0 .

预期输出

text
sha256:<ID>

<ID> 是实际生成的镜像 ID,每次环境不同都可能变化。

运行容器并检查默认工作目录:

bash
docker run --rm dockerfile-demo:1.0
docker run --rm dockerfile-demo:1.0 pwd

预期输出

text
hello from image
/app

第二条命令用 pwd 覆盖了镜像的默认启动命令,但工作目录仍然是 /app,说明 WORKDIR 会进入镜像配置并影响容器运行时的默认目录。

指令顺序会影响结果与缓存

Dockerfile 是顺序执行的。只有先声明 WORKDIR /app,后面的相对目标路径 . 才表示 /app。同理,COPY 的源路径相对于构建上下文,而不是相对于 Dockerfile 在文件系统中的任意位置。

在真实项目中,应把变化较少的依赖描述文件放在较前的位置,把频繁变化的源码放在较后的位置,这样更容易复用构建缓存。不要为了“少写一行”牺牲指令含义的清晰度。

构建前检查三个边界

遇到 COPY 找不到文件或镜像内容不符合预期时,先检查:构建命令最后的上下文路径是否正确、源文件是否被 .dockerignore 排除、相对路径是否建立在预期的 WORKDIR 上。

Dockerfile 的核心价值是把镜像制作过程写成可审查、可重复的文本。只要构建上下文和指令顺序稳定,同一份 Dockerfile 就能持续产出结构一致的应用镜像。

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

目录与阅读设置

阅读设置

17

记录一个想法

Dockerfile 怎样定义一个镜像

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

登录哪都通