martin/wait

martin/wait 镜像说明

镜像概述

martin/wait 是一款体积极小（<5MB）的Docker实用工具，它会阻塞运行直到目标容器或服务的TCP端口可接受连接，若超时未连接成功则报错退出。主要用于解决服务依赖问题，确保依赖服务完全启动后再启动当前服务。

核心功能

1. 自动检测所有链接容器的EXPOSE端口并等待其可用
2. 支持指定仅等待链接容器的部分端口（通过-p参数）
3. 支持等待非链接的自定义主机和端口（通过-c参数）
4. 可自定义连接超时时间（通过-t参数，默认30秒）
5. 若任意目标端口超时未连接，立即以状态码1退出

使用场景

• 微服务架构中，确保数据库、缓存等依赖服务启动后再启动应用服务
• 多容器部署时，控制容器启动顺序以避免依赖缺失导致的错误

配置说明

参数说明

• -p <端口列表>：指定仅等待链接容器的特定端口（多个端口用逗号分隔）
• -c <主机:端口列表>：指定等待非链接的自定义主机和端口（多个条目用逗号分隔）
• -t <秒数>：设置每个连接的超时时间（默认30秒）

使用示例

1. 等待链接容器的所有暴露端口

shell
$ docker run -d --name mydb postgres
$ docker run --link mydb:mydb --rm martin/wait
Waiting for 172.17.0.105:5432  .  up!
Everything is up

2. 等待链接容器的指定端口

shell
$ docker run -d --name myapp some-app-image
$ docker run --link myapp:myapp --rm martin/wait -p 8080
Not checking 172.17.0.106:9090 because port is not included.
Waiting for 172.17.0.106:8080  .  up!
Everything is up

3. 等待自定义主机和端口

shell
$ docker run --rm martin/wait -c 8.8.8.8:53,github.com:443
Waiting for 8.8.8.8:53  .  up!
Waiting for github.com:443  .  up!
Everything is up

4. 设置自定义超时时间

shell
$ docker run --rm martin/wait -c github.com:5432 -t 15
Waiting for github.com:5432  ...............................  ERROR: unable to connect

credits

本镜像基于以下项目开发：

• waisbrot/wait: https://github.com/waisbrot/docker-wait
• n3llyb0y/wait: https://github.com/n3llyb0y/docker-wait
• aanand/wait: https://github.com/aanand/docker-wait