🚀 1. 安装与初始化
| 命令 |
说明 |
helm version |
查看 Helm 客户端与服务端版本。 |
helm repo list |
列出已添加的 Chart 仓库。 |
helm repo add bitnami https://charts.bitnami.com/bitnami |
添加 Chart 仓库。 |
helm repo update |
更新仓库索引(拉取最新 chart 列表)。 |
helm search repo nginx |
在已添加仓库中搜索 chart。 |
helm show values bitnami/nginx |
查看某 chart 默认配置值。 |
📦 2. 安装与升级 Chart
| 命令 |
说明 |
helm install my-nginx bitnami/nginx |
安装 nginx Chart,release 名为 my-nginx。 |
helm install my-nginx -f my-values.yaml bitnami/nginx |
指定 values 文件安装。 |
helm upgrade my-nginx bitnami/nginx |
升级指定 release。 |
helm upgrade my-nginx bitnami/nginx -f new-values.yaml |
升级时使用新配置。 |
helm uninstall my-nginx |
卸载 Release(删除资源但保留历史记录)。 |
📝 3. 模板渲染与调试
| 命令 |
说明 |
helm create mychart |
创建一个新的 Chart 脚手架项目。 |
helm lint mychart/ |
检查 chart 语法、结构是否规范。 |
helm template mychart/ |
渲染模板为 Kubernetes YAML(不安装,仅输出)。 |
helm template mychart/ -f my-values.yaml |
渲染模板并使用指定配置文件。 |
helm install myapp ./mychart |
本地目录安装 chart。 |
helm upgrade --install myapp ./mychart -f values.yaml |
有则升级,无则安装(常用模式)。 |
🔍 4. 查询与排查
| 命令 |
说明 |
helm list |
查看当前命名空间下所有 release。 |
helm list -A |
查看所有命名空间的 release。 |
helm status my-nginx |
查看 release 的状态(包含 notes)。 |
helm get values my-nginx |
获取已安装 release 的当前值。 |
helm get manifest my-nginx |
获取渲染后的 YAML 清单。 |
helm get all my-nginx |
获取完整 release 信息(值、模板、钩子等)。 |
♻️ 5. 回滚与历史管理
| 命令 |
说明 |
helm history my-nginx |
查看 release 的历史版本。 |
helm rollback my-nginx 1 |
回滚到指定版本。 |
helm uninstall my-nginx --keep-history |
卸载 release 但保留历史,可后续回滚。 |
🔐 6. Helm 与 Kubernetes 命名空间
| 命令 |
说明 |
helm install myapp ./mychart -n myns --create-namespace |
在指定命名空间安装(不存在则自动创建)。 |
helm list -n myns |
查看某命名空间下的 release。 |
helm uninstall myapp -n myns |
卸载某命名空间下的 release。 |
📌 7. 实用命令组合示例
# 添加仓库 + 安装
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update
helm install my-nginx bitnami/nginx
# 预览 YAML 而不部署
helm template ./mychart -f values.yaml > preview.yaml
# 有则升级、无则安装
helm upgrade --install myapp ./mychart -f values.yaml
# 回滚部署
helm rollback myapp 2