容器与云原生 / 系统课时
Compose 怎样调用 Dockerfile
Compose 怎样调用 Dockerfile
当业务服务没有现成镜像时,Compose 可以读取 build 配置,把指定目录作为构建上下文,并用其中的 Dockerfile 生成镜像,再据此启动容器。本节用一个最小 Web 服务验证这条构建链路。
学习目标
- 理解
build.context、build.dockerfile与最终镜像之间的关系。 - 用 Compose 自动执行 Dockerfile 构建并启动服务。
- 识别构建上下文边界,避免
COPY路径与文件组织错误。
Compose 如何把配置交给镜像构建
build.context 决定哪些文件会进入构建上下文,build.dockerfile 指定要使用的 Dockerfile。Compose 根据这两个信息调用镜像构建器;构建完成后,再用生成的镜像创建服务容器。

如果省略 dockerfile,默认会在构建上下文中使用名为 Dockerfile 的构建文件;显式写出它更适合教学和存在多份 Dockerfile 的项目。
创建最小构建配置
项目根目录放置 compose.yaml,并在 web 目录中创建 Dockerfile。这个 Dockerfile 基于 Nginx 镜像写入一个固定首页,便于后续验证构建结果。
web/Dockerfile:
FROM nginx:alpine
RUN echo '<h1>compose build works</h1>' > /usr/share/nginx/html/index.html根目录的 compose.yaml:
services:
web:
build:
context: ./web
dockerfile: Dockerfile
image: demo-compose-web:local
ports:
- "8080:80"这里的 context: ./web 表示 web 目录是本次构建的上下文;dockerfile: Dockerfile 则指定使用该上下文中的 web/Dockerfile。image 给构建结果一个明确的本地镜像标签。
构建并启动服务
在 compose.yaml 所在目录执行下面的命令。--build 会在启动前执行必要的镜像构建,然后创建 web 容器。
docker compose up --build -d >/dev/null 2>&1
curl -s http://localhost:8080预期输出:
<h1>compose build works</h1>能读取到这段 HTML,说明 Dockerfile 已被 Compose 用于构建,构建出的镜像也已经成功启动并映射到宿主机 8080 端口。
构建上下文最容易出错的地方
Dockerfile 中的 COPY 和 ADD 只能读取构建上下文内的文件。若 context 是 ./web,就不能通过 COPY ../config.yml ... 从上下文之外读取项目根目录文件;应该调整目录结构,或把 context 提升到真正需要的公共根目录,并配合 .dockerignore 排除无关内容。
dockerfile 负责“选择哪份构建说明”,context 负责“构建时能看到哪些文件”。这两个路径职责不同,排查构建失败时应分别检查。
什么时候用 build,什么时候只写 image
开发环境经常需要源码变化后立即重建,因此 Compose 服务写 build 很方便;CI/CD 或生产环境则常直接引用已经构建并推送到镜像仓库的 image,让部署阶段只负责获取镜像和启动服务。
同一个服务可以同时写 build 与 image:前者描述如何构建,后者为构建结果指定镜像名。需要只构建不启动时可以使用 docker compose build web;需要启动前执行构建时,则使用 docker compose up --build。