容器与云原生 / 系统课时
读取 Deployment 发布状态
读取 Deployment 发布状态
Deployment 是否“发布完成”不能只看 Pod 是否 Running。本课通过 observedGeneration、updatedReplicas、availableReplicas 与 Conditions 建立一套可执行的判断顺序,区分控制器尚未处理、更新进行中、等待可用和已经完成等状态。
学习目标
- 根据
metadata.generation与status.observedGeneration判断控制器是否处理了最新变更 - 结合
updatedReplicas、availableReplicas与期望副本数判断滚动更新进度 - 用 Deployment Conditions 和
rollout status验证发布是否正常推进
先确认控制器看到了最新配置
假设当前命名空间存在名为 web 的 Deployment,先一次读取 generation 与关键副本计数:
kubectl get deployment web -o jsonpath='{.metadata.generation}{"\n"}{.status.observedGeneration}{"\n"}{.spec.replicas}{"\n"}{.status.updatedReplicas}{"\n"}{.status.availableReplicas}{"\n"}'预期输出
4
4
3
3
3实际数字会随发布阶段变化。这里表示期望 3 个副本,Deployment 控制器已经观察到第 4 代配置,并且 3 个副本都已更新且达到 Available 条件。判断时首先确认 status.observedGeneration >= metadata.generation;如果前者更小,当前 status 可能仍对应旧配置,不能据此宣布发布完成。
判断副本更新到了哪一步
spec.replicas 是期望副本数,updatedReplicas 是已经使用最新 Pod 模板的副本数,availableReplicas 是已经满足可用条件的副本数。它们分别回答“要多少”“新版有多少”“可服务有多少”。

滚动更新期间,常见情况是 updatedReplicas 已达到目标,而 availableReplicas 仍偏小。这通常表示新版 Pod 已创建,但还在等待 Readiness Probe、minReadySeconds 或其他可用性条件。
可以持续观察 Deployment:
kubectl get deployment web -w预期输出
NAME READY UP-TO-DATE AVAILABLE AGE
web 2/3 3 2 <TIME>
web 3/3 3 3 <TIME><TIME> 会因对象实际年龄不同而变化。UP-TO-DATE 对应最新模板副本数,AVAILABLE 对应当前可用副本数;前者先到目标而后者未到时,应继续检查 Pod 就绪与可用条件,而不是重复触发发布。
用 Conditions 解释当前状态
副本计数告诉你“数量到了哪里”,Conditions 则给出控制器对状态的解释。读取全部 Condition:
kubectl get deployment web -o jsonpath='{range .status.conditions[*]}{.type}{"\t"}{.status}{"\t"}{.reason}{"\t"}{.message}{"\n"}{end}'预期输出
Available True MinimumReplicasAvailable Deployment has minimum availability.
Progressing True NewReplicaSetAvailable ReplicaSet "<ID>" has successfully progressed.<ID> 代表实际 ReplicaSet 名称或标识的一部分。Progressing=True 表示发布过程正在推进或已成功推进;Available=True 表示 Deployment 已达到最小可用性要求。如果出现 Progressing=False 且 reason=ProgressDeadlineExceeded,则应按发布失败或卡住继续排查。
用 rollout status 做最终验证
手工字段适合诊断,发布脚本更适合使用 Deployment 自带的 rollout 状态检查:
kubectl rollout status deployment/web --timeout=120s预期输出
deployment "web" successfully rolled out若发布尚未完成,命令会持续观察直到成功或超时。手工判断时至少要确认控制器已观察最新 generation,updatedReplicas 与 availableReplicas 达到期望副本数;严格判断完全收敛还应确认总 status.replicas == spec.replicas,避免旧副本仍在清理。kubectl rollout status 适合作为最终门禁,把“控制器未处理”“新版未可用”和“真正发布完成”区分开。