容器与云原生 / 系统课时

设计健康检查与优雅退出

设计健康检查与优雅退出

生产容器不仅需要启动成功,还需要能够被平台判断是否可用,并在停止时完成连接排空。本课将配置健康检查、停止信号和超时策略,构建可控的服务生命周期。

学习目标

  • 理解存活检查、就绪检查与容器 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 时,容器获得指定时间完成优雅退出。

验证健康检查与退出行为

测试时需要模拟请求压力,然后执行停止操作,确认新请求不再进入,已有请求能够完成。生产环境还应观察日志、指标和负载均衡摘除时间。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计健康检查与优雅退出

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

登录哪都通