容器与云原生 / 系统课时

设计 readinessProbe 就绪门槛

设计 readinessProbe 就绪门槛

滚动发布时,容器进程已经启动并不等于应用已经能稳定接单。readinessProbe 要把“进程运行”与“允许进入 Service 流量池”分开,让新 Pod 只有在初始化和关键业务能力真正就绪后才接收请求。

学习目标

  • 理解 readinessProbe 如何影响 Pod 就绪状态与 Service 流量资格
  • 为 HTTP 应用设计不过松、不过严的业务就绪检查
  • 在滚动发布中验证未就绪 Pod 不承接正常 Service 流量

就绪检查控制的是流量资格

Service 的 selector 选中 Pod,只说明它属于候选后端。readinessProbe 成功后,Pod 才满足就绪条件;探针失败时,容器通常不会被重启,而是被标记为未就绪。EndpointSlice 仍可能保留该 Pod 的地址,但会通过 conditions.ready: false 标记其状态,常规 Service 数据面不会把正常业务流量转给它。

这与 livenessProbe 的职责不同:readinessProbe 回答“现在能不能接请求”,livenessProbe 回答“进程是否已经坏到需要重启”。数据库连接池尚未建立、配置尚未加载或缓存尚未预热时,更适合暂时挡住流量,而不是触发重启。

readinessProbe 控制新 Pod 加入 Service 流量路径

让探针检查真正的业务就绪条件

/readyz 应只在应用自身初始化完成,并且提供核心请求所需的依赖可用时返回成功。下面的主示例同时定义 Service 与 Deployment,避免验证时出现 Service 不存在或 selector 不匹配的问题。

yaml
apiVersion: v1
kind: Service
metadata:
  name: api
spec:
  selector:
    app: api
  ports:
    - port: 80
      targetPort: 8080
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: api
spec:
  replicas: 3
  selector:
    matchLabels:
      app: api
  template:
    metadata:
      labels:
        app: api
    spec:
      containers:
        - name: api
          image: example/api:2.0
          ports:
            - containerPort: 8080
          readinessProbe:
            httpGet:
              path: /readyz
              port: 8080
            initialDelaySeconds: 2
            periodSeconds: 5
            timeoutSeconds: 2
            failureThreshold: 2
            successThreshold: 1

这组参数表示容器启动 2 秒后开始检查,每 5 秒探测一次;单次最多等待 2 秒,连续 2 次失败后判为未就绪,后续一次成功即可恢复就绪。配置文件本身没有固定控制台输出,生效后应通过 Pod 条件和 EndpointSlice 验证。

验证未就绪 Pod 是否被挡在流量池外

先观察 Pod。Running 只表示容器在运行,READY 才反映是否通过就绪门槛。

bash
kubectl get pods -l app=api

预期输出

text
NAME        READY   STATUS    RESTARTS   AGE
api-<ID>    1/1     Running   0          <TIME>
api-<ID>    1/1     Running   0          <TIME>
api-<ID>    0/1     Running   0          <TIME>

Pod 名称和时间会随环境变化。再检查 EndpointSlice 中每个地址的就绪条件:

bash
kubectl get endpointslice -l kubernetes.io/service-name=api -o jsonpath='{range .items[*].endpoints[*]}{.addresses[0]}{" => ready="}{.conditions.ready}{"\n"}{end}'

预期结果

text
<IP> => ready=true
<IP> => ready=true
<IP> => ready=false

地址顺序和数量可能不同。关键是未就绪 Pod 对应的 endpoint 显示 ready=false;这比只看 EndpointSlice 是否包含该 IP 更准确。若 Service 显式设置 publishNotReadyAddresses: true,其语义不同,不能用上述“未就绪即不接流量”的结论直接判断。

发布时还可以观察 rollout:

bash
kubectl rollout status deployment/api

预期输出

text
deployment "api" successfully rolled out

只有新副本满足可用条件后 rollout 才会完成;如果 readinessProbe 长时间失败,命令会持续等待而不是把“Pod 已创建”误判为“新版本已可用”。

避免把探针设计成新的故障源

就绪接口必须轻量,只检查“当前是否具备服务核心流量的能力”。不要让 /readyz 每次执行复杂 SQL、访问多个外部 API 或扫描大量数据,否则探针本身可能放大后端压力,并在短暂抖动时同时摘除大量 Pod。

也不要把所有非关键依赖都放进就绪门槛。例如推荐服务故障时订单接口仍可降级完成交易,那么推荐服务不可用不应让整个 Pod 退出流量池。判断标准不是“所有依赖是否完美”,而是“当前 Pod 是否还能履行它承诺的核心请求”。

一个有效的 readinessProbe 应形成清晰门槛:未准备好时不接单,准备完成后及时加入流量池,运行期间短暂失去服务能力时退出,恢复后再重新接入。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计 readinessProbe 就绪门槛

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

登录哪都通