docker筆記36-helm入門

czxin788發表於2018-10-18

    在k8s中,我們對無狀態應用如nginx、myapp,我們可以使用deployment控制器進行伸縮非常容易。

    對於有狀態應用比如tomcat、redis、etcd單一例項應用,我們使用deployment限制它只有一個例項,其實也是沒有任何問題的。

    但是,對於有狀態應用的多例項,比如redis主從,就不那麼容易了。

    helm是k8s的另外一個專案,相當於linux的yum。

    我們知道,在yum 倉庫中,yum不光要解決包之間的依賴關係,還要提供具體的程式包。但是helm倉庫裡面只有配置清單檔案,而沒有映象,映象還是由映象倉庫來提供,比如hub.docker.com、私有倉庫等。

    也就是說,helm提供了一個應用所需要的所有清單檔案。比如對於一個nginx,我們需要一個deployment的清單檔案、一個service的清單檔案、一個hpa的清單檔案。我們把這三個檔案打包到一起,就是一個應用程式的程式包,我們稱之為Chart。

    一般來說,Chart是一個helm程式包,其實質只是一個模板,我們可以對這個模板進行賦值(value),而形成我們自定義的清單檔案,也就實現我們生產個性化的需求。這樣的倉庫叫Chart倉庫(其實就是一個https/http伺服器)。

    Helm把Kubernetes資源(比如deployments、services或 ingress等) 打包到一個chart中,而chart被儲存到chart倉庫。透過chart倉庫可用來儲存和分享chart。

    helm是工作在k8s叢集之外的。helm不直接操作apiserver,而是和Tiller互動。Tlller再和apiserver互動,最後由Apiserver把chart使用config賦值(值檔案),最後部署成為release。

    在helm工作中,helm先去檢查chart是否存在,存在就把chart下載到helm本機當前使用者的家目錄下。然後helm把chart交給tiller,tiller再和api server互動。api server一旦把chart部署在k8s叢集上,就不再叫chart了,而叫release。

    所以,一個chart賦值不同,完全可以部署出多個release出來的,所以我們可以把chart看做是一個安裝包的模板。

    如果發現chart更新了,helm就自動滾動更新,而且helm還支援一鍵回滾的操作。

安裝helm伺服器

    helm是安裝在k8s叢集之外的伺服器上的。

    可以到如下連結下載helm的安裝包:

    

    下載下來後,就是個helm命令,可以直接用:

[root@master linux-amd64]# mv helm /usr/bin/
[root@master linux-amd64]# helm -h
The Kubernetes package manager
To begin working with Helm, run the 'helm init' command:
$ helm init
This will install Tiller to your running Kubernetes cluster.
It will also set up any necessary local configuration.
Common actions from this point include:
- helm search:    search for charts
- helm fetch:     download a chart to your local directory to view
- helm install:   upload the chart to Kubernetes
- helm list:      list releases of charts
Environment:
  $HELM_HOME          set an alternative location for Helm files. By default, these are stored in ~/.helm
  $HELM_HOST          set an alternative Tiller host. The format is host:port
  $HELM_NO_PLUGINS    disable plugins. Set HELM_NO_PLUGINS=1 to disable plugins.
  $TILLER_NAMESPACE   set an alternative Tiller namespace (default "kube-system")
  $KUBECONFIG         set an alternative Kubernetes configuration file (default "~/.kube/config")

    我們看到helm部署好了,就是這麼簡單粗暴。

配置rbac

    rbac配置檔案樣例:

[root@master helm]# cat tiller-rbac.yaml 
apiVersion: v1
kind: ServiceAccount
metadata:
  name: tiller
  namespace: kube-system
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: tiller
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: cluster-admin
subjects:
  - kind: ServiceAccount
    name: tiller
    namespace: kube-system
[root@master helm]# kubectl apply -f tiller-rbac.yaml 
serviceaccount/tiller created
clusterrolebinding.rbac.authorization.k8s.io/tiller created
[root@master helm]# kubectl get sa  -n kube-system |grep tiller
tiller                               1         21m

 部署Tiller

[root@master helm]# export NO_PROXY='172.16.0.0/16,127.0.0.0/0' #做過linux代理的可以加這個,不是可以不加這個環境變數
[root@master helm]#  helm init --service-account tiller
Creating /root/.helm 
Creating /root/.helm/repository 
Creating /root/.helm/repository/cache 
Creating /root/.helm/repository/local 
Creating /root/.helm/plugins 
Creating /root/.helm/starters 
Creating /root/.helm/cache/archive 
Creating /root/.helm/repository/repositories.yaml 
Adding stable repo with URL: 
Adding local repo with URL: 
$HELM_HOME has been configured at /root/.helm.
Tiller (the Helm server-side component) has been installed into your Kubernetes Cluster.
Please note: by default, Tiller is deployed with an insecure 'allow unauthenticated users' policy.
For more information on securing your installation see: https://docs.helm.sh/using_helm/#securing-your-helm-installation
Happy Helming!

 

    由於 Helm 預設會去 storage.googleapis.com 拉取映象,如果你當前執行的機器不能訪問該域名的話可以使用以下命令來安裝:

