容器与云原生 / 系统课时

合并多份 Compose 配置

合并多份 Compose 配置

本节解决开发、测试和生产环境存在少量配置差异时如何避免复制整份 Compose 文件的问题。你将把公共配置放在基础文件中,用后续文件覆盖差异,并检查 Compose 最终实际采用的配置。

学习目标

  • 使用多个 -f 参数按顺序合并 Compose 文件
  • 理解常用标量和映射配置的覆盖行为
  • 使用 docker compose config 检查最终配置

按层表达环境差异

Compose 可以一次读取多份配置文件。前面的文件作为基础,后面的文件继续合并或覆盖已有内容,因此命令中的文件顺序具有实际意义。

适合放在基础文件中的通常是镜像、服务名和大部分公共参数;生产环境文件只保留真正不同的值。这样修改公共配置时,不必同步维护几份几乎相同的 YAML。

编写基础配置

把默认开发配置保存为 compose.yaml。下面是一份完整的单服务配置,其中环境变量和重启策略都可以被后续文件调整。

yaml
services:
  web:
    image: nginx:1.27-alpine
    environment:
      APP_ENV: development
      LOG_LEVEL: debug
    restart: "no"

单独运行 docker compose up 时,只读取这份配置,因此 APP_ENV 为 development,日志级别为 debug。

添加生产覆盖配置

再创建 compose.prod.yaml,只声明生产环境需要变化的字段。服务仍然叫 web,Compose 因此会把它与基础文件中的同名服务合并,而不是创建第二个服务。

yaml
services:
  web:
    environment:
      APP_ENV: production
      LOG_LEVEL: info
    restart: unless-stopped

image 没有在覆盖文件中重新声明,所以继续沿用基础文件的 nginx:1.27-alpine。environment 是映射,后面的同名键覆盖前面的值;restart 这样的单值字段则采用后一个文件中的值。

检查最终合并结果

在真正启动生产服务前,先让 Compose 展开所有文件。-f 的顺序从基础配置到覆盖配置排列。

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

预期结果中的关键字段如下;不同 Compose 版本可能调整字段顺序或补充默认网络等内容。

yaml
services:
  web:
    environment:
      APP_ENV: production
      LOG_LEVEL: info
    image: nginx:1.27-alpine
    restart: unless-stopped

这说明公共的 image 被保留,而生产文件中的环境变量和重启策略已经覆盖默认值。确认结果无误后,启动时使用相同的 -f 顺序即可。

避免把所有字段都当成简单覆盖

不要假设所有列表字段都遵循“后一个文件整体替换前一个文件”的规则。Compose 对端口、数据卷、配置和部分序列字段存在专门的合并规则,同一目标位置还可能触发替换或去重行为。

因此,只要覆盖文件涉及 ports、volumes 等集合配置,就应把 docker compose config 的展开结果视为启动前的最终依据,而不是只凭肉眼比较两份 YAML。

另一个容易忽略的边界是相对路径。多文件组合时,绑定挂载和其他相对路径应围绕 Compose 的基础项目目录统一设计,不要假定每个覆盖文件都会以自身所在目录独立解析。保持基础文件与覆盖文件在同一项目目录中,通常最不容易产生环境差异。

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

目录与阅读设置

阅读设置

17

记录一个想法

合并多份 Compose 配置

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

登录哪都通