Helm 常用命令

一、Helm 概述

helm是kubernetes生态系统中的一个软件包管理工具，类似ubuntu的apt，centos的yum或python的pip一样，专门负责管理kubernetes应用资源；使用helm可以对kubernetes应用进行统一打包、分发、安装、升级以及回退等操作。

Helm的一般操作:文章源自小柒网-https://www.yangxingzhen.cn/8354.html

helm search: 搜索chart文章源自小柒网-https://www.yangxingzhen.cn/8354.html

helm pull: 下载chart到本地目录查看文章源自小柒网-https://www.yangxingzhen.cn/8354.html

helm install: 上传chart到Kubernetes文章源自小柒网-https://www.yangxingzhen.cn/8354.html

helm list: 列出已发布的chart文章源自小柒网-https://www.yangxingzhen.cn/8354.html

# 查看帮助文章源自小柒网-https://www.yangxingzhen.cn/8354.html

helm --help文章源自小柒网-https://www.yangxingzhen.cn/8354.html

官方文档：https://helm.sh/zh/docs/helm/helm/文章源自小柒网-https://www.yangxingzhen.cn/8354.html

二、Helm 仓库（helm repo）

添加、列出、删除、更新和索引chart仓库。文章源自小柒网-https://www.yangxingzhen.cn/8354.html

1、添加chart仓库文章源自小柒网-https://www.yangxingzhen.cn/8354.html

[root@k8s-master ~]# helm repo add bitnami https://charts.bitnami.com/bitnami

"bitnami" has been added to your repositories

2、列出已添加的仓库

[root@k8s-master ~]# helm repo list

NAME    URL                               

bitnami https://charts.bitnami.com/bitnami

3、从chart仓库中更新本地可用chart的信息

[root@k8s-master ~]# helm repo update bitnami

Hang tight while we grab the latest from your chart repositories...

...Successfully got an update from the "bitnami" chart repository

Update Complete. ⎈Happy Helming!⎈

4、删除一个或多个仓库

[root@k8s-master ~]# helm repo remove bitnami

"bitnami" has been removed from your repositories

三、创建chart（helm create）

使用给定名称创建新的chart，该命令创建chart目录和chart用到的公共文件目录。

语法格式：helm create NAME [flags]

比如'helm create test'会创建一个目录结构看起来像这样

[root@k8s-master ~]# helm create test

Creating test

[root@k8s-master ~]# tree test

test

├── charts # Charts that this chart depends on

├── Chart.yaml # Information about your chart

├── templates # The template files

│   ├── deployment.yaml

│   ├── _helpers.tpl

│   ├── hpa.yaml

│   ├── ingress.yaml

│   ├── NOTES.txt

│   ├── serviceaccount.yaml

│   ├── service.yaml

│   └── tests # The test files

│       └── test-connection.yaml

└── values.yaml # The default values for your templates

四、chart 包安装（helm install）

该命令用于安装chart包。安装参数必须是chart的引用，一个打包后的chart路径，未打包的chart目录或者是一个URL。

要重写chart中的值，使用--values参数传递一个文件或者使用--set参数在命令行传递配置，强制使用字符串要用--set-string。 当值本身对于命令行太长或者是动态生成的时候，可以使用--set-file设置独立的值。

语法格式：helm install [CHART] [flags]

helm install -f myvalues.yaml myredis ./redis

helm install --set name=prod myredis ./redis

helm install --set-string long_int=1234567890 myredis ./redis

helm install --set-file multiline-text=path/to/textfile myredis ./redis

五、管理chart依赖（helm dependency）

Helm chart将依赖存储在'charts/'。对于chart开发者，管理依赖比声明了所有依赖的'Chart.yaml'文件更容易。

依赖命令对该文件进行操作，使得存储在'charts/'目录的需要的依赖和实际依赖之间同步变得很容易。

# 比如Chart.yaml声明了两个依赖

# Chart.yaml

dependencies:

- name: nginx

    version: "1.2.3"

    repository: "https://example.com/charts"

- name: memcached

    version: "3.2.1"

    repository: "https://another.example.com/charts"

name 是chart名称，必须匹配Chart.yaml文件中名称。

version 字段应该包含一个语义化的版本或版本范围。

从2.2.0开始，仓库可以被定义为本地存储的依赖chart的目录路径。路径应该以"file://"前缀开头，比如：

# Chart.yaml

dependencies:

- name: nginx

    version: "1.2.3"

    repository: "file://../dependency_chart/nginx"

1、列举指定chart的依赖

# helm dependency list CHART

helm dependency list wordpress

2、依赖升级

基于Chart.yaml内容升级charts/

# helm dependency update CHART [flags]

helm dependency update wordpress

六、Helm 列表（helm list）

列举发布版本，该命令会列举出指定命名空间的所有发布版本，(如果没有指定命名空间，会使用当前命名空间)。

默认情况下，只会列举出部署的或者失败的发布，像--uninstalled或者--all会修改默认行为。这些参数可以组合使用：--uninstalled --failed。

默认情况下，最多返回256项，使用--max限制数量，--max设置为0不会返回所有结果，而是返回服务器默认值，可能要比256更多。 同时使用--max和--offset参数可以翻页显示。

语法格式：helm list [flags] [FILTER]

# -A显示所有

helm list -A

helm list --max=10 --offset=2 -A

# 显示指定命名空间

helm list -n wordpress

七、升级版本（helm upgrade）

该命令将发布升级到新版的chart。升级参数必须是发布和chart。chart参数可以是：chart引用('example/mariadb')，chart目录路径，打包的chart或者完整URL。 对于chart引用，除非使用'–version'参数指定，否则会使用最新版本。

语法格式：helm upgrade [RELEASE] [CHART] [flags]

helm upgrade --set version=6.2 --set appVersion=6.2 -n kube-wordpress wordpress ./wordpress

八、发布历史（helm history）

检索发布历史，打印给定版本的历史修订。默认会返回最大的256个历史版本。设置--max配置返回历史列表的最大长度。

语法格式：helm history [flags] RELEASE-NAME

历史发布集合会被打印成格式化的表格，例如：

[root@k8s-master ~]# helm history wordpress

REVISION UPDATED                  STATUS     CHART              APP VERSION DESCRIPTION     

1        Fri Nov  4 10:39:15 2022 superseded wordpress-6.1 6.1         Install complete

2        Fri Nov  4 15:13:48 2022 superseded wordpress-6.2 6.2         Upgrade complete

3        Fri Nov  4 15:13:54 2022 superseded wordpress-6.2 6.2         Upgrade complete

4        Fri Nov  4 15:14:00 2022 superseded wordpress-6.2 6.2         Upgrade complete

5        Fri Nov  4 15:14:57 2022 deployed   wordpress-6.3 6.3         Upgrade complete

九、回滚版本（helm rollback）

回滚发布到上一个版本，回滚命令的第一个参数是发布的名称，第二是修订（版本）号，如果省略此参数，会回滚到上一个版本。

语法格式：helm rollback <RELEASE> [REVISION] [flags]

# 先查看历史版本

helm history myharbor -n harbor

# 不指定版本就回退上个版本

helm rollback myharbor 1 -n harbor

helm rollback myharbor -n harbor

十、展示chart（helm show）

语法格式：helm show all [CHART] [flags]

# 该命令检查chart(目录、文件或URL)并显示所有的内容（values.yaml, Chart.yaml, README）

helm show all mysql

语法格式：helm show values [CHART] [flags]

# 该命令检查chart(目录、文件或URL)并显示values.yaml文件的内容

helm show values mysql

十一、拉取chart（helm pull）

从仓库下载并（可选）在本地目录解压。

语法格式：helm pull [chart URL | repo/chartname] [...] [flags]

# 仅下载

helm pull bitnami/redis

# 下载并解压到当前目录

helm pull bitnami/redis --untar

十二、Helm 打包（helm package）

将chart目录打包到chart归档中，该命令将chart打包成一个chart版本包文件。如果给定路径，就会在该路径中查找chart（必须包含Chart.yaml文件）然后将目录打包。

语法格式：helm package [flags] [CHART-PATH] [...]

要签名一个chart，使用--sign参数，在大多数场景中，也要提供--keyring path/to/secret/keys和--key keyname。

[root@k8s-master ~]# helm package wordpress

Successfully packaged chart and saved it to: /root/wordpress-6.3.tgz

