容器与云原生 / 系统课时
设置 progressDeadlineSeconds
设置 progressDeadlineSeconds
滚动更新可能没有立即报错,却因为镜像拉取失败、探针异常或资源不足长时间无法产生新的可用副本。progressDeadlineSeconds 用来给 Deployment 的“发布进展”设置期限,并把长期无进展转化为 ProgressDeadlineExceeded 条件,便于监控和自动化判断。
学习目标
- 理解 Deployment 如何判断发布是否持续取得进展
- 正确配置
progressDeadlineSeconds并读取超期条件 - 明确进度超时与自动回滚之间的边界
配置发布进度期限
progressDeadlineSeconds 位于 Deployment 的 spec 下,单位为秒。下面的 Deployment 要求滚动发布在 120 秒的进度期限内持续取得进展:
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 后可应用配置:
kubectl apply -f deployment.yaml预期输出
deployment.apps/web configured首次创建时最后一个单词可能为 created。可以确认字段已经生效:
kubectl get deployment web -o jsonpath='{.spec.progressDeadlineSeconds}{"\n"}'预期输出
120Deployment 怎样判断“有进展”
这个期限不是简单地从发布开始机械倒计时。Deployment 控制器会关注滚动发布是否持续取得新的进展,例如新的 ReplicaSet 被创建或扩容、旧 ReplicaSet 缩容,或者更多新副本达到 Available 状态。只要控制器观察到新的进展,进度判断就会继续向前推进。

因此,progressDeadlineSeconds 更适合表达“多久没有有效推进就应该报警”,而不是表达“整个发布必须在多少秒内完成”。如果一个大型 Deployment 一直在稳定增加 Available 副本,即使总耗时较长,也不一定触发进度超时。
观察超时失败信号
如果新版 Pod 因故迟迟无法让发布继续推进,可以查看 Deployment Conditions:
kubectl get deployment web -o jsonpath='{range .status.conditions[*]}{.type}{"\t"}{.status}{"\t"}{.reason}{"\t"}{.message}{"\n"}{end}'当进度期限被超过时,关键结果类似:
Progressing False ProgressDeadlineExceeded ReplicaSet "<ID>" has timed out progressing.<ID> 会随实际 ReplicaSet 名称变化。此时最重要的是 type=Progressing、status=False 和 reason=ProgressDeadlineExceeded,监控系统可以针对这三个字段建立失败告警。
也可以让发布命令等待结果:
kubectl rollout status deployment/web --timeout=180s预期结果可能为:
error: deployment "web" exceeded its progress deadline如果客户端自身设置的 --timeout 更短,也可能先得到客户端等待超时,而不是 Deployment 的 ProgressDeadlineExceeded。排障时应回到 Deployment Conditions 确认究竟是哪一种超时。
期限应该怎样设
期限过短会把正常的慢启动误判为失败,尤其是容器启动时间长、Readiness Probe 需要较长预热、节点扩容或镜像下载可能耗时的场景。期限过长则会让真实故障长期占用发布窗口,降低告警价值。
可以从“正常情况下两次有效进展之间最长可能间隔多久”出发设置,而不是直接照搬固定秒数。至少要覆盖镜像拉取、容器启动、Readiness Probe 成功以及 minReadySeconds 等正常等待时间,并留出合理余量。
发布系统真正应消费的是一个明确的失败信号:正常推进时持续观察,出现 ProgressDeadlineExceeded 时停止继续扩大发布并进入诊断或回退流程。这样,Deployment 的状态字段才能从“被动查看信息”变成可用于发布治理的门禁信号。