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同步到Pod可用的滚动更新验证链路

因此验证顺序应从声明状态继续深入到工作负载状态,而不是看到 Argo CD 的 Synced 就结束。Healthy 是重要信号,但发布验收仍应结合 Kubernetes 自身的 rollout 与 Pod 状态。

检查 Deployment 的滚动更新

假设应用位于 demo 命名空间,Deployment 名为 web。先等待 Kubernetes 判断滚动更新是否完成:

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

预期输出

text
deployment "web" successfully rolled out

这表示 Deployment 控制器已经完成本轮 rollout。若 120 秒内仍未满足完成条件,命令会以失败状态退出;具体等待时间取决于镜像拉取、调度、启动速度和健康检查配置。

随后检查 Deployment 当前副本:

bash
kubectl get deployment web -n demo
kubectl get pods -n demo -l app=web

预期输出

text
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 使用了预期镜像,避免验证了一个健康但错误的版本。可以直接读取容器镜像:

bash
kubectl get deployment web -n demo -o jsonpath='{.spec.template.spec.containers[*].image}'

预期输出

text
registry.example.com/web:<ID>

这里 <ID> 代表实际镜像标签或不可变版本标识。生产发布更适合使用可追踪的版本标签或 digest,而不是仅依赖可被重新指向的浮动标签。

rollout 卡住时先看 Pod

如果 kubectl rollout status 超时,不要立即重新同步。先查看 ReplicaSet、Pod 和事件,判断问题发生在哪个阶段:

bash
kubectl get rs,pods -n demo
kubectl describe deployment web -n demo
kubectl get events -n demo --sort-by=.lastTimestamp

预期结果

text
输出应显示当前 ReplicaSet、Pod 状态以及相关事件;具体名称、时间和事件内容取决于集群实际状态。

ImagePullBackOff 通常指向镜像地址或拉取凭据,Pending 需要继续检查资源与调度条件,Pod 为 Running 但未 Ready 时则应重点检查 readinessProbe 和应用依赖。只有 Argo CD 期望状态、Deployment rollout、新 Pod Ready 与目标镜像能够相互印证,才能把这次滚动更新视为真正完成。

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

目录与阅读设置

阅读设置

17

记录一个想法

确认滚动更新真的完成

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

登录哪都通