jstrader/autoheal

docker-autoheal镜像说明

镜像概述

docker-autoheal镜像用于监控Docker容器的健康状态，并自动重启不健康的容器。Docker原生虽支持HEALTHCHECK指令，但尚未实现--exit-on-unhealthy功能（相关PR：https://github.com/docker/docker/pull/22719%EF%BC%89%EF%BC%8C%E6%9C%AC%E9%95%9C%E5%83%8F%E5%8F%AF%E4%BD%9C%E4%B8%BA%E8%AF%A5%E5%8A%9F%E8%83%BD%E7%9A%84%E6%9B%BF%E4%BB%A3%E6%96%B9%E6%A1%88%E3%80%82

核心功能

• 监控容器健康状态，自动重启标记为不健康的容器
• 支持通过环境变量或容器标签指定监控范围
• 可配置健康检查间隔、启动等待时间、容器停止超时等参数

使用场景

适用于需要自动恢复服务可用性的场景，如生产环境中的应用容器、测试环境中的服务实例等，帮助减少人工干预，提升系统稳定性。

配置说明

环境变量默认值

AUTOHEAL_CONTAINER_LABEL=autoheal  # 默认监控带有autoheal=true标签的容器
AUTOHEAL_INTERVAL=5                # 每5秒检查一次容器健康状态
AUTOHEAL_START_PERIOD=0            # 启动后立即开始首次健康检查
AUTOHEAL_DEFAULT_STOP_TIMEOUT=10   # 重启时等待容器停止的默认超时时间（秒）
DOCKER_SOCK=/var/run/docker.sock   # Docker API的Unix socket路径
CURL_TIMEOUT=30                    # 调用Docker API的curl超时时间（秒）

可选容器标签

• autoheal.stop.timeout=20：为特定容器设置重启时的停止超时时间（覆盖默认值）

部署示例

基础运行命令

bash
docker run -d \
    --name autoheal \
    --restart=always \
    -e AUTOHEAL_CONTAINER_LABEL=all \
    -v /var/run/docker.sock:/var/run/docker.sock \
    jstrader/autoheal

监控指定标签的容器

1. 为目标容器添加标签autoheal=true：

   bash
   docker run -d --label autoheal=true your-image
   

2. 启动autoheal（使用默认标签配置）：

   bash
   docker run -d \
       --name autoheal \
       --restart=always \
       -v /var/run/docker.sock:/var/run/docker.sock \
       jstrader/autoheal
   

测试方法

1. 构建镜像（若需自定义）：

   bash
   docker build -t autoheal .
   

2. 启动测试：

   bash
   docker run -d \
       -e AUTOHEAL_CONTAINER_LABEL=all \
       -v /var/run/docker.sock:/var/run/docker.sock \
       autoheal