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
 


posted @ 2018-04-24 11:03  Cslc-DaweiJ  阅读(5211)  评论(0编辑  收藏