容器与云原生 / 系统课时
Helm 基础使用
Helm 基础使用
Helm 把一组 Kubernetes 资源封装成可版本化的软件包,并用 Release 记录一次实际安装。本节从仓库获取 Chart,完成安装、查询、升级和卸载,并明确 Chart、Repository、Release 三者的边界。
学习目标
- 说明 Chart、Repository 与 Release 的关系
- 使用 Helm 管理仓库并安装、查询应用
- 完成 Release 升级和卸载,并能避开名称与命名空间混淆
三个核心对象如何配合
Chart 是应用包,里面包含 Kubernetes 模板、默认配置和元数据;Repository 是发布 Chart 的索引与下载位置;Release 则是某个 Chart 在指定命名空间中的一次安装实例。一个 Chart 可以用不同 Release 名称安装多次,它们各自拥有独立的版本历史和配置。

仓库本身不保存集群中的运行状态。删除本地仓库配置不会删除已经安装的 Release;反过来,卸载 Release 也不会影响仓库中的 Chart。
添加仓库并查找 Chart
下面假设本机已经安装 Helm,并且网络可以访问 Bitnami 的公开 Chart 仓库。先检查客户端,再添加仓库、刷新索引并搜索 Nginx Chart。
helm version --short
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update
helm search repo bitnami/nginx --versions | head预期输出(版本号会随环境变化):
v<VALUE>+g<VALUE>
"bitnami" has been added to your repositories
...Successfully got an update from the "bitnami" chart repository
Update Complete. ⎈Happy Helming!⎈
NAME CHART VERSION APP VERSION DESCRIPTION
bitnami/nginx <VALUE> <VALUE> ...helm repo add 只是登记仓库地址,helm repo update 才会刷新本地索引。helm search repo 查询的是已经登记并更新过的仓库索引,不会在集群中创建任何资源。
安装并查询 Release
安装动作需要当前 kubectl 上下文能够连接目标集群。这里把 Chart 安装到 helm-demo 命名空间,并将 Release 命名为 demo-web。
helm install demo-web bitnami/nginx --namespace helm-demo --create-namespace
helm list --namespace helm-demo
helm status demo-web --namespace helm-demo预期结果(仅列关键字段,时间与 Chart 版本可能不同):
NAME: demo-web
NAMESPACE: helm-demo
STATUS: deployed
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION
demo-web helm-demo 1 <TIME> deployed nginx-<VALUE> <VALUE>Release 的身份由名称和命名空间共同确定。后续查询、升级和卸载时都应继续使用相同的 --namespace,否则常见结果是“找不到 Release”,而不是应用真的消失。
升级并卸载应用
升级会基于已有 Release 生成新的修订版本。下面把副本数覆盖为 2,查看用户覆盖值,然后卸载 Release。
helm upgrade demo-web bitnami/nginx --namespace helm-demo --set replicaCount=2
helm get values demo-web --namespace helm-demo
helm uninstall demo-web --namespace helm-demo
helm list --namespace helm-demo预期结果(省略与本节无关的提示文本):
Release "demo-web" has been upgraded. Happy Helming!
USER-SUPPLIED VALUES:
replicaCount: 2
release "demo-web" uninstalled
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSIONupgrade 修改的是 Release,不是仓库里的 Chart;uninstall 会删除该 Release 管理的集群资源和 Release 记录。日常操作时先确认 Release 名称与命名空间,再决定查状态、升级还是卸载,可以避免把“包名”和“安装实例名”混为一谈。