CI/CD / 系统课时
确认滚动更新真的完成
确认滚动更新真的完成
Argo CD 显示 Synced,只能说明期望配置已同步到集群,并不等于新版本已经稳定提供服务。本课把 Argo CD 状态、Deployment rollout 和 Pod 就绪状态串起来,建立一次发布完成后的最小验证链路。
学习目标
- 区分 Synced、Healthy 与 Deployment rollout 完成的含义
- 使用
kubectl rollout status和 Pod 状态确认新副本真正就绪 - 根据 rollout 卡住的位置定位镜像、探针和调度问题
从 Git 同步到业务可用
一次 GitOps 发布至少经过 Git 期望状态、Argo CD 同步、Deployment 创建新 ReplicaSet、Pod 启动并通过就绪探针几个阶段。任何中间阶段失败,都可能出现“配置已经同步,但新版本不能接流量”。

因此验证顺序应从声明状态继续深入到工作负载状态,而不是看到 Argo CD 的 Synced 就结束。Healthy 是重要信号,但发布验收仍应结合 Kubernetes 自身的 rollout 与 Pod 状态。
检查 Deployment 的滚动更新
假设应用位于 demo 命名空间,Deployment 名为 web。先等待 Kubernetes 判断滚动更新是否完成:
kubectl rollout status deployment/web -n demo --timeout=120s预期输出
deployment "web" successfully rolled out这表示 Deployment 控制器已经完成本轮 rollout。若 120 秒内仍未满足完成条件,命令会以失败状态退出;具体等待时间取决于镜像拉取、调度、启动速度和健康检查配置。
随后检查 Deployment 当前副本:
kubectl get deployment web -n demo
kubectl get pods -n demo -l app=web预期输出
NAME READY UP-TO-DATE AVAILABLE AGE
web 3/3 3 3 <TIME>
NAME READY STATUS RESTARTS AGE
web-<ID> 1/1 Running 0 <TIME>
web-<ID> 1/1 Running 0 <TIME>
web-<ID> 1/1 Running 0 <TIME><ID> 与 <TIME> 是动态值,实际结果会不同。重点检查期望副本全部 Ready、UP-TO-DATE 和 AVAILABLE,并确认新 Pod 没有反复重启。
确认运行的是目标版本
rollout 成功还需要确认 Deployment 使用了预期镜像,避免验证了一个健康但错误的版本。可以直接读取容器镜像:
kubectl get deployment web -n demo -o jsonpath='{.spec.template.spec.containers[*].image}'预期输出
registry.example.com/web:<ID>这里 <ID> 代表实际镜像标签或不可变版本标识。生产发布更适合使用可追踪的版本标签或 digest,而不是仅依赖可被重新指向的浮动标签。
rollout 卡住时先看 Pod
如果 kubectl rollout status 超时,不要立即重新同步。先查看 ReplicaSet、Pod 和事件,判断问题发生在哪个阶段:
kubectl get rs,pods -n demo
kubectl describe deployment web -n demo
kubectl get events -n demo --sort-by=.lastTimestamp预期结果
输出应显示当前 ReplicaSet、Pod 状态以及相关事件;具体名称、时间和事件内容取决于集群实际状态。ImagePullBackOff 通常指向镜像地址或拉取凭据,Pending 需要继续检查资源与调度条件,Pod 为 Running 但未 Ready 时则应重点检查 readinessProbe 和应用依赖。只有 Argo CD 期望状态、Deployment rollout、新 Pod Ready 与目标镜像能够相互印证,才能把这次滚动更新视为真正完成。