无需使用depends_on，让docker-compose阻塞至服务健康的方法

我们团队开发主服务器代码时，不会用Docker运行主服务，仅通过docker-compose启动各类辅助服务（如数据库、缓存等）。之前靠大量自定义代码检测这些辅助服务的健康状态，现在想改用docker-compose原生的healthcheck功能，但发现只有在配置depends_on: ... condition: service_healthy时，docker-compose才会阻塞等待服务就绪。

目前的临时方案是添加一个hello-world dummy服务，让它依赖所有辅助服务的健康状态，配置如下：

helper1:
  ...
  healthcheck:
    test: ["CMD", "curl", "-f", "http://helper1:1234/ready"]
    interval: 10s
    timeout: 5s
    retries: 5
helper2:
  ...
  healthcheck:
    test: ["CMD", "curl", "-f", "http://helper2:5678/health"]
    interval: 10s
    timeout: 5s
    retries: 5
hello-world:
  image: docker.io/library/hello-world
  depends_on:
    helper1:
      condition: service_healthy
    helper2:
      condition: service_healthy

但这种借助dummy服务的方式不够优雅，请问有没有其他方法能让docker-compose命令阻塞至所有辅助服务健康？

方案1：使用Docker Compose内置的--wait参数（推荐） #

从Docker Compose v2.10.0开始，docker-compose up命令新增了--wait参数，它会自动等待所有配置了healthcheck的服务进入健康状态后才退出，完全不需要额外的dummy服务。

使用方式很简单：

docker-compose up --wait

这个命令会启动所有服务，然后持续检查每个服务的健康状态，直到全部符合健康条件后退出。如果超时（默认等待300秒）还未全部健康，会返回非零退出码。

你可以通过--wait-timeout参数自定义超时时间，比如设置为120秒：

docker-compose up --wait --wait-timeout 120

方案2：编写简单的Shell脚本手动检查（兼容旧版本） #

如果你的Docker Compose版本低于v2.10.0，可以写一个小脚本循环检查所有服务的健康状态：

#!/bin/bash

# 定义要检查的服务列表
SERVICES=("helper1" "helper2")

# 循环检查每个服务的健康状态
while true; do
  ALL_HEALTHY=true
  for SERVICE in "${SERVICES[@]}"; do
    HEALTH_STATUS=$(docker-compose inspect --format '{{.State.Health.Status}}' "$SERVICE")
    if [ "$HEALTH_STATUS" != "healthy" ]; then
      ALL_HEALTHY=false
      echo "Service $SERVICE is not healthy yet (status: $HEALTH_STATUS)"
      break
    fi
  done

  if $ALL_HEALTHY; then
    echo "All services are healthy!"
    exit 0
  fi

  # 每5秒检查一次
  sleep 5
done

把脚本保存为wait-for-services.sh，赋予执行权限后运行：

chmod +x wait-for-services.sh
./wait-for-services.sh

方案3：用临时容器替代dummy服务（相对优雅） #

如果你不想升级Docker Compose，也可以用一个临时的轻量容器（比如alpine:latest）来替代hello-world，它会在依赖服务健康后直接退出，避免无用的输出：

helper1:
  ...
  healthcheck:
    test: ["CMD", "curl", "-f", "http://helper1:1234/ready"]
    interval: 10s
    timeout: 5s
    retries: 5
helper2:
  ...
  healthcheck:
    test: ["CMD", "curl", "-f", "http://helper2:5678/health"]
    interval: 10s
    timeout: 5s
    retries: 5
wait-for-health:
  image: alpine:latest
  command: ["echo", "All services are healthy"]
  depends_on:
    helper1:
      condition: service_healthy
    helper2:
      condition: service_healthy

运行时指定这个临时服务：

docker-compose up wait-for-health

这个容器会在所有依赖服务健康后打印提示并退出，比hello-world更简洁，且不会输出多余的示例内容。

内容的提问来源于stack exchange，提问作者NeilK