helm 的常用命令

helm 详细使用方法请查看：

Helm | 快速入门指南如何安装和开始使用Helm，包括Helm的介绍、FAQs和Helm插件https://helm.sh/zh/docs/intro/quickstart/

1. helm create - 创建新 Chart

生成一个基础 Chart 目录结构（包含 Chart.yaml、values.yaml、templates 等）。

# 创建名为 "myapp" 的 Chart
helm create myapp

执行后会生成 myapp 目录，可在此基础上修改配置和模板。

2. helm dependency - 管理 Chart 依赖

添加、更新或构建 Chart 的依赖（依赖定义在 Chart.yaml 的 dependencies 中）。

# 进入 Chart 目录
cd myapp
# 更新依赖（需先在 Chart.yaml 中定义依赖）
helm dependency update

3. helm install - 安装 Chart

将 Chart 部署到 Kubernetes 集群，创建一个 Release。

# 安装名为 "myapp" 的 Chart，指定 Release 名为 "myapp-v1"
helm install myapp-v1 ./myapp# 安装时通过 --set 覆盖 values 配置（如修改镜像版本）
helm install myapp-v1 ./myapp --set image.tag=v2.0# 从远程仓库安装（如安装 bitnami 的 nginx）
helm install my-nginx bitnami/nginx

4. helm upgrade - 更新 Release

更新已部署的 Release（修改配置或升级 Chart 版本）。

# 更新 "myapp-v1" 这个 Release，使用新的 values 配置
helm upgrade myapp-v1 ./myapp -f new-values.yaml# 更新时临时修改参数（如增加副本数）
helm upgrade myapp-v1 ./myapp --set replicaCount=3

5. helm rollback - 回滚到历史版本

将 Release 回滚到之前的版本（需先通过 helm history 查看历史版本号）。

# 查看 "myapp-v1" 的历史版本
helm history myapp-v1# 回滚到版本 2
helm rollback myapp-v1 2

6. helm uninstall - 卸载 Release

删除集群中已部署的 Release 及相关资源。

# 卸载 "myapp-v1"
helm uninstall myapp-v1

7. helm list - 列出所有 Release

查看当前集群中所有 Helm 部署的 Release 状态。

# 查看 default 命名空间的 Release
helm list# 查看所有命名空间的 Release
helm list -A

8. helm repo - 管理 Chart 仓库

添加、更新、删除远程 Chart 仓库（如 Harbor、官方仓库）。

• add：添加仓库
• update：更新仓库索引
• list：列出所有仓库
• remove：删除仓库

# 添加 bitnami 官方仓库
helm repo add bitnami https://charts.bitnami.com/bitnami# 添加 Harbor 仓库（假设 Harbor 地址为 harbor.example.com）
helm repo add my-harbor https://harbor.example.com/chartrepo/my-project# 更新所有仓库的索引
helm repo update# 列出已添加的仓库
helm repo list# 删除仓库
helm repo remove my-harbor

9. helm search - 搜索 Chart

从已添加的仓库中搜索 Chart。
常用子命令：

• repo：搜索本地仓库中的 Chart
• hub：搜索 Helm Hub（远程公共仓库）

# 搜索本地仓库中包含 "nginx" 的 Chart
helm search repo nginx# 搜索 bitnami 仓库中的 "mysql" Chart
helm search repo bitnami/mysql

10. helm package - 打包 Chart

将 Chart 目录打包为 .tgz 压缩文件（用于上传到仓库）。

# 打包当前目录的 Chart（生成 myapp-0.1.0.tgz）
helm package ./myapp

11. helm pull - 下载远程 Chart

从远程仓库下载 Chart 到本地（可选解压）。

# 下载 bitnami/nginx 到本地（不解压）
helm pull bitnami/nginx# 下载并自动解压（--untar）
helm pull bitnami/nginx --untar

12. helm template - 本地渲染模板

在本地渲染 Chart 模板，生成 Kubernetes YAML 资源（不部署到集群，用于验证配置）。

# 渲染 myapp 的模板，输出 YAML
helm template ./myapp# 结合自定义 values 渲染
helm template ./myapp -f custom-values.yaml

13. helm show - 查看 Chart 详情

查看 Chart 的元数据、配置说明等信息。
常用子命令：

• values：查看 Chart 的默认配置（values.yaml 内容）
• chart：查看 Chart 的元数据（Chart.yaml 内容）

# 查看 bitnami/nginx 的默认配置
helm show values bitnami/nginx# 查看本地 myapp Chart 的元数据
helm show chart ./myapp

14. helm version - 查看 Helm 版本

显示 Helm 客户端版本（Helm 3 无服务端）。

# 查看 helm 版本
helm version