容器与云原生 / 系统课时
编排多服务依赖
编排多服务依赖
本课解决 Docker Compose 中多个服务启动先后与真正可用状态不一致的问题。通过 depends_on、healthcheck 和应用侧重试,让数据库、缓存等基础服务就绪后,应用能够稳定启动。
学习目标
- 理解 depends_on 只能控制启动顺序,不能保证服务已可用。
- 掌握 healthcheck 与条件依赖的配置方式。
- 为应用增加连接失败后的重试策略。
理解启动顺序与就绪状态
在多服务系统中,容器启动成功不代表服务已经准备完成。例如数据库容器可能已经运行,但还在初始化表结构。应用如果立即连接数据库,可能出现首次启动失败。
depends_on 解决的是容器创建和启动顺序问题,而 healthcheck 用于描述服务是否达到可用状态。两者结合后,Compose 才能按照健康状态组织依赖关系。

配置健康检查依赖
下面示例包含一个应用服务和一个数据库服务。数据库通过健康检查确认可以接受连接,应用依赖数据库健康状态后再启动。
yaml
services:
db:
image: postgres:16
environment:
POSTGRES_PASSWORD: example
healthcheck:
test: ["CMD-SHELL", "pg_isready -U postgres"]
interval: 5s
timeout: 3s
retries: 5
app:
image: my-app:latest
depends_on:
db:
condition: service_healthy预期结果
text
[+] Running 2/2
✔ Container db Healthy
✔ Container app Started实际项目中应根据服务特点设计健康检查。例如数据库检查连接能力,HTTP 服务检查健康接口,消息队列检查端口或管理接口。
增加应用连接重试
即使 Compose 配置正确,运行中的网络变化、服务重启和临时故障仍可能导致连接失败。因此应用自身也需要重试逻辑。
python
import time
for attempt in range(5):
try:
connect_database()
print("database connected")
break
except Exception:
if attempt == 4:
raise
time.sleep(3)预期输出
text
database connected重试策略应设置最大次数和等待时间,避免服务异常时无限占用资源。生产环境通常还会结合指数退避和日志记录。
常见错误
只配置 depends_on 后认为应用一定能连接成功,是最常见的问题。正确做法是同时考虑容器启动顺序、服务健康状态和运行期间故障恢复。
按自己的节奏,确认真正理解。