容器与云原生 / 系统课时

多份 Compose 文件怎样组合

多份 Compose 文件怎样组合

当基础服务结构相同、只有开发或生产参数不同时,不必复制整份 Compose。可以把公共定义放在基础文件,再按顺序叠加环境文件。关键不是“加载了几份 YAML”,而是理解后面的文件怎样覆盖、补充前面的配置,以及最终到底生成了什么部署模型。

学习目标

  • 使用多个 -f 参数按顺序组合 Compose 文件。
  • 理解常见标量、映射和列表在合并时的基本行为。
  • 用 docker compose config 检查最终生效配置,而不是只阅读源文件。

组合的核心是有顺序的合并

Compose 会按照命令行中 -f 的出现顺序处理文件:前面的文件先成为基础,后面的文件再补充或覆盖它。也就是说,compose.prod.yaml 放在第二个位置时,适合只写生产环境真正不同的值。官方文档明确说明,多文件合并按给定顺序进行,后续文件会覆盖或增加前面的配置。([Docker Documentation][2])

多份 Compose 文件按顺序合并为最终配置

最常见的命令形式是:

bash
docker compose -f compose.yaml -f compose.prod.yaml config --images

这里第二个文件优先级更高。若调换两个 -f 的顺序,覆盖方向也会反过来。

看一个最小合并示例

基础文件保存所有环境都需要的定义:

yaml
# compose.yaml
services:
  web:
    image: nginx:stable-alpine
    environment:
      APP_MODE: base
      LOG_LEVEL: debug
    volumes:
      - ./site:/usr/share/nginx/html:ro

生产文件只写差异:

yaml
# compose.prod.yaml
services:
  web:
    image: nginx:1.28-alpine
    environment:
      APP_MODE: production
      LOG_LEVEL: info
    restart: unless-stopped

执行前面的命令后,镜像字段采用后一个文件的值。

预期输出:

text
nginx:1.28-alpine

最终模型仍保留基础文件中的 volumes,同时新增 restart;environment 作为映射合并,其中同名键由后面的文件覆盖。docker compose config 会解析多份文件、变量和简写语法,适合在真正 up 之前查看最终模型。([Docker Documentation][3])

不要把所有字段都理解成简单替换

Compose 的合并规则并非所有字段都“后者整块覆盖前者”。标量通常由后面的值替换,映射会按键合并;序列通常会合并,但端口、卷等字段还有更具体的规则。例如卷会依据容器内的挂载目标处理冲突,而端口也有自己的唯一性判断。需要清空或完全替换某些已有集合时,应按当前 Compose 规范使用相应覆盖机制,而不是猜测 YAML 会怎样合并。([Docker Documentation][4])

因此,环境覆盖文件最好保持小而明确:只声明确实需要变化的项。文件越像完整复制品,越容易在基础配置更新后产生漂移。

路径和默认文件名最容易踩坑

多文件合并时,相对路径不是相对于每个覆盖文件各自的位置解析,而是以第一个 Compose 文件的项目目录为基准;这也是把基础文件放在项目根目录通常更容易维护的原因。官方文档也建议用 docker compose config 检查合并后的路径与模型。([Docker Documentation][2])

如果不显式写 -f,Compose 会寻找默认的 compose.yaml,并可自动叠加同目录中的 compose.override.yaml。当文件名是 compose.prod.yaml、compose.ci.yaml 这类自定义名称时,显式写出多个 -f 更清楚,也能让部署脚本准确表达环境选择。([Docker Documentation][2])

部署前应把“源文件长什么样”与“最终模型是什么”分开看:源文件服务于维护,docker compose config 展示的合并结果才是 Compose 真正准备应用的配置。

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

目录与阅读设置

阅读设置

17

记录一个想法

多份 Compose 文件怎样组合

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

登录哪都通