容器与云原生 / 系统课时

使用 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 查看最终结果,再确认实际启动的服务列表。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 Profiles 与覆盖文件

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

登录哪都通