Kubernetes 集群包管理器 Helm3 部署

一、前言

如果我们开发微服务架构应用,组成的应用多达几十或上百个,传统的资源文件的组织和管理应用方式就会力不从心了:

  • 很难管理、编辑和维护如此多的服务。每个服务都有若干配置,缺乏一个更高层次的工具将这些配置组织起来;
  • 不容易将这些服务作为一个整体统一发布。运维人员需要理解应用和服务之间的关系,然后按照逻辑执行资源文件,即缺少一种工具来定义应用与服务,以及服务与服务之间的关系;
  • 不能高效地共享和重用服务。比如两个 MySQL 服务,只是配置参数不同,但是使用资源文件需要重复执行。也就是说,不支持参数化配置和多环境配置。
  • 不支持应用版本管理。虽然可以通过命令:kubectl rollout undo进行回滚,但是只能到单个 Deployment,不支持整个应用的回滚。
  • 不支持对部署应用状态验证。比如是否能通过预定义的账号访问 MySQL。虽然 Kubernetes 有健康检查,但那是针对单个容器,我们需要应用(服务)级别的健康检查。Helm 能够解决上面这些问题,Helm 帮助 Kubernetes 成为微服务架构应用理想的部署平台

Kuberbetes 能够很好地组织和编排容器,但它缺少一个更高层次的应用打包工具,而 Helm 就是解决这个问题的。

二、简介

Helm 是 Kubernetes 的包(Chart)管理器。包管理器类似于我们在 Ubuntu 中使用的 apt、Centos 中使用的 yum 或者 Python 中的 pip 一样,能快速查找、下载和安装软件包,这里我们使用 Helm3 进行软件管理。

三、安装

1、先决条件

成功且正确安全地使用 Helm 需要具备以下先决条件。

  1. Kubernetes 集群
  2. 确定要应用于安装的安全性配置(如果有)
  3. 安装和配置 Helm

安装 Kubernetes 或有权访问集群

  • 必须安装 Kubernetes。对于 Helm 的最新版本,我们建议使用 Kubernetes 的最新稳定版本,在大多数情况下,它是第二最新的次要版本。
  • 还应该具有的本地配置副本 kubectl

注意:1.6 之前的 Kubernetes 版本对基于角色的访问控制(RBAC)的支持有限或不支持。

2、安装

2.1、在线安装

Helm 现在具有一个安装程序脚本,该脚本将自动获取最新版本的 Helm 并将其本地安装。

$ curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3
$ chmod 700 get_helm.sh
$ ./get_helm.sh
Downloading https://get.helm.sh/helm-v3.2.4-linux-amd64.tar.gz
Preparing to install helm into /usr/local/bin
helm installed into /usr/local/bin/helm

官方参考:https://helm.sh/docs/intro/quickstart/

2.2、下载安装

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

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

# 接下来解压下载的包,然后将客户端放置到 /usr/local/bin/ 目录下:
# 解压 Helm
tar -zxvf helm-v3.2.4-linux-amd64.tar.gz

# 复制客户端执行文件到 bin 目录下,方便在系统下能执行 helm 命令
cp linux-amd64/helm /usr/local/bin/
注意:helm 客户端需要下载到安装了 kubectl 并且能执行能正常通过 kubectl 操作 kubernetes 的服务器上,否则 helm 将不可用。

3、配置仓库

Helm3 默认是不会添加 Chart 仓库, 需要添加常用的仓库:

helm repo add  elastic    https://helm.elastic.co
helm repo add  gitlab     https://charts.gitlab.io
helm repo add  harbor     https://helm.goharbor.io
helm repo add  bitnami    https://charts.bitnami.com/bitnami
helm repo add  incubator  https://kubernetes-charts-incubator.storage.googleapis.com
helm repo add  stable     https://kubernetes-charts.storage.googleapis.com

增加完仓库后, 需要执行更新命令, 将仓库中的信息进行同步 helm repo update

⚠️注意:

如果有的仓库不能正常解析, 请更换 DNS 地址, 在测试过程中, 发现有的能正常解析, 有的不能. 如果还不行, 就直接将域名和对应的地址写死在 Host 文件中. 或者配置代理

使用国内仓库:

helm repo add stable http://mirror.azure.cn/kubernetes/charts
helm repo add aliyun https://kubernetes.oss-cn-hangzhou.aliyuncs.com/charts
helm repo update
$ helm repo update
Hang tight while we grab the latest from your chart repositories...
...Successfully got an update from the "aliyun" chart repository
...Successfully got an update from the "harbor" chart repository
...Successfully got an update from the "incubator" chart repository
...Successfully got an update from the "gitlab" chart repository
...Successfully got an update from the "elastic" chart repository
...Successfully got an update from the "stable" chart repository
...Successfully got an update from the "bitnami" chart repository
Update Complete. ⎈ Happy Helming!⎈

$ helm repo list
NAME            URL
elastic         https://helm.elastic.co
bitnami         https://charts.bitnami.com/bitnami
incubator       https://kubernetes-charts-incubator.storage.googleapis.com
stable          http://mirror.azure.cn/kubernetes/charts
aliyun          https://kubernetes.oss-cn-hangzhou.aliyuncs.com/charts
gitlab          https://charts.gitlab.io
harbor          https://helm.goharbor.io

4、查询应用

命令:helm search repo

