部署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
通過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