eficode/wait-for

等待其他服务可用

./wait-for 是一个用于同步Docker容器等服务的脚本，兼容sh和Alpine系统。它的设计灵感来源于https://github.com/vishnubob/wait-for-it，核心部分由Eficode的https://github.com/dsuni和https://github.com/mrako重写。使用时，只需将`wait-for`文件集成到项目中即可。

核心功能与特性

• 服务可用性检测：通过检查指定主机和端口，确认服务是否可用
• 兼容性：支持sh shell和Alpine系统，适用于各类轻量级环境
• 灵活配置：支持设置超时时间，控制状态消息输出
• 命令执行：可在服务可用后自动执行指定命令

使用方法

基本语法

./wait-for host:port [-t timeout] [-- command args]

选项说明

• -q | --quiet：不输出任何状态消息
• -t TIMEOUT | --timeout=timeout：超时时间（秒），0表示无超时
• -- COMMAND ARGS：在服务可用性测试完成后执行指定命令及参数

使用场景与示例

1. 检查网站服务可用性

验证eficode.com是否可用：

bash
$ ./wait-for www.eficode.com:80 -- echo "Eficode网站已上线"

Connection to www.eficode.com port 80 [tcp/http] succeeded!
Eficode网站已上线

2. Docker容器依赖服务等待

在Docker Compose中，等待数据库容器启动后再启动后端服务：

yaml
version: '2'

services:
  db:
    image: docker.xuanyuan.run/postgres:9.4

  backend:
    build: backend
    command: sh -c './wait-for db:5432 -- npm start'
    depends_on:
      - db

说明：后端服务通过./wait-for db:5432等待PostgreSQL数据库（默认端口5432）可用后，执行npm start启动应用。

测试方法

测试使用https://github.com/sstephenson/bats（依赖bash)）：

bash
docker build -t wait-for .
docker run -t docker.xuanyuan.run/wait-for