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

更多推荐