daseddy/wait-for-status

wait-for-status镜像说明

镜像概述

wait-for-status是一个轻量级Docker镜像，旨在解决容器化部署中的服务依赖启动顺序问题，通过监控目标URL的HTTP响应状态码，确保依赖服务就绪后再启动当前服务，提升部署稳定性。

核心功能

1. 实时监控指定URL的HTTP状态码
2. 自定义目标状态码（默认值：200）
3. 设置最大等待超时时间（单位：秒）
4. 支持状态码达标后额外等待一段时间再退出

使用场景

• Docker Compose中等待数据库、API服务等依赖组件启动完成
• CI/CD流程中确保后端服务就绪后执行前端部署
• 容器化应用启动前的健康检查验证

配置说明

通过环境变量传递配置参数：

• URL（必填）：需监控的目标服务URL
• STATUS（可选）：期望的HTTP状态码，默认200
• TIMEOUT（可选）：最大等待时长（秒），超时未达标则退出
• EXTRA（可选）：达标后额外等待时长（秒）

部署示例

基础Docker Run命令

bash
docker run --rm -e URL=http://example.org -e STATUS=200 -e TIMEOUT=30 -e EXTRA=10 docker.xuanyuan.run/daseddy/wait-for-status

说明：等待http://example.org返回200状态码，最长等待30秒，成功后额外等待10秒再退出。

Docker Compose集成示例

yaml
services:
  web-app:
    image: docker.xuanyuan.run/your-web-image
    command: >
      sh -c "docker run --rm -e URL=http://api:8080/health -e STATUS=200 -e TIMEOUT=60 daseddy/wait-for-status && node app.js"
    depends_on:
      - api
  
  api:
    image: docker.xuanyuan.run/your-api-image
    ports:
      - "8080:8080"

说明：Web应用启动前先验证API服务的健康接口是否返回200状态码，确保API就绪后再启动Web服务。