容器与云原生 / 系统课时

编写基础 Dockerfile

编写基础 Dockerfile

本课将从一个最小可用示例出发,编写能够复制文件、执行构建步骤并启动应用的 Dockerfile。完成后,你可以构建镜像、运行容器,并通过输出确认镜像中的工作目录、文件和启动命令都已生效。

学习目标

  • 掌握 FROM、WORKDIR、COPY、RUN 和 CMD 的基本用途
  • 能够编写并构建一个最小 Dockerfile
  • 能够运行容器并验证镜像内容

Dockerfile 的最小结构

Dockerfile 是按顺序执行的构建说明。下面以一个静态文本应用为例:基础镜像提供 Linux 环境,WORKDIR 设置后续命令的默认目录,COPY 把本地文件放入镜像,RUN 在构建阶段生成文件,CMD 定义容器启动时执行的默认命令。

先创建 message.txt,内容为 Hello from Docker,再在同一目录创建 Dockerfile:

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 所在目录执行:

bash
docker build -t dockerfile-demo:1.0 .

预期输出:

text
[+] 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 只能读取该目录及其子目录中的文件。

运行并验证

启动一次性容器并在执行结束后自动删除:

bash
docker run --rm dockerfile-demo:1.0

预期输出:

text
Hello from Docker
Image built successfully

如果需要确认镜像中的工作目录,可以覆盖默认启动命令:

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

预期输出:

text
/app

理解构建阶段与运行阶段

RUN 只在 docker build 期间执行,适合安装软件、编译程序或生成固定文件。CMD 在 docker run 时执行,适合启动应用。把启动服务写进 RUN 不会让服务在容器运行时自动启动。

Docker 会按指令生成并缓存镜像层。通常应先复制变化较少的依赖清单并安装依赖,再复制频繁变化的业务代码,这样修改代码后可以复用前面的缓存层。

常见错误

  • COPY failed:确认源文件位于构建上下文中,并检查文件名大小写
  • 找不到 Dockerfile:确认文件名为 Dockerfile,或使用 docker build -f <PATH> .
  • 容器立即退出:检查 CMD 启动的是否为前台进程,以及命令是否执行成功
  • 修改文件后结果未变化:重新构建镜像,并确认运行的是新标签

本课总结

  • Dockerfile 按顺序描述镜像来源、工作目录、文件复制、构建动作和默认启动命令
  • RUN 发生在构建阶段,CMD 发生在容器运行阶段
  • 构建后必须通过 docker run 验证实际输出,而不能只看构建成功

下一课预告

下一课将学习如何根据运行依赖、镜像体积、安全更新和版本稳定性选择合适的基础镜像。

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

目录与阅读设置

阅读设置

17

记录一个想法

编写基础 Dockerfile

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

登录哪都通