容器与云原生 / 系统课时

编排多服务依赖

编排多服务依赖

本课解决 Docker Compose 中多个服务启动先后与真正可用状态不一致的问题。通过 depends_on、healthcheck 和应用侧重试,让数据库、缓存等基础服务就绪后,应用能够稳定启动。

学习目标

  • 理解 depends_on 只能控制启动顺序,不能保证服务已可用。
  • 掌握 healthcheck 与条件依赖的配置方式。
  • 为应用增加连接失败后的重试策略。

理解启动顺序与就绪状态

在多服务系统中,容器启动成功不代表服务已经准备完成。例如数据库容器可能已经运行,但还在初始化表结构。应用如果立即连接数据库,可能出现首次启动失败。

depends_on 解决的是容器创建和启动顺序问题,而 healthcheck 用于描述服务是否达到可用状态。两者结合后,Compose 才能按照健康状态组织依赖关系。

Docker 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 后认为应用一定能连接成功,是最常见的问题。正确做法是同时考虑容器启动顺序、服务健康状态和运行期间故障恢复。

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

目录与阅读设置

阅读设置

17

记录一个想法

编排多服务依赖

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

登录哪都通