容器与云原生 / 系统课时

设置 progressDeadlineSeconds

设置 progressDeadlineSeconds

滚动更新可能没有立即报错,却因为镜像拉取失败、探针异常或资源不足长时间无法产生新的可用副本。progressDeadlineSeconds 用来给 Deployment 的“发布进展”设置期限,并把长期无进展转化为 ProgressDeadlineExceeded 条件,便于监控和自动化判断。

学习目标

  • 理解 Deployment 如何判断发布是否持续取得进展
  • 正确配置 progressDeadlineSeconds 并读取超期条件
  • 明确进度超时与自动回滚之间的边界

配置发布进度期限

progressDeadlineSeconds 位于 Deployment 的 spec 下,单位为秒。下面的 Deployment 要求滚动发布在 120 秒的进度期限内持续取得进展:

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: web
spec:
  replicas: 3
  progressDeadlineSeconds: 120
  selector:
    matchLabels:
      app: web
  template:
    metadata:
      labels:
        app: web
    spec:
      containers:
        - name: web
          image: nginx:1.27
          readinessProbe:
            httpGet:
              path: /
              port: 80
            initialDelaySeconds: 5
            periodSeconds: 5

这是配置文件示例,不产生固定控制台输出。保存为 deployment.yaml 后可应用配置:

bash
kubectl apply -f deployment.yaml

预期输出

text
deployment.apps/web configured

首次创建时最后一个单词可能为 created。可以确认字段已经生效:

bash
kubectl get deployment web -o jsonpath='{.spec.progressDeadlineSeconds}{"\n"}'

预期输出

text
120

Deployment 怎样判断“有进展”

这个期限不是简单地从发布开始机械倒计时。Deployment 控制器会关注滚动发布是否持续取得新的进展,例如新的 ReplicaSet 被创建或扩容、旧 ReplicaSet 缩容,或者更多新副本达到 Available 状态。只要控制器观察到新的进展,进度判断就会继续向前推进。

Deployment 发布进度期限判定流程

因此,progressDeadlineSeconds 更适合表达“多久没有有效推进就应该报警”,而不是表达“整个发布必须在多少秒内完成”。如果一个大型 Deployment 一直在稳定增加 Available 副本,即使总耗时较长,也不一定触发进度超时。

观察超时失败信号

如果新版 Pod 因故迟迟无法让发布继续推进,可以查看 Deployment Conditions:

bash
kubectl get deployment web -o jsonpath='{range .status.conditions[*]}{.type}{"\t"}{.status}{"\t"}{.reason}{"\t"}{.message}{"\n"}{end}'

当进度期限被超过时,关键结果类似:

text
Progressing	False	ProgressDeadlineExceeded	ReplicaSet "<ID>" has timed out progressing.

<ID> 会随实际 ReplicaSet 名称变化。此时最重要的是 type=Progressing、status=False 和 reason=ProgressDeadlineExceeded,监控系统可以针对这三个字段建立失败告警。

也可以让发布命令等待结果:

bash
kubectl rollout status deployment/web --timeout=180s

预期结果可能为:

text
error: deployment "web" exceeded its progress deadline

如果客户端自身设置的 --timeout 更短,也可能先得到客户端等待超时,而不是 Deployment 的 ProgressDeadlineExceeded。排障时应回到 Deployment Conditions 确认究竟是哪一种超时。

期限应该怎样设

期限过短会把正常的慢启动误判为失败,尤其是容器启动时间长、Readiness Probe 需要较长预热、节点扩容或镜像下载可能耗时的场景。期限过长则会让真实故障长期占用发布窗口,降低告警价值。

可以从“正常情况下两次有效进展之间最长可能间隔多久”出发设置,而不是直接照搬固定秒数。至少要覆盖镜像拉取、容器启动、Readiness Probe 成功以及 minReadySeconds 等正常等待时间,并留出合理余量。

发布系统真正应消费的是一个明确的失败信号:正常推进时持续观察,出现 ProgressDeadlineExceeded 时停止继续扩大发布并进入诊断或回退流程。这样,Deployment 的状态字段才能从“被动查看信息”变成可用于发布治理的门禁信号。

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

目录与阅读设置

阅读设置

17

记录一个想法

设置 progressDeadlineSeconds

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

登录哪都通