容器与云原生 / 系统课时

优雅终止应用

优雅终止应用

本节解决 Pod 被删除、节点维护或发布替换时的安全退出问题:通过合理设置终止宽限期、配置 preStop,并让应用正确处理终止流程,尽量先停止接收新流量,再等待进行中的请求完成。

学习目标

  • 说清 Pod 从进入 Terminating 到容器退出的关键时序。
  • 配置 terminationGracePeriodSeconds 与 preStop 钩子。
  • 验证应用是否在宽限期内完成优雅退出,并识别强制终止风险。

看懂 Pod 的终止时序

当 Pod 被删除时,API 对象先进入 Terminating 状态;服务端点会异步处理该 Pod 的终止状态,kubelet 同时开始本机退出流程。若容器配置了 preStop,kubelet 会先执行钩子;钩子完成且容器仍在运行时,再向容器主进程发送 SIGTERM。宽限期耗尽后,仍未退出的进程最终会被强制结束。

Pod 优雅终止时序

这里有两个容易误判的点。第一,preStop 的执行时间也计算在终止宽限期内;第二,端点与代理的状态传播存在短暂延迟,所以不能假设 preStop 开始执行时已经绝对没有新请求。生产应用仍应具备停止接受新连接和排空在途工作的能力。

配置宽限期和 preStop

下面用两个 Nginx 副本演示。preStop 先等待 5 秒,为 Service、代理或负载均衡组件更新路由留出缓冲,再执行 nginx -s quit,让 Nginx 使用自身的优雅关闭机制结束工作进程。整个过程必须尽量在 30 秒宽限期内完成。

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: graceful-demo
spec:
  replicas: 2
  selector:
    matchLabels:
      app: graceful-demo
  template:
    metadata:
      labels:
        app: graceful-demo
    spec:
      terminationGracePeriodSeconds: 30
      containers:
        - name: nginx
          image: nginx:1.27-alpine
          ports:
            - containerPort: 80
          lifecycle:
            preStop:
              exec:
                command:
                  - /bin/sh
                  - -c
                  - sleep 5; nginx -s quit

这段配置的生效行为是:Pod 终止后,kubelet 在终止流程中执行 preStop,Nginx 收到 quit 指令后停止接受新工作并等待现有连接结束;若容器已经因此正常退出,就不需要继续等待普通终止信号。验证时还应确认 Deployment 最终恢复到两个可用副本。

部署并验证终止行为

保存为 graceful-demo.yaml 后执行部署,并等待两个副本就绪:

bash
kubectl apply -f graceful-demo.yaml
kubectl rollout status deployment/graceful-demo --timeout=120s

首次执行的预期输出类似:

text
deployment.apps/graceful-demo created
deployment "graceful-demo" successfully rolled out

实际执行期间可能先出现等待副本就绪的信息。接着自动取得一个 Pod 名称并删除它,再等待 Deployment 恢复可用状态:

bash
POD=$(kubectl get pod -l app=graceful-demo -o jsonpath='{.items[0].metadata.name}')
kubectl delete pod "$POD"
kubectl rollout status deployment/graceful-demo --timeout=120s

预期输出类似:

text
pod "graceful-demo-<ID>" deleted
deployment "graceful-demo" successfully rolled out

<ID> 是动态 Pod 标识,实际值会不同。删除命令完成前,旧 Pod 会经历终止流程;随后 ReplicaSet 创建替代 Pod,Deployment 最终重新达到期望副本数。

生产环境的关键边界

preStop 适合做短暂等待、注销服务发现或触发应用自有的排空接口,不适合执行耗时备份、长时间外部调用或不确定次数的重试。钩子占用的时间越多,留给后续退出工作的宽限时间就越少。

如果应用无法正确完成退出、终止流程超过宽限期,最终仍可能被强制结束。可靠的优雅终止需要同时满足三个条件:流量入口尽快摘除旧 Pod、应用主动停止承接新工作、在途请求能够在宽限期内安全完成。

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

目录与阅读设置

阅读设置

17

记录一个想法

优雅终止应用

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

登录哪都通