helm--helm常用操作


部署Kubernetes應用

獲取chart

獲取版本為0.2.8的mysql並解壓縮包:

$ helm fetch stable/mysql --version 0.2.8 --untar
$ ls mysql/
Chart.yaml README.md templates values.yaml


利用helm lint命令檢查下載的chart是否存在問題:

$ helm lint mysql
==> Linting mysql
Lint OK
1 chart(s) linted, no failures

 

創建chart

利用helm create mychart命令創建一個mychart目錄:

$ helm create mychart
Creating mychart


生成的mychart的文件結構如下:

mychart/
|-- charts
|-- Chart.yaml
|-- templates
|   |-- deployment.yaml
|   |-- _helpers.tpl
|   |-- ingress.yaml
|   |-- NOTES.txt
|   `-- service.yaml
`-- values.yaml

2 directories, 7 files



生成chart目錄里有Chart.yaml, values.yaml 與 NOTES.txt等文件,下面分別對chart中幾個重要文件解釋:
Chart.yaml 包含了chart的meta

  • data,描述了Chart名稱、描述信息與版本。
  • values.yaml:存儲了模板文件變量。
  • templates/:記錄了全部模板文件。
  • charts/:依賴chart存儲路徑。
  • NOTES.txt:給出了部署后的信息,例如如何使用chart、列出默認的設置等等。


chart安裝有以下幾種方式:

  • 指定chart: helm install stable/mariadb
  • 指定打包的chart: helm install ./nginx-1.2.3.tgz
  • 指定打包目錄: helm install ./nginx
  • 指定chart包URL: helm install https://example.com/charts/nginx-1.2.3.tgz
  • 將當前目錄打包為tgz:  helm package -d tardest 待壓縮chart1 待壓縮chart2


覆蓋chart中的默認值,通過指定配置文件方式:

helm install -f myvalues.yaml ./redis


或者通過–set key=value形式:

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


安裝release名稱為mysql例子如下,請注意NOTES中對Mysql的使用說明:

$ helm install -n mysql -f mysql/values.yaml --set resources.requests.memory=512Mi mysql
NAME: mysql
LAST DEPLOYED: Thu Sep 14 05:48:31 2017
NAMESPACE: default
STATUS: DEPLOYED

RESOURCES:
==> v1beta1/Deployment
NAME DESIRED CURRENT UP-TO-DATE AVAILABLE AGE
mysql-mysql 1 1 1 0 0s

==> v1/Secret
NAME TYPE DATA AGE
mysql-mysql Opaque 2 0s

==> v1/ConfigMap
NAME DATA AGE
mysql-configmap 1 0s

==> v1/PersistentVolumeClaim
NAME STATUS VOLUME CAPACITY ACCESSMODES STORAGECLASS AGE
mysql-mysql Pending 0s

==> v1/Service
NAME CLUSTER-IP EXTERNAL-IP PORT(S) AGE
mysql-mysql 10.98.221.43 <none> 3306/TCP 0s



NOTES:
MySQL can be accessed via port 3306 on the following DNS name from within your cluster:
mysql-mysql.default.svc.cluster.local

To get your root password run:

kubectl get secret --namespace default mysql-mysql -o jsonpath="{.data.mysql-root-password}" | base64 --decode; echo

To connect to your database:
Run an Ubuntu pod that you can use as a client:

kubectl run -i --tty ubuntu --image=ubuntu:16.04 --restart=Never -- bash -il
Install the mysql client:

$ apt-get update && apt-get install mysql-client -y
Connect using the mysql cli, then provide your password:
$ mysql -h mysql-mysql -p
View Code

 


通過helm status查看release狀態:

$ helm status mysql
LAST DEPLOYED: Tue Sep 12 07:31:49 2017
NAMESPACE: default
STATUS: DEPLOYED


或通過helm list -a查看全部的release,tag “-a”是查看全部的release,包括已部署、部署失敗、正在刪除、已刪除release等。

$ helm list -a
$ helm list -a | grep mysqlmysql           1       Tue Sep 12 07:31:49 2017 DEPLOYED mysql-0.2.8         default

 

更新release

Helm使用helm upgrade更新已安裝的release:

$ helm upgrade mysql -f mysql/values.yaml --set resources.requests.memory=1024Mi mysql


查看指定release的歷史部署版本信息:

$ helm hist  mysql
REVISION    UPDATED                        STATUS           CHART          DESCRIPTION
1           Tue Sep 12 07:31:49 2017       SUPERSEDED       mysql-0.2.8    Install complete
2           Tue Sep 12 07:44:00 2017       DEPLOYED         mysql-0.2.8    Upgrade complete