如果想忽略helm中的文件，可以在.helmignore进行匹配，该.helmignore文件支持Unix shell全局匹配，相对路径匹配和否定（以！前缀反向匹配）。每行仅考虑一种模式。示例如下：

# .helmignore

.git

*/temp*

*/*/temp*

temp?

十三、推送chart到harbor（helm cm-push）

将chart推送到远程。

1、在线安装

helm plugin install https://github.com/chartmuseum/helm-push

2、离线安装

下载地址：https://github.com/chartmuseum/helm-push/tags

1）下载安装包

wget https://github.com/chartmuseum/helm-push/releases/tag/v0.10.3

2）查看helm的plugin路径：helm env

helm env

3）在该路径下创建helm-push文件夹，并将安装包拷贝到该文件夹下解压即可

mkdir /root/.local/share/helm/plugins/helm-push

wget https://github.com/chartmuseum/helm-push/releases/download/v0.10.3/helm-push_0.10.3_linux_amd64.tar.gz

tar xf /root/.local/share/helm/plugins/helm-push/helm-push_0.10.3_linux_amd64.tar.gz -C /root/.local/share/helm/plugins/helm-push

3、查看插件

helm plugin list

1）helm 增加harbor repo

# chartrepo为固定参数，wordpress为自定义项目

helm repo add harbor http://10.10.50.24/chartrepo/wordpress --username=admin --password=Aa123456

4）示例演示

# 查看帮助

helm cm-push --help

# 推送目录

helm cm-push wordpress/ harbor --host=10.10.50.24 --username=admin --password=Aa123456

# 推送压缩包

helm cm-push wordpress-6.3.tgz harbor --host=10.10.50.24 --username=admin --password=Aa123456

# 推送指定版本，--version

helm cm-push wordpress/ --version="6.3" harbor --host=10.10.50.24 --username=admin --password=Aa123456

# 强制推送--force

helm cm-push --force wordpress-6.3.tgz harbor --host=10.10.50.24 --username=admin --password=Aa123456

十四、搜索 hub（helm search hub）

在Artifact Hub或自己的hub实例中搜索chart。Artifact Hub 是基于web页面的应用，支持CNCF项目的查找、安装和发布包及配置项，包括了公开发布的Helm chart。它是CNCF的沙盒项目。可以访问https://artifacthub.io/

语法格式：helm search [keyword] [flags]

# 不带参数，列出所有

helm search hub

# 指定chart

helm search hub mysql

十五、搜索仓库（helm search repo）

用chart中关键字搜索仓库，搜索会读取系统上配置的所有仓库，并查找匹配。搜索这些仓库会使用存储在系统中的元数据。它会展示找到最新稳定版本的chart。如果指定了--devel参数，输出会包括预发布版本。

# Search for stable release versions matching the keyword "nginx"

[root@k8s-master ~]# helm search repo nginx

# Search for release versions matching the keyword "nginx", including pre-release versions

[root@k8s-master ~]# helm search repo nginx --devel

# Search for the latest stable release for nginx with a major version of 13

[root@k8s-master ~]# helm search repo nginx --version 13.2.13

十六、验证chart（helm lint）

该命令使用一个chart路径并运行一系列的测试来验证chart的格式是否正确。如果遇到引起chart安装失败的情况，会触发[ERROR]信息，如果遇到违反惯例或建议的问题，会触发[WARNING]。

语法格式：helm lint PATH [flags]

[root@k8s-master ~]# helm lint wordpress

十七、常用命令总结

helm version # 查看helm版本

helm create wordpress # 创建一个xxx charts

helm lint wordpress # 检查包的格式或信息是否有问题

helm install wordpress wordpress # 部署安装wordpress，设置名称为wordpress

helm list # 列出已经部署的charts

helm history # 发布历史

helm upgrade # 更新版本

helm rollback # 回滚版本

helm package wordpress # 打包charts

helm repo add --username admin --password password harbor xxx  # 增加repo

helm uninstall wordpress # 卸载删除wordpress

helm pull # 拉取chart包

helm cm-push # 推送chart包

helm repo update # 更新仓库资源

helm search hub # 从 Artifact Hub 中查找并列出helm charts。 Artifact Hub中存放了大量不同的仓库

helm search repo # 从你添加（使用 helm repo add）到本地helm客户端中的仓库中进行查找。该命令基于本地数据进行搜索，无需连接互联网