如何使用Docker按指定顺序依次启动多个关联服务

核心实现逻辑 #

通过 Docker Compose 原生的depends_on依赖规则+服务健康检查能力实现顺序控制，不需要修改容器镜像内部逻辑，也不需要额外引入第三方脚本。

1. 编写docker-compose.yml配置 #

直接参考如下配置模版，根据自己使用的数据库类型调整健康检查命令即可：

version: '3.8'
services:
  # 数据库服务
  database:
    image: postgres:15-alpine # 可替换为mysql等其他数据库镜像
    environment:
      POSTGRES_USER: root
      POSTGRES_PASSWORD: 123456
      POSTGRES_DB: app_db
    # 健康检查：确认数据库真正可用
    healthcheck:
      test: ["CMD", "pg_isready", "-U", "root", "-d", "app_db"] # MySQL可替换为 ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p123456"]
      interval: 2s
      timeout: 3s
      retries: 10
    restart: always

  # 数据库迁移服务
  migrations:
    image: your-migrations-image:latest # 替换为你自己的迁移镜像
    depends_on:
      database:
        # 只有数据库健康检查通过后才会启动迁移服务
        condition: service_healthy
    # 迁移失败自动重试，可根据需求调整
    restart: on-failure

  # 开发环境种子数据注入服务
  seeding:
    image: your-seeding-image:latest # 替换为你自己的种子数据镜像
    profiles: ["dev"] # 只有指定dev profile时才会启动，生产环境默认不加载
    depends_on:
      migrations:
        # 只有迁移服务运行成功（退出码为0）后才会启动种子注入
        condition: service_completed_successfully

2. 启动与停止操作 #

• 开发环境启动（带种子数据）：执行命令docker compose --profile dev up
• 生产环境启动（不带种子数据）：执行命令docker compose up
• 一键停止所有服务：直接按Ctrl+C即可触发所有容器的统一停止，Docker Compose会自动处理所有运行中服务的优雅退出

补充说明 #

• 如果你的迁移/种子服务本身内置了数据库连接重试逻辑，可配合上述配置进一步降低启动失败概率
• 健康检查的间隔、重试次数参数可根据你的数据库启动速度自行调整
• 该方案所有服务均基于Docker运行，没有额外的外部依赖

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