容器与云原生 / 系统课时
合并多份 Compose 配置
合并多份 Compose 配置
本节解决开发、测试和生产环境存在少量配置差异时如何避免复制整份 Compose 文件的问题。你将把公共配置放在基础文件中,用后续文件覆盖差异,并检查 Compose 最终实际采用的配置。
学习目标
- 使用多个
-f参数按顺序合并 Compose 文件 - 理解常用标量和映射配置的覆盖行为
- 使用
docker compose config检查最终配置
按层表达环境差异
Compose 可以一次读取多份配置文件。前面的文件作为基础,后面的文件继续合并或覆盖已有内容,因此命令中的文件顺序具有实际意义。
适合放在基础文件中的通常是镜像、服务名和大部分公共参数;生产环境文件只保留真正不同的值。这样修改公共配置时,不必同步维护几份几乎相同的 YAML。
编写基础配置
把默认开发配置保存为 compose.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 因此会把它与基础文件中的同名服务合并,而不是创建第二个服务。
services:
web:
environment:
APP_ENV: production
LOG_LEVEL: info
restart: unless-stoppedimage 没有在覆盖文件中重新声明,所以继续沿用基础文件的 nginx:1.27-alpine。environment 是映射,后面的同名键覆盖前面的值;restart 这样的单值字段则采用后一个文件中的值。
检查最终合并结果
在真正启动生产服务前,先让 Compose 展开所有文件。-f 的顺序从基础配置到覆盖配置排列。
docker compose -f compose.yaml -f compose.prod.yaml config预期结果中的关键字段如下;不同 Compose 版本可能调整字段顺序或补充默认网络等内容。
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 的基础项目目录统一设计,不要假定每个覆盖文件都会以自身所在目录独立解析。保持基础文件与覆盖文件在同一项目目录中,通常最不容易产生环境差异。