容器与云原生 / 系统课时

depends_on 到底保证什么

depends_on 到底保证什么

depends_on 能表达服务之间的启动依赖,但“数据库容器已经启动”不等于“数据库已经能接受连接”。理解启动与就绪的区别,才能避免应用一启动就报连接失败,也能知道什么时候必须配合 healthcheck。

学习目标

  • 说清短语法 depends_on 实际保证的启动顺序。
  • 使用 healthcheck 与 condition: service_healthy 等待依赖真正就绪。
  • 根据初始化任务、数据库和普通服务选择合适的依赖条件。

短语法只保证依赖先启动

短语法只列服务名,例如 app 依赖 db。Compose 会先创建并启动依赖服务,再启动下游服务;但它不会因为 db 进程还在执行初始化就自动等待到“可以接收业务请求”。官方 Compose 规范明确区分了 service_started 与 service_healthy。([Docker Documentation][3])

depends_on 启动与就绪差异

这也是为什么仅增加 depends_on: [db] 不能可靠修复启动竞争:它改变的是顺序,不是数据库内部初始化速度。

用 healthcheck 表达真正的就绪条件

下面用 Redis 演示完整配置。redis-cli ping 返回成功后,Redis 才会被标记为 healthy,app 的启动条件才满足。Compose 对标记为 service_healthy 的依赖会等待其健康检查通过。([Docker Documentation][4])

yaml
services:
  cache:
    image: redis:7.4-alpine
    healthcheck:
      test:
        - CMD
        - redis-cli
        - ping
      interval: 2s
      timeout: 1s
      retries: 10
      start_period: 2s

  app:
    image: redis:7.4-alpine
    depends_on:
      cache:
        condition: service_healthy
    command:
      - redis-cli
      - -h
      - cache
      - ping

在包含该 compose.yaml 的目录执行:

bash
docker compose run --rm app 2>/dev/null

预期输出

text
PONG

如果健康检查一直失败,依赖条件就不会满足;此时应该修正健康检查或服务本身,而不是简单延长一个固定 sleep。健康检查应验证“下游真正需要的能力”,例如数据库能建立连接、HTTP 服务能返回可接受状态,而不只是进程存在。

三种 condition 对应三类依赖

条件 何时满足 典型场景
service_started 依赖服务已启动 无需等待业务就绪的普通服务
service_healthy healthcheck 通过 数据库、缓存、HTTP API
service_completed_successfully 一次性依赖任务成功退出 数据迁移、初始化任务

service_started 与短语法语义相同;service_completed_successfully 则适合“先跑完一个任务,再启动应用”的链路。([Docker Documentation][3])

启动顺序不能替代运行时容错

即使启动阶段已经等到依赖健康,下游服务仍要处理依赖在运行过程中重启、断网或短暂不可用的情况。因此应用连接数据库、缓存或外部 API 时仍应有合理的超时与重试策略。

把 depends_on 看成“启动阶段的编排规则”更准确:短语法解决谁先启动,service_healthy 解决何时算就绪,而运行期间的故障恢复仍属于应用自身和容器运行策略的职责。

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

目录与阅读设置

阅读设置

17

记录一个想法

depends_on 到底保证什么

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

登录哪都通