容器与云原生 / 系统课时
设计健康检查与优雅退出
设计健康检查与优雅退出
生产容器不仅需要启动成功,还需要能够被平台判断是否可用,并在停止时完成连接排空。本课将配置健康检查、停止信号和超时策略,构建可控的服务生命周期。
学习目标
- 理解存活检查、就绪检查与容器 HEALTHCHECK 的区别
- 掌握 Docker 停止流程和信号处理方式
- 能够验证服务关闭前完成连接排空
理解容器生命周期检查
健康检查解决的是“当前容器是否可以继续服务”的问题。存活检查用于发现死循环或无法恢复的进程,就绪检查用于判断服务是否已经准备好接收请求。
对于简单 Docker 部署,可以使用 HEALTHCHECK 定义检查命令;在编排平台中,还应结合应用提供的健康端点。

配置 Docker HEALTHCHECK
HEALTHCHECK 会周期性执行检测命令,并根据返回码判断状态。命令返回 0 表示健康,非 0 表示异常。
dockerfile
FROM nginx:latest
COPY healthcheck.sh /usr/local/bin/healthcheck.sh
HEALTHCHECK --interval=<TIME>s --timeout=<TIME>s --retries=3 \
CMD /usr/local/bin/healthcheck.sh预期结果
text
容器状态显示为 healthy,检测失败达到重试次数后标记为 unhealthy。处理停止信号和连接排空
Docker 停止容器时默认发送 SIGTERM,等待超时时间结束后发送 SIGKILL。应用必须监听 SIGTERM,在退出前停止接收新请求并关闭已有连接。
python
import signal
import time
running = True
def shutdown_handler(signum, frame):
global running
running = False
print("shutdown requested")
signal.signal(signal.SIGTERM, shutdown_handler)
while running:
time.sleep(1)
print("connections drained")预期结果
text
shutdown requested
connections drained设置合理停止超时
Compose 中可以使用 stop_grace_period 控制等待时间。时间太短会导致请求被强制终止,太长会影响故障恢复速度。
yaml
services:
api:
image: my-service:latest
stop_grace_period: <TIME>s预期结果
text
执行 docker compose stop 时,容器获得指定时间完成优雅退出。验证健康检查与退出行为
测试时需要模拟请求压力,然后执行停止操作,确认新请求不再进入,已有请求能够完成。生产环境还应观察日志、指标和负载均衡摘除时间。
按自己的节奏,确认真正理解。