查看指定release的歷史版本部署時部分配置信息,以resources.requests.memory為例,符合查看部署符合預期:即第一次部署resources.requests.memory設置為512Mi,第二次的升級resources.requests.memory設置為1024Mi:

$ helm get --revision 1 mysql
resources:
requests:
cpu: 100m
memory: 512Mi

$ helm get --revision 2 mysql
resources:
requests:
cpu: 100m
memory: 1024Mi

 

版本回滾

回滾到第一次的版本:

helm rollback --debug mysql 1
[debug] Created tunnel using local port: '60303'
[debug] SERVER: "localhost:60303"
Rollback was a success! Happy Helming!


查看mysql release的版本信息,當前已經回滾到REVISION為1的版本:

$ helm hist mysql
REVISION           UPDATED                    STATUS        CHART          DESCRIPTION
1                  Tue Sep 12 07:31:49 2017   SUPERSEDED    mysql-0.2.8    Install complete
2                  Tue Sep 12 07:44:00 2017   SUPERSEDED    mysql-0.2.8    Upgrade complete
3                  Tue Sep 12 08:50:48 2017   DEPLOYED      mysql-0.2.8    Rollback to 1

 

刪除chart

利用helm delete命令刪除一個chart:

$ helm delete mysql
release "mysql" deleted


確認chart是否刪除:

$ helm ls -a mysql
NAME     REVISION      UPDATED                     STATUS      CHART           NAMESPACE
mysql    3             Tue Sep 12 08:50:48 2017    DELETED     mysql-0.2.8     default


即使刪除的chart,其發布的歷史信息還是繼續被保存。

$ helm hist mysql
REVISION      UPDATED                     STATUS         CHART          DESCRIPTION
1             Tue Sep 12 07:31:49 2017    SUPERSEDED     mysql-0.2.8    Install complete
2             Tue Sep 12 07:44:00 2017    SUPERSEDED     mysql-0.2.8    Upgrade complete
3             Tue Sep 12 08:50:48 2017    DELETED        mysql-0.2.8    Deletion complete


可以恢復一個已經刪除的release:

$ helm rollback --debug mysql 2
[debug] Created tunnel using local port: '37413'
[debug] SERVER: "localhost:37413"
Rollback was a success! Happy Helming!


如果希望徹底刪除一個release,可以用如下命令:

$ helm delete --purge mysql
release "mysql" deleted


再次查看剛被刪除的mysql release,提示已經無法找到,符合預期:

$ helm hist mysql
Error: release: "mysql" not found

 

Helm對release的版本管理

在上面例子中,已經展示了Helm對release的非常強大的版本管理功能,比如通過”helm list -a”查看有哪些release,通過” helm hist“查看某一個具體的release發布過的歷史版本,以及通過” helm get --revision”,查看某個release的一次歷史版本對應的具體應用配置信息等。即使已經被刪除的release仍然有記錄,並且通過Helm能夠快速回滾到已刪除release的某個發布過的歷史版本。Helm的這些版本管理功能,Kubernetes原生並不支持。


 

Helm倉庫

任何 HTTP Server 都可以用作 chart 倉庫,下面演示在 k8s-node1 172.28.2.211 上搭建倉庫。

詳見K8S脈絡整理(015)-Helm包管理器\示例\創建自己的chart

1、node1啟動一個 httpd 容器

mkdir /var/www
docker run -d -p 8080:80 -v /var/www/:/usr/local/apache2/htdocs/ httpd

2、通過 helm package 將 mychart 打包。

helm package -d ./ mychart
mv mychart-0.1.0.tgz myrepo/
helm repo index myrepo/ --url http://172.28.2.211:8080/charts

3、將 mychart-0.1.0.tgz 和 index.yaml 上傳到 node1 的 /var/www/charts 目錄。

scp root@172.28.2.210:/home/daweij/helm/myrepo/* /var/www/charts/

4、通過 helm repo add 將新倉庫添加到 Helm。倉庫命名為 newrepo

helm repo add newrepo http://172.28.2.211:8080/charts
daweij@master:~/helm$ helm repo list
NAME       URL                                             
stable     https://kubernetes-charts.storage.googleapis.com
local      http://127.0.0.1:8879/charts                    
newrepo    http://172.28.2.211:8080/charts 

5、Helm可以 repo search 到 mychart ,或直接使用安裝

helm search newrepo/mychart
helm install newrepo/mychart
如果以后倉庫添加了新的 chart,需要用 helm repo update 更新本地的 index。

其他常用命令

刪除
helm delete --purge release-name 更新 helm upgrade release-name chart-dest-name
查看
helm list
 



免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM