容器与云原生 / 系统课时
编排服务依赖
编排服务依赖
Compose 可以按照服务依赖关系控制创建与启动顺序,但“容器已经启动”并不代表应用已经可以接收请求。本节用 depends_on 配合健康检查,让依赖方在基础服务真正就绪后再启动,并验证这一行为。
学习目标
- 理解服务启动顺序与应用就绪状态的区别
- 使用
healthcheck和service_healthy表达就绪依赖 - 验证依赖服务健康后下游服务才开始运行
区分启动顺序和服务就绪
短格式 depends_on 可以声明服务之间的依赖。Compose 会优先创建依赖服务,再创建依赖它的服务,但默认只等待依赖容器进入启动状态,并不知道数据库、缓存或消息队列是否已经完成初始化。
例如数据库进程可能已经存在,却还在执行恢复或加载数据。此时应用立即建立连接,就可能出现 connection refused、初始化失败等偶发问题。

用健康检查表达就绪条件
下面的配置让 Redis 提供健康检查,并让 worker 使用长格式 depends_on 等待 cache 进入 healthy。示例中的 worker 同样使用 Redis 镜像,只为了提供可直接运行的 redis-cli 验证环境。
services:
cache:
image: redis:7-alpine
healthcheck:
test: [CMD, redis-cli, ping]
interval: 2s
timeout: 1s
retries: 10
start_period: 2s
worker:
image: redis:7-alpine
depends_on:
cache:
condition: service_healthy
command: >
sh -c 'redis-cli -h cache ping >/dev/null && tail -f /dev/null'test 决定容器内部如何判断服务是否可用;只有检查连续达到成功条件后,容器才会变为 healthy。start_period 可以给启动较慢的服务预留初始化时间,避免初始化阶段过早累计失败次数。
启动并验证依赖
将配置保存为当前目录的 compose.yaml,执行下面的命令。前两条命令的普通启动信息被隐藏,最后通过 worker 访问 cache 验证依赖服务已经可用。
docker compose config --quiet &&
docker compose up -d >/dev/null 2>&1 &&
docker compose exec worker redis-cli -h cache ping预期输出:
PONG如果配置有语法错误、cache 无法通过健康检查或 worker 启动失败,命令链会在对应步骤停止,不会得到 PONG。
处理依赖关系的边界
service_healthy 解决的是启动阶段的就绪等待,不能代替应用自身的重试与容错。运行过程中如果 cache 后来变为 unhealthy,Compose 不会仅因为这个健康状态变化就自动重启所有依赖它的服务。
对于数据库、缓存和消息队列,应优先使用它们自身提供的探活命令,并让业务程序同时保留连接重试、超时和错误处理。这样既能减少 Compose 启动阶段的竞态,也能覆盖服务运行后的短暂故障。