容器与云原生 / 系统课时
Helm 应用发布
Helm 应用发布
本课以一个本地 Chart 为对象,完成 Helm 安装、升级、查看历史和回滚。你将得到一套可重复执行的发布流程,并知道 Release、Revision 与实际 Kubernetes 资源之间如何对应。
学习目标
- 使用 Helm 安装或幂等更新一个应用 Release
- 查看 Release 状态、配置、清单与修订历史
- 在升级异常时回滚到指定 Revision 并完成验证
发布前置条件
执行发布前,需要确认 helm version 可用、当前 kubeconfig 指向目标集群,并且操作者对目标命名空间具有创建和更新资源的权限。示例使用 demo 命名空间和 web 发布名;若环境中已存在同名 Release,应更换名称或先确认其归属。
Release 是 Chart 与一组 values 在某个命名空间中的已命名实例。首次安装产生 Revision 1,每次成功升级或回滚都会形成新的 Revision;helm history 用于查看历史,helm rollback 根据修订号恢复清单和 values。:contentReference[oaicite:3]{index=3}

安装并查看 Release
为保证本课独立可操作,先用 helm create 生成示例 Chart,再用 helm upgrade --install 执行“存在则升级、不存在则安装”。--wait 会等待资源达到就绪条件,--timeout 限制等待时间。:contentReference[oaicite:4]{index=4}
if [ ! -d demo-app ]; then
helm create demo-app
fi
helm lint ./demo-app
helm upgrade --install web ./demo-app \
--namespace demo \
--create-namespace \
--set replicaCount=2 \
--wait \
--timeout 5m
helm list --namespace demo
helm status web --namespace demo预期输出(时间和应用版本以实际环境为准):
Release "web" does not exist. Installing it now.
NAME: web
NAMESPACE: demo
STATUS: deployed
REVISION: 1
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION
web demo 1 <TIME> deployed demo-app-0.1.0 <APP_VERSION>helm list 适合查看命名空间内的 Release 概览,helm status 适合确认单个 Release 的状态、Revision、资源和 NOTES。当前命名空间未指定时,列表结果会受 kubeconfig 上下文影响,因此生产脚本应显式传入 --namespace。:contentReference[oaicite:5]{index=5}
升级并核对历史
升级时同时指定 Chart 与新的 values。下面把副本数从 2 改为 3,并查看已保存的用户配置与历史修订。
helm upgrade web ./demo-app \
--namespace demo \
--set replicaCount=3 \
--wait \
--timeout 5m
helm get values web --namespace demo --output yaml
helm history web --namespace demo预期输出(更新时间使用占位符):
Release "web" has been upgraded.
replicaCount: 3
REVISION UPDATED STATUS CHART DESCRIPTION
1 <TIME> superseded demo-app-0.1.0 Install complete
2 <TIME> deployed demo-app-0.1.0 Upgrade complete未指定 --reuse-values 时,升级以新 Chart 默认值为基础,再叠加本次传入的覆盖值;生产发布应把完整环境配置保存在版本库中的 values 文件,而不是长期依赖零散的 --set。发布前可先执行 helm template 或服务端 dry-run 检查渲染结果和 API 兼容性。:contentReference[oaicite:6]{index=6}
回滚并验证
先通过 helm history 确认目标 Revision,再执行回滚。回滚到 Revision 1 后,Helm 会创建新的 Revision,而不是删除中间历史。
helm rollback web 1 \
--namespace demo \
--wait \
--timeout 5m
helm history web --namespace demo
helm get values web --namespace demo --output yaml预期输出:
Rollback was a success! Happy Helming!
REVISION UPDATED STATUS CHART DESCRIPTION
1 <TIME> superseded demo-app-0.1.0 Install complete
2 <TIME> superseded demo-app-0.1.0 Upgrade complete
3 <TIME> deployed demo-app-0.1.0 Rollback to 1
replicaCount: 2回滚完成后还应使用 kubectl rollout status、健康检查或业务探针验证实际服务,而不能只看到 Helm 状态为 deployed 就结束。Revision 恢复的是 Helm 管理的清单和 values,不会自动逆转数据库迁移、外部消息或其他不可逆副作用。
发布失败的处理顺序
先读取 helm status web -n demo 与相关 Pod 事件,区分模板错误、权限不足、镜像拉取失败和就绪探针失败。模板错误应在发布前通过 helm lint、helm template 或 dry-run 阶段发现;运行期错误则要结合 Kubernetes 事件和容器日志定位。修复后再次升级,或者明确选择一个已验证的 Revision 回滚。
生产流程应固定 Chart 版本、镜像摘要和环境 values,并为升级设置合理的等待与超时策略。涉及 CRD、数据库结构或有状态组件时,要单独设计兼容与恢复方案,避免把 Helm 回滚误认为完整的业务回滚。