容器与云原生 / 系统课时
使用 Profiles 与覆盖文件
使用 Profiles 与覆盖文件
本课学习如何通过 Docker Compose Profiles 和多个 Compose 文件控制服务组合,让调试工具、测试依赖和生产服务按需启动,避免维护多套完全独立的编排文件。
学习目标
- 理解 Profiles 如何控制服务启停范围。
- 掌握多个 Compose 文件合并覆盖的规则。
- 能够设计适用于不同环境的 Compose 组织方式。
使用 Profiles 管理可选服务
在实际项目中,并不是所有服务都需要默认启动。例如开发时可能需要数据库管理工具、调试容器或测试依赖,但生产环境不应该运行这些服务。
Compose Profiles 可以给服务添加标签,只有启用对应 Profile 时服务才会参与启动。
yaml
services:
api:
image: example/api:<TAG>
adminer:
image: adminer
profiles:
- debug预期结果
text
默认执行 docker compose up 时只启动 api。
启用 debug Profile 后,adminer 服务才会启动。启动指定 Profile:
bash
docker compose --profile debug up预期结果
text
api 和 adminer 服务同时启动。使用覆盖文件区分环境
Compose 支持通过多个文件组合配置。默认读取 compose.yaml,额外文件可以通过 -f 指定。
常见模式是基础文件保存通用配置,覆盖文件保存环境差异。
bash
docker compose -f compose.yaml -f compose.dev.yaml up预期结果
text
Compose 合并两个文件后的配置启动服务。例如开发环境增加调试端口:
yaml
services:
api:
ports:
- "<PORT>:8080"预期结果
text
开发环境额外暴露调试访问端口。理解覆盖合并规则
多个 Compose 文件合并时,后加载的文件会覆盖前面的同名配置。简单键值通常直接替换,列表字段根据配置类型进行合并或替换。
排查合并结果时,不要只查看单个文件,应查看最终解析结果。
bash
docker compose -f compose.yaml -f compose.dev.yaml config预期结果
text
输出合并后的完整 Compose 配置。设计开发与生产结构
一个常见结构如下:
text
project/
├── compose.yaml
├── compose.dev.yaml
├── compose.test.yaml
└── config/
└── app.env预期结果
text
基础服务集中维护,环境差异通过覆盖文件隔离。设计时应避免复制整个 Compose 文件。重复配置越多,后续升级镜像、网络和资源限制时越容易产生环境漂移。
常见使用错误
如果 Profile 名称拼写错误,目标服务不会被启动;如果覆盖文件顺序错误,可能导致生产配置被开发配置覆盖。
排查时可以先使用 docker compose config 查看最终结果,再确认实际启动的服务列表。
按自己的节奏,确认真正理解。