briceburg/docker-compose-wait

briceburg/docker-compose-wait 镜像说明

镜像概述

本镜像基于Busybox构建，封装了ufoscout开发的docker-compose-wait工具，旨在解决Docker Compose环境中服务启动顺序依赖问题，确保应用服务在其依赖的数据库、缓存等服务完全就绪后再启动，避免因依赖服务未就绪导致的启动失败。

核心功能

• 支持等待多个TCP服务端口开放（如数据库、API服务）
• 可自定义等待超时时间、检查间隔时间
• 轻量级设计：基于Busybox镜像，体积小、启动速度快

使用场景

• Docker Compose项目中，应用服务依赖MySQL、PostgreSQL、Redis等服务时，确保依赖服务启动完成后再启动应用
• 微服务架构中，服务间存在启动顺序依赖的场景（如API服务需等待配置中心服务就绪）

配置说明

通过环境变量配置等待参数：

部署示例

Docker Run命令

bash
docker run --rm \
  -e WAIT_HOSTS=db:3306,redis:6379 \
  -e WAIT_TIMEOUT=60 \
  briceburg/docker-compose-wait

Docker Compose集成

在docker-compose.yml中，将wait工具作为应用服务的启动前置步骤：

yaml
services:
  app:
    build: ./app
    depends_on:
      - db
      - redis
    command: ["/wait", "--", "node", "server.js"] # 使用wait工具后执行应用启动命令
    environment:
      WAIT_HOSTS: db:3306,redis:6379
      WAIT_TIMEOUT: 120

  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_USER: app
      POSTGRES_PASSWORD: secret
      POSTGRES_DB: app_db

  redis:
    image: redis:7-alpine