容器与云原生 / 系统课时

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}

Helm Release 发布与回滚闭环

安装并查看 Release

为保证本课独立可操作,先用 helm create 生成示例 Chart,再用 helm upgrade --install 执行“存在则升级、不存在则安装”。--wait 会等待资源达到就绪条件,--timeout 限制等待时间。:contentReference[oaicite:4]{index=4}

bash
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

预期输出(时间和应用版本以实际环境为准):

text
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,并查看已保存的用户配置与历史修订。

bash
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

预期输出(更新时间使用占位符):

text
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,而不是删除中间历史。

bash
helm rollback web 1 \
  --namespace demo \
  --wait \
  --timeout 5m

helm history web --namespace demo
helm get values web --namespace demo --output yaml

预期输出:

text
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 回滚误认为完整的业务回滚。

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

目录与阅读设置

阅读设置

17

记录一个想法

Helm 应用发布

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

登录哪都通