容器与云原生 / 系统课时

HEALTHCHECK 怎样判断应用健康

HEALTHCHECK 怎样判断应用健康

容器处于 running 只说明主进程还在,并不等于 HTTP 服务、数据库连接或关键依赖已经可用。HEALTHCHECK 让 Docker 周期性执行探测命令,并把结果转换为 starting、healthy、unhealthy,便于运维人员识别“进程活着但应用已失效”的情况。

学习目标

  • 理解 HEALTHCHECK 如何根据探测命令的退出码更新健康状态
  • 能配置检查间隔、超时、启动宽限期和失败重试次数
  • 能用 Docker 命令观察状态变化并读取最近一次检查结果

健康状态是怎样得出的

Docker 启动带健康检查的容器后,健康状态先是 starting。之后按设定周期执行检查命令:返回退出码 0 表示本次成功,返回 1 表示本次失败;退出码 2 被 Docker 保留,不应拿来表示自定义状态。

一次成功检查即可把容器标记为 healthy。进入正常检查阶段后,只有连续失败次数达到 --retries,状态才会变为 unhealthy。--start-period 用来容忍应用初始化期间的失败;如果这段时间内检查已经成功,容器会提前结束启动阶段,之后的失败开始正常计数。

HEALTHCHECK 从 starting 到 healthy 或 unhealthy 的状态变化

在 Dockerfile 中配置检查

下面以 Nginx 为例。检查命令访问容器自己的 http://127.0.0.1/,这样验证的是容器内部服务是否真正能响应,而不是宿主机端口映射是否正常。

dockerfile
FROM nginx:1.27-alpine

RUN apk add --no-cache curl

HEALTHCHECK --interval=10s --timeout=3s --start-period=5s --retries=3 \
  CMD curl -fsS -o /dev/null http://127.0.0.1/ || exit 1

--interval 控制两次检查的间隔,--timeout 限制单次检查最长执行时间,--start-period 给应用预留启动时间,--retries 定义进入 unhealthy 前允许的连续失败次数。检查命令应尽量轻量,只验证能代表“应用可用”的关键路径。

构建并启动容器:

bash
docker build -q -t health-demo . >/dev/null
docker run -d --name health-demo health-demo >/dev/null
sleep 12
docker ps --filter name=health-demo --format '{{.ID}} {{.Image}} {{.Status}}'

预期输出中,容器 ID 和运行时长是动态值,实际环境会不同。

text
<ID> health-demo Up <TIME> (healthy)

查看最近一次检查结果

docker ps 只给出摘要。排障时应继续查看 .State.Health,其中包含当前状态、连续失败次数以及最近几次检查的开始时间、结束时间、退出码和输出。

bash
docker inspect --format '{{json .State.Health}}' health-demo

预期输出结构类似下面这样;时间戳以实际环境为准。

json
{"Status":"healthy","FailingStreak":0,"Log":[{"Start":"<TIME>","End":"<TIME>","ExitCode":0,"Output":""}]}

如果要定位 unhealthy,不要只看状态文字,还要查看检查记录里的 ExitCode 和 Output。DNS 失败、连接拒绝、HTTP 错误响应或检查超时,都可能最终表现为同一个 unhealthy。

HEALTHCHECK 不会自动重启容器

unhealthy 只是健康状态,不会因为 Dockerfile 中写了 HEALTHCHECK 就自动重启容器。Docker 的 Restart Policy 主要根据容器主进程是否退出决定是否重启,二者解决的是不同问题。

设计健康检查时,应优先选择快速、稳定、能代表核心服务能力的探针,并让超时和重试窗口覆盖应用的正常启动与短暂抖动。这样 healthy 与 unhealthy 才能真正成为可操作的运维信号。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

HEALTHCHECK 怎样判断应用健康

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通