当前位置：首页 > backend >正文

Compose 高级用法详解——AI教你学Docker

backend 2025/7/5 8:27:13

3.6 Compose 高级用法详解

Docker Compose 除了常规的多服务编排，还支持一系列高级功能，如服务健康依赖、环境切换、配置模板化等。掌握这些技巧，能让你的多容器项目更健壮、更自动化、更易维护。

一、depends_on 的高级用法与启动顺序

1. 基本用法

depends_on 指定服务间的启动顺序，确保依赖的服务优先启动。
```
services:web:depends_on:- dbdb:image: postgres
```
启动时会先启动 db，再启动 web。

2. 高级用法（条件依赖，Compose v3.4+）

仅控制“启动顺序”，不保证被依赖服务已就绪（如数据库完全可用）。

高级写法可以指定健康检查条件（condition 字段，v2 语法，Compose v3 推荐结合 healthcheck）。

services:web:depends_on:db:condition: service_healthydb:image: postgreshealthcheck:test: ["CMD", "pg_isready", "-U", "postgres"]interval: 10sretries: 5

效果：web 服务仅在 db 的健康检查通过（状态为 healthy）后启动。

3. 实践建议

复杂依赖场景要用 healthcheck 配合 depends_on，避免业务服务因依赖服务未就绪而频繁重启。
生产环境建议应用端实现重试/等待逻辑，Compose 启动顺序仅作辅助。

二、healthcheck 结合 restart 策略

1. healthcheck 作用

定期检测服务是否健康。

如果检测失败，会将服务状态标记为“unhealthy”。

healthcheck:test: ["CMD", "curl", "-f", "http://localhost:80"]interval: 30stimeout: 5sretries: 3start_period: 10s

test 可为命令行数组或 shell 命令。

2. restart 策略

控制服务异常退出时的自动重启行为：

策略说明
no（默认）不自动重启
always 任何情况下都重启
unless-stopped 除非被手动 stop，否则一直重启
on-failure 非 0 状态码退出时重启，可指定最大次数
```
restart: on-failure:5
```

策略	说明
no（默认）	不自动重启
always	任何情况下都重启
unless-stopped	除非被手动 stop，否则一直重启
on-failure	非 0 状态码退出时重启，可指定最大次数

3. healthcheck 与 restart 配合

healthcheck 失败只会将容器标记为 unhealthy，不会自动重启容器。
若需自动重启，可通过外部监控、Swarm/K8s 等更高级平台实现。
推荐用 healthcheck + depends_on: condition，实现依赖就绪后再启动关联服务。
对于“僵死”服务，通过 healthcheck 发现后，人工或自动化脚本可重启。

三、多环境配置（开发/测试/生产）

1. 多 Compose 文件覆盖

基础文件：docker-compose.yml
覆盖文件：docker-compose.override.yml（自动加载）、docker-compose.dev.yml、docker-compose.prod.yml 等

启动时合并多个文件，后面的配置会覆盖前面的同名字段：

# 开发环境
docker compose -f docker-compose.yml -f docker-compose.override.yml up -d# 生产环境
docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d

2. 环境变量与 .env 文件

用 .env 文件存储通用或敏感配置（如数据库密码、API Key），不同环境用不同的 .env 文件。
在 CI/CD、生产部署时注入环境变量，避免敏感信息写死。
支持 ${VAR_NAME} 占位符动态引用变量。

3. 配置差异管理建议

通用配置写在主 compose 文件，环境相关或敏感配置用覆盖文件和变量注入实现。
生产、开发、测试环境分别维护独立的 yml 或 env 文件。

四、Compose 文件模板化（扩展 Compose、环境占位符）

1. 环境变量占位符

在 compose 文件中用 ${VAR_NAME} 动态替换内容，适合端口、密码、路径等参数化。
```
services:db:image: postgres:${PG_VERSION}environment:- POSTGRES_PASSWORD=${DB_PASSWORD}
```
变量来源优先级：命令行 -e > yaml environment 字段 > env_file > .env 文件。

2. 扩展与继承（YAML anchors）

通过 YAML 的锚点（anchor）和别名（alias）简化重复配置（Compose v3+ 支持）

x-defaults: &defaultsrestart: alwayslogging:driver: "json-file"options:max-size: "10m"services:web:<<: *defaultsimage: mywebapi:<<: *defaultsimage: myapi