容器与云原生 / 系统课时
加入健康检查和自动重启
加入健康检查和自动重启
仅让 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> 替换为实际可用的宿主机端口。
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预期输出
<ID><ID> 为本次创建得到的容器 ID。unless-stopped 适合希望 Docker 或宿主机恢复后继续运行、同时又要尊重人工停机意图的常驻 Web 服务。
验证容器进入健康状态
等待至少一次健康检查完成后,同时读取运行状态、健康状态和重启策略。正常情况下,Nginx 能响应本地 HTTP 请求,因此健康状态会进入 healthy。
sleep 6
docker inspect --format '{{.State.Status}} {{.State.Health.Status}} {{.HostConfig.RestartPolicy.Name}}' web-resilient预期输出
running healthy unless-stopped如果长时间停留在 starting,应先检查探针命令是否存在、目标端口是否正确;若变成 unhealthy,可以继续查看 Healthcheck 的最近执行记录,而不是先修改 Restart Policy。
验证健康失败不会自动重启
先把默认首页临时移走,使根路径返回错误。等待足够时间让 3 次连续探针失败,然后检查容器状态和重启次数。
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预期输出
running unhealthy 0这说明探针已经判定服务不健康,但 Nginx 主进程仍在运行,所以 Restart Policy 没有触发。随后恢复首页并确认健康状态回到正常。
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预期输出
healthy验证主进程退出会触发重启
现在从容器内部向 PID 1 发送 SIGTERM,模拟应用主进程自行退出,而不是使用 docker stop。容器此前已经稳定运行超过 10 秒,Restart Policy 已进入生效阶段。
docker exec web-resilient sh -c 'kill -TERM 1'
sleep 3
docker inspect --format '{{.State.Status}} {{.RestartCount}}' web-resilient预期输出
running 1重启后健康状态会重新经历 starting 再进入 healthy。如果业务只希望在非零退出码时重试,可以选择 on-failure[:max-retries];若希望无论退出码都自动恢复,常见选择是 always 或 unless-stopped。无论选哪一种,都应把“进程存活”和“业务健康”作为两条独立信号观察。