容器与云原生 / 系统课时

Compose 怎样调用 Dockerfile

Compose 怎样调用 Dockerfile

当业务服务没有现成镜像时,Compose 可以读取 build 配置,把指定目录作为构建上下文,并用其中的 Dockerfile 生成镜像,再据此启动容器。本节用一个最小 Web 服务验证这条构建链路。

学习目标

  • 理解 build.context、build.dockerfile 与最终镜像之间的关系。
  • 用 Compose 自动执行 Dockerfile 构建并启动服务。
  • 识别构建上下文边界,避免 COPY 路径与文件组织错误。

Compose 如何把配置交给镜像构建

build.context 决定哪些文件会进入构建上下文,build.dockerfile 指定要使用的 Dockerfile。Compose 根据这两个信息调用镜像构建器;构建完成后,再用生成的镜像创建服务容器。

Compose 调用 Dockerfile 的构建链路

如果省略 dockerfile,默认会在构建上下文中使用名为 Dockerfile 的构建文件;显式写出它更适合教学和存在多份 Dockerfile 的项目。

创建最小构建配置

项目根目录放置 compose.yaml,并在 web 目录中创建 Dockerfile。这个 Dockerfile 基于 Nginx 镜像写入一个固定首页,便于后续验证构建结果。

web/Dockerfile:

dockerfile
FROM nginx:alpine

RUN echo '<h1>compose build works</h1>' > /usr/share/nginx/html/index.html

根目录的 compose.yaml:

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 容器。

bash
docker compose up --build -d >/dev/null 2>&1
curl -s http://localhost:8080

预期输出:

text
<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。

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

目录与阅读设置

阅读设置

17

记录一个想法

Compose 怎样调用 Dockerfile

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

登录哪都通