djbasster/wait-for-it

wait-for-it 镜像文档

镜像概述和主要用途

wait-for-it 是一个基于 bash 的小型 Docker 镜像，封装了 wait-for-it.sh 脚本，用于在容器环境中等待依赖服务就绪。该镜像特别适合作为容器编排中的初始化容器（init-container），确保主应用容器在依赖服务（如数据库、API 服务等）可用后再启动，避免因依赖服务未就绪导致的启动失败。

核心功能和特性

• 轻量级：基于 bash 构建，镜像体积小，资源占用低
• 功能明确：专注于实现 wait-for-it.sh 的核心功能，即等待指定主机和端口的服务可用
• 兼容性强：适用于各类容器编排平台（如 Kubernetes、Docker Compose 等）
• 易于使用：提供简洁的命令行接口，支持直接指定目标服务的主机和端口

使用场景和适用范围

• 容器编排初始化：在 Kubernetes、Docker Compose 等编排环境中作为 init-container，等待数据库、缓存、消息队列等依赖服务启动并可用
• 服务依赖管理：确保微服务架构中，依赖其他服务的应用在启动前等待依赖服务就绪
• 自动化部署流程：在 CI/CD 部署流程中，用于等待目标服务就绪后再执行后续步骤

使用方法和配置说明

基本用法

通过 docker run 命令直接运行镜像，指定需要等待的目标服务主机和端口：

bash
docker run djbasster/wait-for-it <目标主机>:<端口>

示例

等待 www.google.com 的 443 端口可用：

bash
docker run djbasster/wait-for-it www.google.com:443

执行后输出：

wait-for-it: waiting 15 seconds for www.google.com:443
wait-for-it: www.google.com:443 is available after 1 seconds

更多使用示例（如设置超时时间、执行后续命令等），可参考 https://github.com/vishnubob/wait-for-it#examples%E3%80%82

源代码

镜像源代码托管于 GitHub：https://github.com/Basster/wait-for-it-docker