容器与云原生 / 系统课时
Dockerfile 怎样定义一个镜像
Dockerfile 怎样定义一个镜像
Dockerfile 不是已经构建好的镜像,而是一份可重复执行的构建说明。你会用 FROM 选择基础环境,用 WORKDIR 确定后续操作目录,再用 COPY 把应用文件放进镜像,并通过一次实际构建验证结果。
学习目标
- 理解 Dockerfile、构建上下文与镜像之间的关系。
- 掌握
FROM、WORKDIR、COPY的基本作用和执行顺序。 - 能构建一个最小镜像并验证其中的文件与工作目录。
Dockerfile 描述的是构建过程
执行 docker build 时,Docker 会读取 Dockerfile,同时把指定目录作为构建上下文。Dockerfile 中的指令按顺序生效,最终得到包含文件系统内容和运行配置的镜像。
FROM 决定从什么基础镜像开始;WORKDIR 设置后续指令的默认目录;COPY 从构建上下文复制文件。COPY 不能任意读取上下文之外的文件,被 .dockerignore 排除的路径也不会进入构建上下文。
用三个核心指令组织镜像
在一个空目录中创建 hello.sh:
#!/bin/sh
echo "hello from image"再创建 Dockerfile:
FROM alpine:3.20
WORKDIR /app
COPY hello.sh .
CMD ["sh", "hello.sh"]这里的 . 在 COPY hello.sh . 中表示当前 WORKDIR,因此脚本最终位于 /app/hello.sh。CMD 只是为了让这个示例构建后可以直接运行;镜像文件组织的关键仍是前三条指令。
构建镜像:
docker build -q -t dockerfile-demo:1.0 .预期输出
sha256:<ID><ID> 是实际生成的镜像 ID,每次环境不同都可能变化。
运行容器并检查默认工作目录:
docker run --rm dockerfile-demo:1.0
docker run --rm dockerfile-demo:1.0 pwd预期输出
hello from image
/app第二条命令用 pwd 覆盖了镜像的默认启动命令,但工作目录仍然是 /app,说明 WORKDIR 会进入镜像配置并影响容器运行时的默认目录。
指令顺序会影响结果与缓存
Dockerfile 是顺序执行的。只有先声明 WORKDIR /app,后面的相对目标路径 . 才表示 /app。同理,COPY 的源路径相对于构建上下文,而不是相对于 Dockerfile 在文件系统中的任意位置。
在真实项目中,应把变化较少的依赖描述文件放在较前的位置,把频繁变化的源码放在较后的位置,这样更容易复用构建缓存。不要为了“少写一行”牺牲指令含义的清晰度。
构建前检查三个边界
遇到 COPY 找不到文件或镜像内容不符合预期时,先检查:构建命令最后的上下文路径是否正确、源文件是否被 .dockerignore 排除、相对路径是否建立在预期的 WORKDIR 上。
Dockerfile 的核心价值是把镜像制作过程写成可审查、可重复的文本。只要构建上下文和指令顺序稳定,同一份 Dockerfile 就能持续产出结构一致的应用镜像。