cloudants/wait-for-200

URL健康检查Docker镜像

概述

该镜像包含一个Docker化的bash脚本，专门用于检查指定URL的健康状态。通过执行脚本并传入目标URL，可快速验证URL的可达性和服务状态，最终以退出码0（健康）或1（不健康）返回检查结果，便于集成到自动化流程中。

核心功能与特性

• Docker化部署：无需额外配置依赖，可直接在Docker环境中运行
• 轻量级检查：通过bash脚本实现基础URL健康验证
• 明确状态反馈：使用标准退出码0（健康）和1（不健康），便于脚本判断和集成
• 简单易用：仅需传入目标URL即可执行检查，无需复杂配置

使用场景

• 容器健康检查：作为Docker容器的HEALTHCHECK命令，定期验证服务可用性
• 自动化监控：集成到监控系统中，定期检查API或网站状态
• CI/CD流程：在部署环节验证服务是否成功启动并可访问
• 脚本自动化：作为批处理脚本的一部分，确保依赖服务正常运行

使用方法

基本用法

通过docker run命令运行镜像，将目标URL作为参数传入：

bash
docker run --rm [镜像名称] [目标URL]

参数说明

• [镜像名称]：该Docker镜像的名称（需替换为实际镜像标签）
• [目标URL]：需要检查健康状态的URL（如https://example.com）

退出状态码说明

• 0：URL健康（可正常访问且返回有效响应）
• 1：URL不健康（无法访问、超时或返回错误状态码）

示例

检查单个URL健康状态

bash
# 检查百度首页健康状态
docker run --rm url-health-check https://www.baidu.com

# 查看退出码（0表示健康，1表示不健康）
echo $?

作为容器健康检查使用

在Dockerfile中配置健康检查：

dockerfile
HEALTHCHECK --interval=30s --timeout=10s --start-period=60s --retries=3 \
  CMD docker run --rm --network=container:$(hostname) url-health-check http://localhost:8080/health

在docker-compose中集成

yaml
version: '3'
services:
  webapp:
    image: my-webapp
    healthcheck:
      test: ["CMD", "docker", "run", "--rm", "--network=service:webapp", "url-health-check", "http://localhost:8080/health"]
      interval: 30s
      timeout: 10s
      retries: 3