容器与云原生 / 系统课时

加入健康检查和自动重启

加入健康检查和自动重启

仅让 Web 进程“还在运行”不足以证明服务可用,而进程退出后是否自动拉起又是另一件事。本节为 Nginx 容器同时配置 Healthcheck 与 Restart Policy,并分别模拟健康探针失败和主进程退出,验证两套机制的真实边界。

学习目标

  • 配置 HTTP 健康检查并识别 starting、healthy、unhealthy
  • 为长期运行的 Web 容器选择并配置 Restart Policy
  • 区分“健康检查失败”和“容器进程退出”触发的不同结果

把健康状态与重启触发分开理解

对普通 docker run 容器,健康检查是在容器运行期间额外维护的一组状态:启动后先是 starting,探针成功后变为 healthy,连续失败达到阈值后变为 unhealthy。这并不会自动结束容器主进程。

Restart Policy 关注的是容器是否退出。也就是说,容器可以保持 running 同时变成 unhealthy;只有主进程真正退出后,unless-stopped、always 等策略才有机会执行重启。手工执行 docker stop 属于运维人员明确停机,不应拿它模拟异常崩溃。

健康状态与重启策略的关系

创建带 Healthcheck 和 Restart Policy 的容器

下面让容器每 5 秒访问一次自身首页,单次探针最多等待 2 秒,连续 3 次失败后标记为 unhealthy。--health-start-period=10s 给启动阶段留出初始化窗口。把 <PORT> 替换为实际可用的宿主机端口。

bash
docker run -d \
  --name web-resilient \
  --restart unless-stopped \
  --health-cmd='wget -q -O /dev/null http://127.0.0.1/ || exit 1' \
  --health-interval=5s \
  --health-timeout=2s \
  --health-retries=3 \
  --health-start-period=10s \
  -p <PORT>:80 \
  nginx:alpine

预期输出

text
<ID>

<ID> 为本次创建得到的容器 ID。unless-stopped 适合希望 Docker 或宿主机恢复后继续运行、同时又要尊重人工停机意图的常驻 Web 服务。

验证容器进入健康状态

等待至少一次健康检查完成后,同时读取运行状态、健康状态和重启策略。正常情况下,Nginx 能响应本地 HTTP 请求,因此健康状态会进入 healthy。

bash
sleep 6
docker inspect --format '{{.State.Status}} {{.State.Health.Status}} {{.HostConfig.RestartPolicy.Name}}' web-resilient

预期输出

text
running healthy unless-stopped

如果长时间停留在 starting,应先检查探针命令是否存在、目标端口是否正确;若变成 unhealthy,可以继续查看 Healthcheck 的最近执行记录,而不是先修改 Restart Policy。

验证健康失败不会自动重启

先把默认首页临时移走,使根路径返回错误。等待足够时间让 3 次连续探针失败,然后检查容器状态和重启次数。

bash
docker exec web-resilient mv /usr/share/nginx/html/index.html /usr/share/nginx/html/index.html.off
sleep 20
docker inspect --format '{{.State.Status}} {{.State.Health.Status}} {{.RestartCount}}' web-resilient

预期输出

text
running unhealthy 0

这说明探针已经判定服务不健康,但 Nginx 主进程仍在运行,所以 Restart Policy 没有触发。随后恢复首页并确认健康状态回到正常。

bash
docker exec web-resilient mv /usr/share/nginx/html/index.html.off /usr/share/nginx/html/index.html
sleep 10
docker inspect --format '{{.State.Health.Status}}' web-resilient

预期输出

text
healthy

验证主进程退出会触发重启

现在从容器内部向 PID 1 发送 SIGTERM,模拟应用主进程自行退出,而不是使用 docker stop。容器此前已经稳定运行超过 10 秒,Restart Policy 已进入生效阶段。

bash
docker exec web-resilient sh -c 'kill -TERM 1'
sleep 3
docker inspect --format '{{.State.Status}} {{.RestartCount}}' web-resilient

预期输出

text
running 1

重启后健康状态会重新经历 starting 再进入 healthy。如果业务只希望在非零退出码时重试,可以选择 on-failure[:max-retries];若希望无论退出码都自动恢复,常见选择是 always 或 unless-stopped。无论选哪一种,都应把“进程存活”和“业务健康”作为两条独立信号观察。

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

目录与阅读设置

阅读设置

17

记录一个想法

加入健康检查和自动重启

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

登录哪都通