healthy

概述

healthy 是一个用于等待一个或多个Docker容器变为健康状态的命令行工具。它接收一个或多个容器ID或名称作为参数，持续检查这些容器的健康状态，直到所有容器均被报告为“健康”时退出（退出码0）。未定义健康检查的容器始终被视为健康。

核心功能与特性

• 多容器支持：可同时等待多个Docker容器的健康状态
• 健康检查处理：无健康检查定义的容器默认视为健康
• 超时控制：可设置最大等待时长（默认1小时）
• 失败策略：支持 -fail-on-unhealthy 选项，在容器状态为“不健康”时失败

使用场景

• Docker Compose环境中等待所有服务健康后再执行后续操作
• 等待特定服务（如数据库）健康后启动依赖服务
• 自动化部署流程中确保容器就绪后再继续

命令行参数说明

usage: healthy [flags] [container_id_or_name ...]

使用方法示例

1. Docker Compose中等待所有服务健康

bash
healthy $(docker-compose ps -q)

2. 等待特定服务（如数据库）健康

bash
healthy $(docker-compose ps -q database)

3. 设置超时时间（如1分30秒）

bash
healthy -timeout 1m30s $(docker-compose ps -q)

Docker部署示例

通过Docker镜像运行healthy（需挂载Docker套接字以访问容器状态）：

bash
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock:ro arnested/healthy $(docker-compose ps -q)

说明

• --rm：容器退出后自动删除
• -v /var/run/docker.sock:/var/run/docker.sock:ro：只读挂载Docker套接字，使工具能查询容器状态
• arnested/healthy：镜像名称