$ helm search repo rabbitmq
NAME                                    CHART VERSION   APP VERSION     DESCRIPTION
aliyun/rabbitmq                         0.6.21          3.7.3           Open source message broker software that implem...
aliyun/rabbitmq-ha                      1.0.0           3.7.3           Highly available RabbitMQ cluster, the open sou...
bitnami/rabbitmq                        7.2.1           3.8.5           Open source message broker software that implem...
stable/prometheus-rabbitmq-exporter     0.5.5           v0.29.0         Rabbitmq metrics exporter for prometheus
stable/rabbitmq                         6.18.2          3.8.2           DEPRECATED Open source message broker software ...
stable/rabbitmq-ha                      1.46.4          3.8.5           Highly available RabbitMQ cluster, the open sou...

4、查看安装包内容

helm inspect values

5、安装应用

helm install my-release bitnami/rabbitmq
helm install my-rabbitmq bitnami/rabbitmq -n default

## -n, --namespace 参数指定安装的命名空间, Helm3 可以在不同的命名空间中部署相同名称的应用
## -f values.yaml 使用自定义参数配置
## --set 设置自定义参数列表
## --dry-run --debug 模拟安装过程并打印配置信息

6、查看应用 chart 可配置参数

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

helm show values bitnami/rabbitmq

7、自定义参数安装应用

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

7.1、方式一:使用自定义 values.yaml 文件安装应用

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

创建自定义配置文件 values.yaml

$ cat > values.yaml << EOF

image:
  registry: docker.io
  repository: bitnami/nginx
resources:
  limits: 
     cpu: 1000m
     memory: 1024Mi
  requests: 
     cpu: 1000m
     memory: 1024Mi

EOF

使用自定义配置文件运行应用:

helm install -f values.yaml bitnami/nginx

7.2、方式二:使用 --set 配置参数进行安装

使用如下:

helm install my-rabbitmq \
--set auth.username=admin,auth.password=admin,auth.erlangCookie=secretcookie,global.storageClass=rook-ceph-block \
bitnami/rabbitmq

# auth.username:RabbitMQ 应用程序用户名
# auth.password:RabbitMQ 应用密码
# auth.erlangCookie:Erlang cookie
# global.storageClass:用于动态配置的全局存储类,此处指定 ceph 存储类

官方指南:

https://github.com/bitnami/charts/tree/master/bitnami/rabbitmq/#installing-the-chart

helm install my-rabbitmq \
>   --set auth.username=admin,auth.password=admin,auth.erlangCookie=secretcookie,global.storageClass=rook-ceph-block \
>     bitnami/rabbitmq
>     
NAME: my-rabbitmq
LAST DEPLOYED: Fri Jun 26 16:22:44 2020
NAMESPACE: default
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
** Please be patient while the chart is being deployed **
Credentials:
echo "Username      : admin"
echo "Password      : $(kubectl get secret --namespace default my-rabbitmq -o jsonpath="{.data.rabbitmq-password}" | base64 --decode)"
echo "ErLang Cookie : $(kubectl get secret --namespace default my-rabbitmq -o jsonpath="{.data.rabbitmq-erlang-cookie}" | base64 --decode)"
RabbitMQ can be accessed within the cluster on port  at my-rabbitmq.default.svc.
To access for outside the cluster, perform the following steps:
To Access the RabbitMQ AMQP port:
echo "URL : amqp://127.0.0.1:5672/"
kubectl port-forward --namespace default svc/my-rabbitmq 5672:5672
To Access the RabbitMQ Management interface:
echo "URL : http://127.0.0.1:15672/"
kubectl port-forward --namespace default svc/my-rabbitmq 15672:15672

$ kubectl get pods  -o wide
NAME                     READY   STATUS      RESTARTS   AGE     IP            NODE        NOMINATED NODE   READINESS GATES
my-rabbitmq-0            1/1     Running     0          24m     10.244.2.66   k8s-node3   <none>           <none>

$ kubectl get pvc
NAME                 STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS      AGE
data-my-rabbitmq-0   Bound    pvc-6e3c51c1-a4eb-439e-bb85-29df7a00ca0b   8Gi        RWO            rook-ceph-block   24m

$ kubectl get pv
NAME                                       CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS   CLAIM                        STORAGECLASS      REASON   AGE
pvc-6e3c51c1-a4eb-439e-bb85-29df7a00ca0b   8Gi        RWO            Delete           Bound    default/data-my-rabbitmq-0   rook-ceph-block            24m

8、卸载应用

卸载应用,并保留安装记录:

helm uninstall my-rabbitmq -n default

## -n, --namespace 参数指定安装的命名空间, Helm3 可以在不同的命名空间中部署相同名称的应用

卸载应用,不保留安装记录:

helm delete my-rabbitmq -n default

查看全部应用(包含安装和卸载的应用)

$ helm list -n default  --all
NAME            NAMESPACE       REVISION        UPDATED                                 STATUS          CHART           APP VERSION
my-rabbitmq     default         1               2020-06-26 16:22:44.57446662 +0800 CST  deployed        rabbitmq-7.2.1  3.8.5

9、升级应用

通过更新配置文件的方式来更新部署:

## values.yaml 参数配置文件
helm upgrade -f values.yaml my-rabbitmq bitnami/rabbitmq -n default

## 查看新配置是否生效
helm get values my-rabbitmq -n default

10、应用回滚

升级过程发生错误, 可以进行回滚, 操作过程为查看应用历史版本, 获取 REVISION 号后进行回滚操作

$ helm history my-rabbitmq -n default
REVISION        UPDATED                         STATUS          CHART           APP VERSION     DESCRIPTION
1               Tue Feb 25 11:30:06 2020        deployed        rabbitmq-6.17.4 3.8.2           Install complete

11、回滚到 1 版本

helm rollback my-rabbitmq 1 -n default
上一篇:搭建 Kubernetes 集群 Dashboard 2.0+ 可视化插件


下一篇:使用 kubeadm 初始化 worker节点出现 not ready 故障