如何检查docker-compose up启动的所有服务是否成功运行？

嘿，这个问题我之前搭建CI流程时也纠结过——用docker ps确实只能看到容器是否处于运行状态，但这根本没法保证里面的服务真正就绪啊！比如数据库容器起来了，但可能还在初始化schema；API容器跑起来了，但连不上数据库，这种情况docker ps只会告诉你“容器正常”，但实际服务根本用不了。分享几个我实战过的靠谱方案：

1. 用Docker Compose内置的健康检查+--wait参数（首推） #

Docker Compose从v2.10.0开始支持--wait参数，配合服务的healthcheck配置，能自动等待所有服务进入健康状态后再退出，完美适配CI场景。

配置示例（docker-compose.yml） #

给每个需要验证的服务添加健康检查规则，比如：

services:
  api:
    build: ./api
    healthcheck:
      # 用curl检查API的健康端点
      test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
      interval: 5s  # 每5秒检查一次
      timeout: 5s   # 超时时间5秒
      retries: 5    # 最多重试5次
      start_period: 10s  # 服务启动后10秒再开始检查（给初始化留时间）
    depends_on:
      db:
        condition: service_healthy  # 依赖数据库服务健康后再启动

  db:
    image: postgres:15
    healthcheck:
      # 用psql验证数据库连接
      test: ["CMD-SHELL", "pg_isready -U postgres -d mydb"]
      interval: 3s
      timeout: 3s
      retries: 10

CI中执行命令 #

直接运行：

docker-compose up --build --wait

这个命令会：

• 构建镜像
• 启动所有服务
• 等待所有服务进入healthy状态
• 一旦全部就绪，命令返回0（成功），CI就可以进入下一阶段；如果超时或健康检查失败，命令返回非0，CI直接失败。

2. 用等待脚本做灵活检查 #

如果你的Docker Compose版本较低，或者不想修改配置文件，可以用专门的等待脚本（比如wait-for-it.sh、dockerize）来验证服务端口/端点的可用性。

示例（用wait-for-it.sh） #

1. 先把脚本放到项目仓库或CI环境中：

# 若CI环境能联网，可直接下载；否则提前把脚本存入项目
curl -o wait-for-it.sh https://raw.githubusercontent.com/vishnubob/wait-for-it/master/wait-for-it.sh
chmod +x wait-for-it.sh

2. 启动服务后逐个验证：

# 后台启动服务
docker-compose up -d --build

# 等待数据库端口就绪（最多等60秒）
./wait-for-it.sh db:5432 -t 60

# 等待API健康端点返回200（最多等60秒）
./wait-for-it.sh api:8080 -t 60 -- curl -f http://api:8080/health

只要所有等待命令都成功，就说明服务就绪。

3. 直接运行集成测试（最彻底） #

其实CI的核心目标是确保服务能正常工作，而不是仅仅“启动”。所以最靠谱的方式是：启动服务后，直接运行一套关键的集成测试用例——比如调用API的基础接口、验证数据库数据是否正确、测试服务间的调用逻辑。

示例CI步骤 #

# 启动所有服务（后台运行）
docker-compose up -d --build

# 运行集成测试（假设测试套件是一个独立的服务）
docker-compose run --rm test-suite npm run test:integration

# 如果测试通过，继续下一阶段；否则CI失败

这种方式不仅验证了服务启动，还直接验证了功能正确性，能更早发现问题。

总结 #

• 优先选方案1：官方支持，配置简单，能准确判断服务健康状态；
• 如果需要灵活定制检查逻辑，选方案2；
• 追求最彻底的质量保障，选方案3——毕竟CI就是用来防错的，多跑几步测试没坏处。

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