容器与云原生 / 系统课时
Helm 升级与回滚
Helm 升级与回滚
Helm Release 每次升级都会形成新的修订版本。可靠发布的关键不是只会执行升级命令,而是先检查差异,再用等待与失败回滚限制影响范围,并保留可以快速恢复的历史修订。
学习目标
- 理解 Release 修订版本与升级、回滚之间的关系
- 在升级前检查清单差异,并执行带失败保护的升级
- 使用历史记录和
helm rollback恢复到已知可用版本
先确认 Release 与修订历史
以下操作假设当前 kubeconfig 已能访问集群,demo 命名空间中存在 Release web,本地 ./web-chart 是准备发布的新 Chart。先看历史,确认当前部署版本和可回退版本。
helm history web -n demo预期输出包含修订记录;时间和具体版本以实际环境为准。
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。

升级前做清单差异检查
不依赖额外插件也能比较当前 Release 与待发布模板。先导出集群中当前 Release 的 manifest,再按升级语义渲染本地 Chart,最后用系统 diff 查看变化。下面假设目标镜像标签为 1.2.0。
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 发布失败。
- image: "nginx:1.1.0"
+ image: "nginx:1.2.0"检查时重点关注资源是否意外新增或删除、不可变字段是否变化、Service 选择器是否漂移,以及镜像、环境变量和持久化配置是否符合预期。
用失败回滚实现原子升级
“原子升级”的目标是:升级成功则提交新版本,失败则恢复到此前成功版本。较新的 Helm CLI 将该选项命名为 --rollback-on-failure;仍支持旧参数名的版本中,--atomic 表达同类语义。
helm upgrade web ./web-chart -n demo --set image.tag=1.2.0 --rollback-on-failure --timeout 5m升级成功时,预期输出包含已升级状态;revision、时间和 Chart 版本会随环境变化。
Release "web" has been upgraded. Happy Helming!
NAME: web
NAMESPACE: demo
STATUS: deployed
REVISION: <ID>失败回滚选项会把“升级失败后的恢复动作”纳入同一次发布控制,但仍要确认工作负载确实恢复。超时、探针失败、Hook 失败或资源无法就绪时,应继续查看 helm status、Pod 状态和事件,而不是仅凭 CLI 一行报错判断根因。
需要时手动回滚到旧修订
如果新版本虽被 Helm 标记为成功,但业务验证失败,可以先从历史中选定已知可用 revision,再显式回滚。例如回到 revision 1:
helm rollback web 1 -n demo --wait --timeout 5m预期输出如下:
Rollback was a success! Happy Helming!随后再次查看历史,确认最新 revision 已处于 deployed,并记录回滚来源。
helm history web -n demo预期结果的最后一行会是更大的新 revision,而不是重新变成 revision 1。
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、应用协议和外部状态都为回滚预留了边界。