容器与云原生 / 系统课时

读取 Deployment 发布状态

读取 Deployment 发布状态

Deployment 是否“发布完成”不能只看 Pod 是否 Running。本课通过 observedGeneration、updatedReplicas、availableReplicas 与 Conditions 建立一套可执行的判断顺序,区分控制器尚未处理、更新进行中、等待可用和已经完成等状态。

学习目标

  • 根据 metadata.generation 与 status.observedGeneration 判断控制器是否处理了最新变更
  • 结合 updatedReplicas、availableReplicas 与期望副本数判断滚动更新进度
  • 用 Deployment Conditions 和 rollout status 验证发布是否正常推进

先确认控制器看到了最新配置

假设当前命名空间存在名为 web 的 Deployment,先一次读取 generation 与关键副本计数:

bash
kubectl get deployment web -o jsonpath='{.metadata.generation}{"\n"}{.status.observedGeneration}{"\n"}{.spec.replicas}{"\n"}{.status.updatedReplicas}{"\n"}{.status.availableReplicas}{"\n"}'

预期输出

text
4
4
3
3
3

实际数字会随发布阶段变化。这里表示期望 3 个副本,Deployment 控制器已经观察到第 4 代配置,并且 3 个副本都已更新且达到 Available 条件。判断时首先确认 status.observedGeneration >= metadata.generation;如果前者更小,当前 status 可能仍对应旧配置,不能据此宣布发布完成。

判断副本更新到了哪一步

spec.replicas 是期望副本数,updatedReplicas 是已经使用最新 Pod 模板的副本数,availableReplicas 是已经满足可用条件的副本数。它们分别回答“要多少”“新版有多少”“可服务有多少”。

Deployment 滚动更新状态字段关系

滚动更新期间,常见情况是 updatedReplicas 已达到目标,而 availableReplicas 仍偏小。这通常表示新版 Pod 已创建,但还在等待 Readiness Probe、minReadySeconds 或其他可用性条件。

可以持续观察 Deployment:

bash
kubectl get deployment web -w

预期输出

text
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:

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

预期输出

text
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 状态检查:

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

预期输出

text
deployment "web" successfully rolled out

若发布尚未完成,命令会持续观察直到成功或超时。手工判断时至少要确认控制器已观察最新 generation,updatedReplicas 与 availableReplicas 达到期望副本数;严格判断完全收敛还应确认总 status.replicas == spec.replicas,避免旧副本仍在清理。kubectl rollout status 适合作为最终门禁,把“控制器未处理”“新版未可用”和“真正发布完成”区分开。

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

目录与阅读设置

阅读设置

17

记录一个想法

读取 Deployment 发布状态

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

登录哪都通