[root@master helm]# helm init --upgrade --tiller-image registry.cn-hangzhou.aliyuncs.com/google_containers/tiller:v2.9.1 --stable-repo-url 

    看到tiller 的pod已經執行起來了:

[root@master helm]# kubectl get pods -n kube-system -o wide |grep tiller
tiller-deploy-759cb9df9-t6b2l           1/1       Running   0          18m       10.244.2.89    node2

    看到helm可以工作,並能和k8s叢集連線起來了。

[root@master ~]# helm version

Client: &version.Version{SemVer:"v2.9.1", GitCommit:"20adb27c7c5868466912eebdf6664e7390ebe710", GitTreeState:"clean"}

Server: &version.Version{SemVer:"v2.9.1", GitCommit:"20adb27c7c5868466912eebdf6664e7390ebe710", GitTreeState:"clean"}

使用helm

     1、更改helm倉庫源

    helm預設使用的helm源地址是 更改方法如下:

[root@master ~]# helm repo remove stable 
"stable" has been removed from your repositories
[root@master ~]# helm repo add stable 
"stable" has been added to your repositories

    2、檢視本地可用helm源

[root@master ~]# helm repo list
NAME  URL                                                   
local                          
stable  

    3、更新helm倉庫

[root@master ~]# helm repo update
Hang tight while we grab the latest from your chart repositories...
...Skip local chart repository
...Successfully got an update from the "stable" chart repository
Update Complete. ⎈ Happy Helming!⎈

      3.在倉庫中搜尋

[root@master ~]# helm search  #列出helm倉庫中所有可用的應用
[root@master ~]# helm search mysql #過濾操作
NAME                         CHART VERSIONAPP VERSIONDESCRIPTION                                       
stable/mysql                 0.3.5                   Fast, reliable, scalable, and easy to use open-...
stable/percona               0.3.0                   free, fully compatible, enhanced, open source d...
stable/percona-xtradb-cluster0.0.2        5.7.19     free, fully compatible, enhanced, open source d...
stable/gcloud-sqlproxy       0.2.3                   Google Cloud SQL Proxy                            
stable/mariadb               2.1.6        10.1.31    Fast, reliable, scalable, and easy to use open-...

     4、檢視應用詳細資訊

[root@master ~]# helm inspect stable/mysql

   注意:上面的stable是倉庫的名字,透過helm repo list顯示的就是

     5、helm源

    

    6、用helm安裝軟體包

[root@master ~]# helm install --name mysql1  stable/mysql

--name:指定release名字

    7、檢視安裝的軟體包

[root@master ~]# helm list
NAME  REVISIONUPDATED                 STATUS  CHART      NAMESPACE
mysql11       Wed Oct 17 04:50:58 2018DEPLOYEDmysql-0.3.5default

    8、解除安裝安裝的軟體包

[root@master ~]# helm delete mysql1
release "mysql1" deleted

     9、總結

    helm常用命令
        release管理:
            install
            delete
            upgrade/rollback
            list
            history 檢視release歷史版本
            status 獲取release狀態資訊
        chart管理:
            create  #建立一個chart,生成基礎chart示例性檔案,供我們修改用
            fetch  下載倉庫中的一個char到本地
            get
            inspect
            package
            verify

    10、helm把安裝包會預設下載到當前使用者的家目錄下

    在我們install或者fetch時,都會把安裝包下載到當前使用者的家目錄下:

[root@master archive]# ll /root/.helm/cache/archive/
total 8
-rw-r--r-- 1 root root 5536 Oct 17 04:50 mysql-0.3.5.tgz

    11、修改chart裡面的values.yaml,實現個性化安裝

[root@master archive]# cd /root/.helm/cache/archive
[root@master archive]# ls
mysql-0.3.5.tgz
[root@master archive]# tar -xvf mysql-0.3.5.tgz
[root@master archive]# tree  mysql
mysql
├── Chart.yaml #描述chart的
├── README.md
├── templates #模板檔案
│   ├── configmap.yaml
│   ├── deployment.yaml
│   ├── _helpers.tpl
│   ├── NOTES.txt
│   ├── pvc.yaml
│   ├── secrets.yaml
│   └── svc.yaml
└── values.yaml  #自己修改這個檔案的相應引數,可以自定義安裝包的內容

      如果我們有個性化的安裝需求,我們可以改values.yaml檔案的內容,這個檔案放在哪個位置都行,改完後:

[root@master mysql]# helm install --name mysql1 -f /root/values.yaml stable/mysql

  注:--name指定的是自定義release名字。    

    12、檢視部署後的提示資訊

    用helm部署完應用包後,會有很多提示資訊,這些提示資訊非常重要,但是如果你沒有及時記錄,有沒有辦法再檢視呢。答案是有的,透過以下辦法找到他們:

[root@master ~]# helm status mysql1
LAST DEPLOYED: Wed Oct 17 04:50:58 2018
NAMESPACE: default
STATUS: DEPLOYED
RESOURCES:
==> v1/Service
NAME          TYPE       CLUSTER-IP     EXTERNAL-IP  PORT(S)   AGE
mysql1-mysql  ClusterIP  10.110.40.169  <none>       3306/TCP  15h
==> v1beta1/Deployment
NAME          DESIRED  CURRENT  UP-TO-DATE  AVAILABLE  AGE
mysql1-mysql  1        1        1           0          15h
==> v1/Pod(related)
NAME                           READY  STATUS   RESTARTS  AGE
mysql1-mysql-7b7f7ffcd5-vrs9d  0/1    Pending  0         15h
==> v1/Secret
NAME          TYPE    DATA  AGE
mysql1-mysql  Opaque  2     15h
==> v1/PersistentVolumeClaim
NAME          STATUS   VOLUME  CAPACITY  ACCESS MODES  STORAGECLASS  AGE
mysql1-mysql  Pending  15h
NOTES:
MySQL can be accessed via port 3306 on the following DNS name from within your cluster:
mysql1-mysql.default.svc.cluster.local
To get your root password run:
    MYSQL_ROOT_PASSWORD=$(kubectl get secret --namespace default mysql1-mysql -o jsonpath="{.data.mysql-root-password}" | base64 --decode; echo)
To connect to your database:
1. Run an Ubuntu pod that you can use as a client:
    kubectl run -i --tty ubuntu --image=ubuntu:16.04 --restart=Never -- bash -il
2. Install the mysql client:
    $ apt-get update && apt-get install mysql-client -y
3. Connect using the mysql cli, then provide your password:
    $ mysql -h mysql1-mysql -p
To connect to your database directly from outside the K8s cluster:
    MYSQL_HOST=127.0.0.1
    MYSQL_PORT=3306
    # Execute the following commands to route the connection:
    export POD_NAME=$(kubectl get pods --namespace default -l "app=mysql1-mysql" -o jsonpath="{.items[0].metadata.name}")
    kubectl port-forward $POD_NAME 3306:3306
    mysql -h ${MYSQL_HOST} -P${MYSQL_PORT} -u root -p${MYSQL_ROOT_PASSWORD}

  建立可用自定義chart 

    1、下載倉庫中的一個chart到本地

[root@master helm]# helm fetch stable/mysql
[root@master helm]# ls
mysql-0.3.5.tgz
[root@master helm]#

     2、檢視chart的目錄結構

[root@master helm]# tree mysql
mysql
├── Chart.yaml #做個整個chart初始化的,用來對外表明自己的後設資料資訊,記錄當前chart的版本、名稱、維護者、內部的維護資訊等
├── README.md #這是markdown格式的文字檔案,這是個自述檔案,說明這個chart是怎麼開發等內容的介紹
|-----requirements.yaml:當前chart是否依賴其他chart,這個檔案是可選的。
├── templates #所有的模板檔案,這些檔案是可以複用的,要熟悉go語言才好
│   ├── configmap.yaml
│   ├── deployment.yaml
│   ├── _helpers.tpl
│   ├── NOTES.txt #提供給使用者的最終顯示資訊
│   ├── pvc.yaml
│   ├── secrets.yaml
│   └── svc.yaml
└── values.yaml  #主要為template模板中自定義屬性設定預設值的
|------ charts/ #裡面放置的是當前chart所要依賴的其他chart,這個是可選的
1 directory, 10 files

    可用檢視chart官方手冊,來了解每專案的含義:

https://docs.helm.sh/developing_charts/#charts

  3、用helm生成基礎chart示例性檔案

[root@master helm]# helm create myapp
Creating myapp

注:myapp是chart的名字

[root@master helm]# tree myapp/
myapp/
├── charts
├── Chart.yaml
├── templates
│   ├── deployment.yaml
│   ├── _helpers.tpl
│   ├── ingress.yaml
│   ├── NOTES.txt
│   └── service.yaml
└── values.yaml

   4、做語法檢查

[root@master helm]# ls
myapp
[root@master helm]# helm lint myapp
==> Linting myapp
[INFO] Chart.yaml: icon is recommended
1 chart(s) linted, no failures

    5、打包

[root@master helm]# ls
myapp  
[root@master helm]# helm package myapp/
Successfully packaged chart and saved it to: /root/helm/myapp-0.1.0.tgz
  
[root@master helm]# ls
myapp  myapp-0.1.0.tgz

    看到把myapp打包成了myapp-0.1.0.tgz

    6、啟動8879倉庫的服務

[root@master helm]# helm repo list
NAME  URL                                                   
local                          
stable
[root@master helm]# helm serve
Regenerating index. This may take a moment.
Now serving you on 127.0.0.1:8879

  7、檢視local倉庫裡面是否有我們創建立的chart包

[root@master ~]# helm search myapp
NAME       CHART VERSIONAPP VERSIONDESCRIPTION                
local/myapp0.1.0        1.0        A Helm chart for Kubernetes

  8、部署我們自定義的chart

[root@master ~]# helm install --name myapp1 local/myapp

  9、刪除我們部署的chart

[root@master ~]# helm delete --purge myapp1
release "myapp1" deleted










來自 “ ITPUB部落格 ” ,連結:http://blog.itpub.net/28916011/viewspace-2216650/,如需轉載,請註明出處,否則將追究法律責任。

相關文章