容器与云原生 / 系统课时

Helm 升级与回滚

Helm 升级与回滚

Helm Release 每次升级都会形成新的修订版本。可靠发布的关键不是只会执行升级命令,而是先检查差异,再用等待与失败回滚限制影响范围,并保留可以快速恢复的历史修订。

学习目标

  • 理解 Release 修订版本与升级、回滚之间的关系
  • 在升级前检查清单差异,并执行带失败保护的升级
  • 使用历史记录和 helm rollback 恢复到已知可用版本

先确认 Release 与修订历史

以下操作假设当前 kubeconfig 已能访问集群,demo 命名空间中存在 Release web,本地 ./web-chart 是准备发布的新 Chart。先看历史,确认当前部署版本和可回退版本。

bash
helm history web -n demo

预期输出包含修订记录;时间和具体版本以实际环境为准。

text
REVISION  UPDATED  STATUS      CHART       APP VERSION  DESCRIPTION
1         <TIME>   superseded  web-0.1.0   1.0.0        Initial install
2         <TIME>   deployed    web-0.2.0   1.1.0        Upgraded successfully

同一个 Release 的 revision 只会向前增长。回滚到 revision 1 时,Helm 会依据旧修订内容创建一个新的 revision,而不是把当前编号改回 1。

Helm Release 升级、失败与回滚修订关系

升级前做清单差异检查

不依赖额外插件也能比较当前 Release 与待发布模板。先导出集群中当前 Release 的 manifest,再按升级语义渲染本地 Chart,最后用系统 diff 查看变化。下面假设目标镜像标签为 1.2.0。

bash
helm get manifest web -n demo > /tmp/web-current.yaml
helm template web ./web-chart -n demo --is-upgrade --set image.tag=1.2.0 > /tmp/web-next.yaml
diff -u /tmp/web-current.yaml /tmp/web-next.yaml

若只有镜像标签变化,预期结果会出现类似差异。diff 在发现差异时通常返回退出码 1,这表示“文件不同”,不等于 Helm 发布失败。

text
-          image: "nginx:1.1.0"
+          image: "nginx:1.2.0"

检查时重点关注资源是否意外新增或删除、不可变字段是否变化、Service 选择器是否漂移,以及镜像、环境变量和持久化配置是否符合预期。

用失败回滚实现原子升级

“原子升级”的目标是:升级成功则提交新版本,失败则恢复到此前成功版本。较新的 Helm CLI 将该选项命名为 --rollback-on-failure;仍支持旧参数名的版本中,--atomic 表达同类语义。

bash
helm upgrade web ./web-chart -n demo --set image.tag=1.2.0 --rollback-on-failure --timeout 5m

升级成功时,预期输出包含已升级状态;revision、时间和 Chart 版本会随环境变化。

text
Release "web" has been upgraded. Happy Helming!
NAME: web
NAMESPACE: demo
STATUS: deployed
REVISION: <ID>

失败回滚选项会把“升级失败后的恢复动作”纳入同一次发布控制,但仍要确认工作负载确实恢复。超时、探针失败、Hook 失败或资源无法就绪时,应继续查看 helm status、Pod 状态和事件,而不是仅凭 CLI 一行报错判断根因。

需要时手动回滚到旧修订

如果新版本虽被 Helm 标记为成功,但业务验证失败,可以先从历史中选定已知可用 revision,再显式回滚。例如回到 revision 1:

bash
helm rollback web 1 -n demo --wait --timeout 5m

预期输出如下:

text
Rollback was a success! Happy Helming!

随后再次查看历史,确认最新 revision 已处于 deployed,并记录回滚来源。

bash
helm history web -n demo

预期结果的最后一行会是更大的新 revision,而不是重新变成 revision 1。

text
REVISION  UPDATED  STATUS    CHART      APP VERSION  DESCRIPTION
<ID>      <TIME>   deployed  web-0.1.0  1.0.0        Rolled back to 1

失败发布按证据处理

发布异常时先保存证据,再决定修复或回滚:先用 helm status 与 helm history 确认 Release 状态和 revision,再查看 Deployment、Pod、Job 与事件定位镜像、探针、配额、调度或 Hook 问题。短时间内不能恢复,就回到已知可用修订,避免在失败版本上连续叠加未经验证的修改。

稳定的发布链路应把差异检查、升级、就绪验证、历史确认和必要时回滚视为一个整体。失败自动回滚可以缩短明显故障的暴露时间,但真正可回退仍取决于 Chart、应用协议和外部状态都为回滚预留了边界。

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

目录与阅读设置

阅读设置

17

记录一个想法

Helm 升级与回滚

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

登录哪都通