2020-05-05

安装 Helm3 管理 Kubernetes 应用

系统环境：

Helm 版本：v3.5.0
Kubernetes 版本：v1.18.2

参考地址：

一、Helm 介绍

Helm 是一款能够帮助你管理 Kubernetes 应用的程序，它可以让你创建自己的应用模板（chart），然后模板来创建配置很多可自定义参数，每次我们只需要设定很少或者不设置参数（使用默认参数）就可以将应用部署到 Kubernetes 中，后期就可以通过 Helm 来进行升级、回滚、删除等等操作的管理。

Helm 的 Charts 类似于应用商店，里面存有很多公司提供不同应用的模板，例如常部署的 Redis、Mysql、Nginx 等等，可以让我们很方便的采用别人的模板，然后进行一定的配置，就能在我们的 Kubernetes 集群中创建对应的应用。

Helm 还经常与 CI\CD 配置使用，在这个过程中用于维护应用程序的安装、升级、回滚等操作。

如上，现在学习如何安装、使用 Helm，已经是学习如何使用 Kubernetes 的重要部分了，下面将记录一下这个安装过程。

二、下载并安装 Helm 客户端

访问 Helm Github 下载页面 https://github.com/helm/helm/releases 找到最新的客户端，里面有不同系统下的包，这里我们选择 Linux amd64，然后在 Linux 系统中使用 Wget 命令进行下载。

1
#下载Helm客户端
2
$ wget https://get.helm.sh/helm-v3.5.0-linux-amd64.tar.gz

接下来解压下载的包，然后将客户端放置到 /usr/local/bin/ 目录下：

1
#解压 Helm
2
$ tar -zxvf helm-v3.5.0-linux-amd64.tar.gz
3

4
#复制客户端执行文件到 bin 目录下，方便在系统下能执行 helm 命令
5
$ cp linux-amd64/helm /usr/local/bin/

注意：helm 客户端需要下载到安装了 kubectl 并且能执行能正常通过 kubectl 操作 kubernetes 的服务器上，否则 helm 将不可用。

三、添加 Chart 仓库

在 Helm 中默认是不会添加 Chart 仓库，所以这里我们需要手动添加，下面是添加一些常用的 Charts 库，命令如下：

1
$ helm repo add  elastic    https://helm.elastic.co
2
$ helm repo add  gitlab     https://charts.gitlab.io
3
$ helm repo add  harbor     https://helm.goharbor.io
4
$ helm repo add  bitnami    https://charts.bitnami.com/bitnami
5
$ helm repo add  incubator  https://kubernetes-charts-incubator.storage.googleapis.com
6
$ helm repo add  stable     https://kubernetes-charts.storage.googleapis.com

增加完仓库后，需要执行更新命令，将仓库中的信息进行同步：

1
$ helm repo update

注意：如果有的仓库不能正常解析，请更换 DNS 地址，在测试过程中，发现有的能正常解析，有的不能。如果还不行，就直接将域名和对应的地址写死在 Host 文件中。

四、Helm 的基本操作

# 安装应用

通过 Helm 在 Repo 中查询可安装的 Nginx 包：

1
$ helm search repo nginx
2

