一、概述
Helm 針對(duì)Kubernetes的Helm包管理器。Helm的一般操作：
- helm search: ??搜索chart
- helm pull: ???下載chart到本地目錄查看
- helm install: ??上傳chart到Kubernetes
- helm list: ????列出已發(fā)布的chart
官方文檔：https://helm.sh/zh/docs/helm/helm/
Helm 架構(gòu)和基礎(chǔ)語(yǔ)法講解可以參考我這篇文章：【云原生】Helm 架構(gòu)和基礎(chǔ)語(yǔ)法詳解
二、Helm 倉(cāng)庫(kù)（helm repo）
添加、列出、刪除、更新和索引chart倉(cāng)庫(kù)。
1）添加chart倉(cāng)庫(kù)
helm repo add bitnami https://charts.bitnami.com/bitnami
2）列出已添加的倉(cāng)庫(kù)
3）從chart倉(cāng)庫(kù)中更新本地可用chart的信息
4）刪除一個(gè)或多個(gè)倉(cāng)庫(kù)
三、創(chuàng)建chart（helm create）
使用給定名稱(chēng)創(chuàng)建新的chart，該命令創(chuàng)建chart目錄和chart用到的公共文件目錄。
比如'helm create foo'會(huì)創(chuàng)建一個(gè)目錄結(jié)構(gòu)看起來(lái)像這樣：
$ helm create foo
foo/
├── .helmignore # Contains patterns to ignore when packaging Helm charts.
├── Chart.yaml # Information about your chart
├── values.yaml # The default values for your templates
├── charts/ # Charts that this chart depends on
└── templates/ # The template files
└── tests/ # The test files
四、chart 包安裝（helm install）
該命令用于安裝chart包。安裝參數(shù)必須是chart的引用，一個(gè)打包后的chart路徑，未打包的chart目錄或者是一個(gè)URL。
要重寫(xiě)chart中的值，使用--values參數(shù)傳遞一個(gè)文件或者使用--set參數(shù)在命令行傳遞配置，強(qiáng)制使用字符串要用--set-string。當(dāng)值本身對(duì)于命令行太長(zhǎng)或者是動(dòng)態(tài)生成的時(shí)候，可以使用--set-file設(shè)置獨(dú)立的值。
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 my_script=dothings.sh myredis ./redis
五、管理chart依賴(lài)（helm dependency）
- Helm chart將依賴(lài)存儲(chǔ)在'charts/'。對(duì)于chart開(kāi)發(fā)者，管理依賴(lài)比聲明了所有依賴(lài)的'Chart.yaml'文件更容易。
- 依賴(lài)命令對(duì)該文件進(jìn)行操作，使得存儲(chǔ)在'charts/'目錄的需要的依賴(lài)和實(shí)際依賴(lài)之間同步變得很容易。
比如Chart.yaml聲明了兩個(gè)依賴(lài)：
# 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名稱(chēng)，必須匹配Chart.yaml文件中名稱(chēng)。
- version 字段應(yīng)該包含一個(gè)語(yǔ)義化的版本或版本范圍。
從2.2.0開(kāi)始，倉(cāng)庫(kù)可以被定義為本地存儲(chǔ)的依賴(lài)chart的目錄路徑。路徑應(yīng)該以"file://"前綴開(kāi)頭，比如：
# Chart.yaml
dependencies:
- name: nginx
version: "1.2.3"
repository: "file://../dependency_chart/nginx"
1）列舉指定chart的依賴(lài)
# helm dependency list CHART
helm dependency list wordpress
2）依賴(lài)升級(jí)
基于Chart.yaml內(nèi)容升級(jí)charts/
# helm dependency update CHART [flags]
helm dependency update wordpress
六、Helm 列表（helm list）
- 列舉發(fā)布版本，該命令會(huì)列舉出指定命名空間的所有發(fā)布版本，(如果沒(méi)有指定命名空間，會(huì)使用當(dāng)前命名空間)。
- 默認(rèn)情況下，只會(huì)列舉出部署的或者失敗的發(fā)布，像--uninstalled或者--all會(huì)修改默認(rèn)行為。這些參數(shù)可以組合使用：--uninstalled --failed。
- 默認(rèn)情況下，最多返回256項(xiàng)，使用--max限制數(shù)量，--max設(shè)置為0不會(huì)返回所有結(jié)果，而是返回服務(wù)器默認(rèn)值，可能要比256更多。同時(shí)使用--max和--offset參數(shù)可以翻頁(yè)顯示。
# -A顯示所有
helm list --max=10 --offset=2 -A
七、升級(jí)版本（helm upgrade）
該命令將發(fā)布升級(jí)到新版的chart。升級(jí)參數(shù)必須是發(fā)布和chart。chart參數(shù)可以是：chart引用('example/mariadb')，chart目錄路徑，打包的chart或者完整URL。對(duì)于chart引用，除非使用'--version'參數(shù)指定，否則會(huì)使用最新版本。
helm upgrade --set foo=bar --set foo=newbar redis ./redis
八、發(fā)布?xì)v史（helm history）
檢索發(fā)布?xì)v史，打印給定版本的歷史修訂。默認(rèn)會(huì)返回最大的256個(gè)歷史版本。設(shè)置--max配置返回歷史列表的最大長(zhǎng)度。
歷史發(fā)布集合會(huì)被打印成格式化的表格，例如：
$ helm history angry-bird
REVISION UPDATED STATUS CHART APP VERSION DESCRIPTION
1 Mon Oct 3 10:15:13 2016 superseded alpine-0.1.0 1.0 Initial install
2 Mon Oct 3 10:15:13 2016 superseded alpine-0.1.0 1.0 Upgraded successfully
3 Mon Oct 3 10:15:13 2016 superseded alpine-0.1.0 1.0 Rolled back to 2
4 Mon Oct 3 10:15:13 2016 deployed alpine-0.1.0 1.0 Upgraded successfully
九、回滾版本（helm rollback）
回滾發(fā)布到上一個(gè)版本，回滾命令的第一個(gè)參數(shù)是發(fā)布的名稱(chēng)，第二是修訂（版本）號(hào)，如果省略此參數(shù)，會(huì)回滾到上一個(gè)版本。
# helm rollback <RELEASE> [REVISION] [flags]
# 先查看歷史版本
helm history myharbor -n harbor
# 不指定版本就回退上個(gè)版本
helm rollback myharbor 1 -n harbor
helm rollback myharbor -n harbor
十、展示chart（helm show）
# helm show all [CHART] [flags]
# 該命令檢查chart(目錄、文件或URL)并顯示所有的內(nèi)容（values.yaml, Chart.yaml, README）
helm show all mysql
# helm show values [CHART] [flags]
# 該命令檢查chart(目錄、文件或URL)并顯示values.yaml文件的內(nèi)容
helm show values mysql
十一、拉取chart（helm pull）
從倉(cāng)庫(kù)下載并（可選）在本地目錄解壓。
# helm pull [chart URL | repo/chartname] [...] [flags]
# 僅下載
helm pull bitnami/redis
# 下載并解壓到當(dāng)前目錄
helm pull bitnami/redis --untar
十二、Helm 打包（helm package）
- 將chart目錄打包到chart歸檔中，該命令將chart打包成一個(gè)chart版本包文件。如果給定路徑，就會(huì)在該路徑中查找chart（必須包含Chart.yaml文件）然后將目錄打包。
- 要簽名一個(gè)chart，使用--sign參數(shù)，在大多數(shù)場(chǎng)景中，也要提供--keyring path/to/secret/keys和--key keyname。
helm package mysql/
# Successfully packaged chart and saved it to: /opt/k8s/helm/mysql-9.3.1.tgz
如果想忽略helm中的文件，可以在.helmignore進(jìn)行匹配，該.helmignore文件支持Unix shell全局匹配，相對(duì)路徑匹配和否定（以！前綴反向匹配）。每行僅考慮一種模式。示例如下：
# .helmignore
.git
*/temp*
*/*/temp*
temp?
十三、推送chart到harbor（helm cm-push）
將chart推送到遠(yuǎn)程。
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、在該路徑下創(chuàng)建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 zxvf /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 增加harbor repo
# chartrepo，固定參數(shù)，bigdata自定義項(xiàng)目
helm repo add local-harbor --username=admin --password=Harbor12345 https://myharbor.com/chartrepo/bigdata/ --ca-file /opt/k8s/helm/ca.crt
證書(shū)直接在harbor上下載
4）示例演示
# 查看幫助
helm cm-push --help
# 推送，接【目錄】
helm cm-push mysql/ local-harbor --ca-file /opt/k8s/helm/ca.crt
# 推送，接【壓縮包】
helm cm-push wordpress-15.1.5.tgz local-harbor --ca-file /opt/k8s/helm/ca.crt
# 推送，指定版本，--version
helm cm-push mychart/ --versinotallow="1.2.3" local-harbor --ca-file /opt/k8s/helm/ca.crt
# 強(qiáng)制推送，--force
helm cm-push --force mychart-0.3.2.tgz local-harbor
查看
十四、搜索 hub（helm search hub）
在Artifact Hub或自己的hub實(shí)例中搜索chart。Artifact Hub 是基于web頁(yè)面的應(yīng)用，支持CNCF項(xiàng)目的查找、安裝和發(fā)布包及配置項(xiàng)，包括了公開(kāi)發(fā)布的Helm chart。它是CNCF的沙盒項(xiàng)目?？梢栽L問(wèn)https://artifacthub.io/
# 不帶參數(shù)，列出所有
helm search hub
# 指定chart
helm search hub mysql
十五、搜索倉(cāng)庫(kù)（helm search repo）
用chart中關(guān)鍵字搜索倉(cāng)庫(kù)，搜索會(huì)讀取系統(tǒng)上配置的所有倉(cāng)庫(kù)，并查找匹配。搜索這些倉(cāng)庫(kù)會(huì)使用存儲(chǔ)在系統(tǒng)中的元數(shù)據(jù)。它會(huì)展示找到最新穩(wěn)定版本的chart。如果指定了--devel參數(shù)，輸出會(huì)包括預(yù)發(fā)布版本。
# Search for stable release versions matching the keyword "nginx"
$ helm search repo nginx
# Search for release versions matching the keyword "nginx", including pre-release versions
$ helm search repo nginx --devel
# Search for the latest stable release for nginx-ingress with a major version of 1
$ helm search repo nginx-ingress --version ^1.0.0
十六、驗(yàn)證chart（helm lint）
該命令使用一個(gè)chart路徑并運(yùn)行一系列的測(cè)試來(lái)驗(yàn)證chart的格式是否正確。如果遇到引起chart安裝失敗的情況，會(huì)觸發(fā)[ERROR]信息，如果遇到違反慣例或建議的問(wèn)題，會(huì)觸發(fā)[WARNING]。
# helm lint PATH [flags]
helm lint ./mysql
十七、常用命令總結(jié)
helm version // 查看helm版本
helm create xxx // 創(chuàng)建一個(gè)xxx charts
helm lint ./xxx // 檢查包的格式或信息是否有問(wèn)題
helm install xxx1 ./xxx // 部署安裝xxx，設(shè)置名稱(chēng)為xxx1
helm list // 列出已經(jīng)部署的charts
helm history // 發(fā)布?xì)v史
helm upgrade // 更新版本
helm rollback // 回滾版本
helm package ./xxx // 打包c(diǎn)harts
helm repo add --username admin --password password myharbor xxx // 增加repo
helm uninstall xxx1 // 卸載刪除xxx1
helm pull // 拉取chart包
helm cm-push // 推送chart包
helm repo update // 更新倉(cāng)庫(kù)資源
helm search hub // 從 Artifact Hub 中查找并列出 helm charts。Artifact Hub中存放了大量不同的倉(cāng)庫(kù)
helm search repo // 從你添加（使用 helm repo add）到本地 helm 客戶端中的倉(cāng)庫(kù)中進(jìn)行查找。該命令基于本地?cái)?shù)據(jù)進(jìn)行搜索，無(wú)需連接互聯(lián)網(wǎng)
Helm 常用命令（chart 安裝、升級(jí)、回滾、卸載等操作）就先到這里。
