容器与云原生 / 系统课时
编写基础 Dockerfile
编写基础 Dockerfile
本课将从一个最小可用示例出发,编写能够复制文件、执行构建步骤并启动应用的 Dockerfile。完成后,你可以构建镜像、运行容器,并通过输出确认镜像中的工作目录、文件和启动命令都已生效。
学习目标
- 掌握
FROM、WORKDIR、COPY、RUN和CMD的基本用途 - 能够编写并构建一个最小 Dockerfile
- 能够运行容器并验证镜像内容
Dockerfile 的最小结构
Dockerfile 是按顺序执行的构建说明。下面以一个静态文本应用为例:基础镜像提供 Linux 环境,WORKDIR 设置后续命令的默认目录,COPY 把本地文件放入镜像,RUN 在构建阶段生成文件,CMD 定义容器启动时执行的默认命令。
先创建 message.txt,内容为 Hello from Docker,再在同一目录创建 Dockerfile:
FROM alpine:3.21
WORKDIR /app
COPY message.txt ./message.txt
# RUN 在构建镜像时执行,结果会写入新的镜像层
RUN printf 'Image built successfully\n' > build-info.txt
# CMD 在容器启动时执行,通常只保留一个
CMD ["sh", "-c", "cat message.txt && cat build-info.txt"]这里使用 JSON 数组形式的 CMD,可以减少额外的 Shell 解析问题。COPY 的源路径相对于构建上下文,而不是相对于 Dockerfile 所在目录之外的任意位置。
构建镜像
在 Dockerfile 所在目录执行:
docker build -t dockerfile-demo:1.0 .预期输出:
[+] Building <TIME> FINISHED
=> [internal] load build definition from Dockerfile
=> [1/<N>] FROM docker.io/library/alpine:3.21
=> [<N>/<N>] RUN printf 'Image built successfully\n' > build-info.txt
=> exporting to image<TIME>、<N> 和步骤编号可能因 Docker 版本及缓存状态不同而变化。命令末尾的 . 表示当前目录是构建上下文,Docker 只能读取该目录及其子目录中的文件。
运行并验证
启动一次性容器并在执行结束后自动删除:
docker run --rm dockerfile-demo:1.0预期输出:
Hello from Docker
Image built successfully如果需要确认镜像中的工作目录,可以覆盖默认启动命令:
docker run --rm dockerfile-demo:1.0 pwd预期输出:
/app理解构建阶段与运行阶段
RUN 只在 docker build 期间执行,适合安装软件、编译程序或生成固定文件。CMD 在 docker run 时执行,适合启动应用。把启动服务写进 RUN 不会让服务在容器运行时自动启动。
Docker 会按指令生成并缓存镜像层。通常应先复制变化较少的依赖清单并安装依赖,再复制频繁变化的业务代码,这样修改代码后可以复用前面的缓存层。
常见错误
COPY failed:确认源文件位于构建上下文中,并检查文件名大小写- 找不到 Dockerfile:确认文件名为
Dockerfile,或使用docker build -f <PATH> . - 容器立即退出:检查
CMD启动的是否为前台进程,以及命令是否执行成功 - 修改文件后结果未变化:重新构建镜像,并确认运行的是新标签
本课总结
- Dockerfile 按顺序描述镜像来源、工作目录、文件复制、构建动作和默认启动命令
RUN发生在构建阶段,CMD发生在容器运行阶段- 构建后必须通过
docker run验证实际输出,而不能只看构建成功
下一课预告
下一课将学习如何根据运行依赖、镜像体积、安全更新和版本稳定性选择合适的基础镜像。