3
NAME                                    CHART VERSION   APP VERSION     DESCRIPTION
4
bitnami/nginx                           5.3.1           1.17.10         Chart for the nginx server
5
bitnami/nginx-ingress-controller        5.3.21          0.32.0          Chart for the nginx Ingress controller
6
bitnami/kong                            1.1.4           2.0.4           Kong is a scalable, open source API layer (aka ...

安装测试：

-n：指定安装的 Namespace

1
$ helm install nginx bitnami/nginx -n mydlqcloud

查看应用状态

1
$ helm status nginx -n mydlqcloud

# 自定义参数安装应用

Helm 中支持使用自定义 yaml 文件和 --set 命令参数对要安装的应用进行参数配置，使用如下：

## 查看应用 chart 可配置参数

首先使用 helm show values {仓库名称}/{应用名称} 来查看对应应用的可配置参数：

1
$ helm show values bitnami/nginx
2

3
image:
4
  registry: docker.io
5
  repository: bitnami/nginx
6
  tag: 1.17.10-debian-10-r33
7
resources:
8
  limits:
9
     cpu: 100m
10
     memory: 128Mi
11
  requests:
12
     cpu: 100m
13
     memory: 128Mi
14
  ......(太长,略)

## 方式一：使用自定义 values.yaml 文件安装应用

使用自定义配置文件来配置安装应用的参数：

(1)、创建自定义配置文件 values.yaml

1
$ cat > values.yaml << EOF
2

3
image:
4
  registry: docker.io
5
  repository: bitnami/nginx
6
resources:
7
  limits:
8
     cpu: 1000m
9
     memory: 1024Mi
10
  requests:
11
     cpu: 1000m
12
     memory: 1024Mi
13

14
EOF

(2)、使用自定义配置文件运行应用

1
$ helm install -f values.yaml bitnami/nginx

## 方式二：使用 —set 配置参数进行安装

—set 参数是在使用 helm 命令时候添加的参数，可以在执行 helm 安装与更新应用时使用，多个参数间用”,“隔开，使用如下：

如果配置文件和 —set 同时使用，则 —set 设置的参数会覆盖配置文件中的参数配置。

1
$ helm install --set 'registry.registry=docker.io,registry.repository=bitnami/nginx' bitnami/nginx

对于 —set 写配置参数，Helm 官方对于不同的配置类型给出了不同的写法，如下：

yaml 文件写法	set 的写法
name: value	--set name=value
a: b c: d	--set a=b,c=d
outer: inner: value	--set outer.inner=value
name: - a - b - c	--set name={a, b, c}
servers: - port: 80	--set servers[0].port=80
servers: - port: 80 host: example	--set servers[0].port=80,servers[0].host=example
name: "value1,value2"	--set name=value1\,value2
nodeSelector: kubernetes.io/role: master	--set nodeSelector."kubernetes\.io/role"=master

# 卸载应用

卸载应用，并保留安装记录

1
$ helm uninstall nginx -n mydlqcloud --keep-history

查看全部应用（包含安装和卸载的应用）

1
$ helm list -n mydlqcloud --all

卸载应用，不保留安装记录

1
$ helm delete nginx -n mydlqcloud

# 升级应用

创建新的配置参数文件 values.yaml：

1
$ cat > values.yaml << EOF
2

3
service.type: NodePort
4
service.nodePorts.http: 30002
5

6
EOF

应用更新：

1
$ helm upgrade -f values.yaml nginx bitnami/nginx -n mydlqcloud

查看新配置是否生效：

1
$ helm get values nginx -n mydlqcloud
2

3
USER-SUPPLIED VALUES:
4
service.nodePorts.http: 30002
5
service.type: NodePort

# 应用回滚

如果升级过程发生错误，进行回滚，首先查看应用的历史版本：

1
$ helm history nginx -n mydlqcloud
2

3
REVISION        UPDATED                         STATUS          CHART           APP VERSION     DESCRIPTION
4
1               Fri May  8 06:46:56 2020        superseded      nginx-5.3.1     1.17.3          Install complete
5
2               Fri May  8 06:46:56 2020        deployed        nginx-5.3.1     1.17.3          Upgrade complete

知道 REVISION 号后就可以进行回滚操作：

1
$ helm rollback nginx 1 -n mydlqcloud
2

3
Rollback was a success! Happy Helming!

# 渲染模板

如果想查看通过指定的参数渲染的 Kubernetes 部署资源模板，可以通过下面命令：

1
$ helm template bitnami/nginx -n mydlqcloud

可以看到渲染的模板如下：

1
---
2
apiVersion: v1
3
kind: Service
4
metadata:
5
  name: RELEASE-NAME-nginx
6
  labels:
7
    app.kubernetes.io/name: nginx
8
    helm.sh/chart: nginx-5.3.1
9
    app.kubernetes.io/instance: RELEASE-NAME
10
    app.kubernetes.io/managed-by: Helm
11
spec:
12
  type: LoadBalancer
13
  externalTrafficPolicy: "Cluster"
14
  ports:
15
    - name: http
16
      port: 80
17
      targetPort: http
18
  selector:
19
    app.kubernetes.io/name: nginx
20
    app.kubernetes.io/instance: RELEASE-NAME
21
---
22
# Source: nginx/templates/deployment.yaml
23
apiVersion: apps/v1
24
kind: Deployment
25
metadata:
26
  name: RELEASE-NAME-nginx
27
  labels:
28
    app.kubernetes.io/name: nginx
29
    helm.sh/chart: nginx-5.3.1
30
    app.kubernetes.io/instance: RELEASE-NAME
31
    app.kubernetes.io/managed-by: Helm
32
spec:
33
  selector:
34
    matchLabels:
35
      app.kubernetes.io/name: nginx
36
      app.kubernetes.io/instance: RELEASE-NAME
37
  replicas: 1
38
  template:
39
    metadata:
40
      labels:
41
        app.kubernetes.io/name: nginx
42
        helm.sh/chart: nginx-5.3.1
43
        app.kubernetes.io/instance: RELEASE-NAME
44
        app.kubernetes.io/managed-by: Helm
45
    spec:
46
      containers:
47
        - name: nginx
48
          image: docker.io/bitnami/nginx:1.17.3-debian-10-r63
49
          imagePullPolicy: "IfNotPresent"
50
          ports:
51
            - name: http
52
              containerPort: 8080

---END---

如果本文对你有帮助，可以关注我的公众号 "小豆丁技术栈" 了解最新动态，顺便也请帮忙 Github 点颗星哦，感谢~