You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

432 lines
22 KiB
Markdown

This file contains invisible Unicode characters!

This file contains invisible Unicode characters that may be processed differently from what appears below. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to reveal hidden characters.

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 49 | 服务编排Helm服务编排基础知识
你好,我是孔令飞。
我们将应用部署在Kubernetes时可能需要创建多个服务。我就见过一个包含了40多个微服务的超大型应用每个服务又包含了多个Kubernetes资源比如 Service、Deployment、StatefulSet、ConfigMap等。相同的应用又要部署在不同的环境中例如测试环境、预发环境、现网环境等也就是说应用的配置也不同。
对于一个大型的应用如果基于YAML文件一个一个地部署Kubernetes资源是非常繁琐、低效的而且这些YAML文件维护起来极其复杂还容易出错。那么有没有一种更加高效的方式比如像Docker镜像一样将应用需要的Kubernetes资源文件全部打包在一起通过这个包来整体部署和管理应用从而降低应用部署和维护的复杂度。
答案是有。我们可以通过Helm Chart包来管理这些Kubernetes文件并通过`helm`命令基于Chart包来创建和管理应用。
接下来我就来介绍下Helm的基础知识并给你演示下如何基于Helm部署IAM应用。
## Helm基础知识介绍
Helm目前是Kubernetes服务编排事实上的标准。Helm提供了多种功能来支持Kubernetes的服务编排例如 `helm` 命令行工具、Chart包、Chart仓库等。下面我就来详细介绍下。
### Helm是什么
Helm是Kubernetes的包管理器类似于Python的 `pip` centos的 `yum` 。Helm主要用来管理Chart包。Helm Chart包中包含一系列YAML格式的Kubernetes资源定义文件以及这些资源的配置可以通过Helm Chart包来整体维护这些资源。
Helm也提供了一个`helm`命令行工具该工具可以基于Chart包一键创建应用在创建应用时可以自定义Chart配置。应用发布者可以通过Helm打包应用、管理应用依赖关系、管理应用版本并发布应用到软件仓库对于使用者来说使用Helm后不需要编写复杂的应用部署文件可以非常方便地在Kubernetes上查找、安装、升级、回滚、卸载应用程序。
Helm最新的版本是v3Helm3以Helm2的核心功能为基础对Chart repo、发行版管理、安全性和library Charts进行了改进。和Helm2比起来Helm3最明显的变化是删除了TillerHelm2是一种Client-Server结构客户端称为Helm服务器称为Tiller。Helm3还新增了一些功能并废弃或重构了Helm2的部分功能与Helm2不再兼容。此外Helm3还引入了一些新的实验功能包括OCI支持。
Helm3架构图如下
![图片](https://static001.geekbang.org/resource/image/9b/59/9bb9e2d495d8fbe5eab4d02d407c8059.jpg?wh=1920x1083)
上面的架构图中核心是Helm Client`helm`命令和Helm Chart包。`helm`命令可以从`Chart Repository`中下载Helm Chart包读取`kubeconfig`文件并构建kube-apiserver REST API接口的HTTP请求。通过调用Kubernetes提供的REST API接口将Chart包中包含的所有以YAML格式定义的Kubernetes资源在Kubernetes集群中创建。
这些资源以Release的形式存在于Kubernetes集群中每个Release又包含多个Kubernetes资源例如Deployment、Pod、Service等。
### Helm中的三大基本概念
要学习和使用Helm一定要了解Helm中的三大基本概念Helm的所有操作基本都是围绕着这些概念来进行的。下面我来介绍下Helm的三大基本概念。
* **Chart** 代表一个Helm包。它包含了在Kubernetes集群中运行应用程序、工具或服务所需的所有YAML格式的资源定义文件。
* **Repository仓库** 它是用来存放和共享 Helm Chart的地方类似于存放源码的GitHub的Repository以及存放镜像的Docker的Repository。
* **Release**它是运行在 Kubernetes 集群中的 Chart 的实例。一个Chart通常可以在同一个集群中安装多次。每一次安装都会创建一个新的 Release。
### 我们为什么要使用Helm
现在你对Helm已经有了一定了解这里我再来详细介绍下为什么要使用Helm。
先来看下传统的应用部署模式:
![图片](https://static001.geekbang.org/resource/image/c1/c4/c1f54e347b5db7850b57815abed99ec4.jpg?wh=1920x966)
我们有测试环境、预发环境、现网环境三个环境每个环境中部署一个应用A应用A中包含了多个服务每个服务又包含了自己的配置不同服务之间的配置有些是共享的例如`配置A`。
每个服务由一个复杂的Kubernetes YAML格式的文件来定义并创建可以看到如果靠传统的方式去维护这些YAML格式文件并在不同环境下使用不同的配置去创建应用是一件非常复杂的工作并且后期YAML文件和Kubernetes集群中部署应用的维护都很复杂。随着微服务规模越来越大会面临以下挑战
* 微服务化服务数量急剧增多,给服务管理带来了极大的挑战。
* 服务数量急剧增多,增加了管理难度,对运维部署是一种挑战。
* 服务数量的增多,对服务配置管理也提出了更高的要求。
* 随着服务数量增加,服务依赖关系也变得更加复杂,服务依赖关系的管理难度增大。
* 在环境信息管理方面,在新环境快速部署一个复杂应用变得更加困难。
所以我们需要一种更好的方式来维护和管理这些YAML文件和Kubernetes中部署的应用。Helm可以帮我们解决上面这些问题。
接下来我们来看下Helm是如何解决这些问题的。
在Helm中可以理解为主要包含两类文件模板文件和配置文件。模板文件通常有多个配置文件通常有一个。Helm的模板文件基于`text/template`模板文件提供了更加强大的模板渲染能力。Helm可以将配置文件中的值渲染进模板文件中最终生成一个可以部署的Kubernetes YAML格式的资源定义文件如下图所示
![图片](https://static001.geekbang.org/resource/image/ff/86/ffcc4eaf4071e19e2e0d317b1c536486.png?wh=1920x936)
上图中我们将以下配置渲染进了模板中生成了Kubernetes YAML文件
```yaml
replicas: 2
tag: latest
common:
username: colin
password: iam1234
```
所以在Helm中部署一个应用可以简化为`Chart模板多个服务 + Chart配置 -> 应用`,如下图所示:
![图片](https://static001.geekbang.org/resource/image/bb/6b/bb87b8562102525d4c2yy0b0314ac46b.jpg?wh=1920x995)
Chart模板一个应用只用编写一次可以重复使用。在部署时可以指定不同的配置从而将应用部署在不同的环境中或者在同一环境中部署不同配置的应用。
## Helm 基本操作实战
上面我介绍了Helm的一些基础知识这里我们再来学习下如何使用Helm对应用进行生命周期管理。
### 前置条件
在开始之前你需要确保你有一个可以使用的Kubernetes集群。目前最方便快捷、最经济的方式是申请一个腾讯云EKS集群。至于如何申请和访问你可以参考 [48讲](https://time.geekbang.org/column/article/418711) “准备一个Kubernetes集群”部分的教程。这里再提醒下**用完集群后,记得删除集群资源,免得被持续扣费**。
### 安装Helm
Helm提供了多种安装方式在能连通外网的情况下可以通过脚本来安装安装命令如下
```bash
$ mkdir -p $HOME/bin
$ wget https://get.helm.sh/helm-v3.6.3-linux-amd64.tar.gz
$ tar -xvzf helm-v3.6.3-linux-amd64.tar.gz
$ mv linux-amd64/helm $HOME/bin
$ chmod +x $HOME/bin/helm
$ helm version
version.BuildInfo{Version:"v3.6.3", GitCommit:"d506314abfb5d21419df8c7e7e68012379db2354", GitTreeState:"clean", GoVersion:"go1.16.5"}
```
如果执行`helm version`可以成功打印出 `helm` 命令的版本号说明Helm安装成功。
Helm各版本安装包地址见 [Helm Releases](https://github.com/helm/helm/releases)。
安装完`helm`命令后,可以安装`helm`命令的自动补全脚本。假如你用的shell是`bash`,安装方法如下:
```bash
$ helm completion bash > $HOME/.helm-completion.bash
$ echo 'source $HOME/.helm-completion.bash' >> ~/.bashrc
$ bash
```
执行 `helm comp<TAB>`,就会自动补全为`helm completion`。
### Helm快速入门
你可以通过以下六个步骤来快速创建一个Chart应用。
**第一步初始化一个Helm Chart仓库。**
安装完Helm之后就可以使用 `helm` 命令添加一个Chart仓库。类似于用来托管Docker镜像的DockerHub、用来托管代码的GitHubChart包也有一个托管平台当前比较流行的Chart包托管平台是[Artifact Hub](https://artifacthub.io/packages/search?kind=0)。
Artifact Hub上有很多Chart仓库我们可以添加需要的Chart仓库这里我们添加BitNami提供的Chart仓库
```bash
$ helm repo add bitnami https://charts.bitnami.com/bitnami # 添加 Chart Repository
$ helm repo list # 查看添加的 Repository 列表
```
添加完成后,我们可以通过`helm search`命令来查询需要的Chart包。`helm search`支持两种不同的查询方式,这里我来介绍下。
* `helm search repo<keyword>`:从你使用 `helm repo add` 添加到本地 Helm 客户端中的仓库里查找。该命令基于本地数据进行搜索,无需连接外网。
* `helm search hub<keyword>`:从 Artifact Hub 中查找并列出 Helm Charts。 Artifact Hub中存放了大量的仓库。
Helm 搜索使用模糊字符串匹配算法,所以你可以只输入名字的一部分。下面是一个`helm search`的示例:
```bash
$ helm search repo bitnami
NAME CHART VERSION APP VERSION DESCRIPTION
bitnami/bitnami-common 0.0.9 0.0.9 DEPRECATED Chart with custom templates used in ...
bitnami/airflow 10.2.8 2.1.2 Apache Airflow is a platform to programmaticall...
bitnami/apache 8.6.1 2.4.48 Chart for Apache HTTP Server
bitnami/argo-cd 1.0.2 2.0.5 Declarative, GitOps continuous delivery tool fo...
bitnami/aspnet-core 1.3.14 3.1.18 ASP.NET Core is an open-source framework create...
bitnami/cassandra 8.0.2 4.0.0 Apache Cassandra is a free and open-source dist...
bitnami/cert-manager 0.1.15 1.5.1 Cert Manager is a Kubernetes add-on to automate...
# ... and many more
```
**第二步安装一个示例Chart。**
查询到自己需要的Helm Chart后就可以通过`helm install`命令来安装一个Chart。`helm install`支持从多种源进行安装:
* Chart的Repository。
* 本地的Chart Archive例如`helm install foo foo-1.0.0.tgz`。
* 一个未打包的Chart路径例如`helm install foo path/to/foo`。
* 一个完整的URL例如`helm install foo https://example.com/charts/foo-1.0.0.tgz`。
这里,我们选择通过`bitnami/mysql` Chart包来安装一个MySQL应用。你可以执行 `helm show chart bitnami/mysql` 命令来简单了解这个Chart的基本信息。 或者,你也可以执行 `helm show all bitnami/mysql`获取关于该Chart的所有信息。
接下来,就可以使用`helm install`命令来安装这个Chart包了。安装命令如下
```bash
$ helm repo update # Make sure we get the latest list of charts
$ helm install bitnami/mysql --generate-name
NAME: mysql-1629528555
LAST DEPLOYED: Sat Aug 21 14:49:19 2021
NAMESPACE: default
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES: ...
```
在上面的例子中,我们通过安装`bitnami/mysql`这个Chart创建了一个`mysql-1629528555` Release。`--generate-name`参数告诉Helm自动为这个Release命名。
在安装过程中Helm 客户端会打印一些有用的信息包括哪些资源已经被创建Release当前的状态以及你是否还需要执行额外的配置步骤。例如从上述例子的输出中你可以获取到数据库的Root密码、登陆方式、更新方式等信息。
安装完之后,你可以使用 `helm status` 来追踪Release 的状态。
每当你执行 `helm install` 的时候都会创建一个新的发布版本。所以一个Chart在同一个集群里面可以被安装多次每一个都可以被独立地管理和升级。
`helm install`命令会将templates渲染成最终的Kubernetes能够识别的YAML格式然后安装到Kubernetes集群中。
`helm install` 功能非常强大,想了解更多功能,你可以参考这个指南:[使用 Helm](https://helm.sh/zh/docs/intro/using_helm)。
**第三步,安装前自定义 Chart。**
上一步中的安装方式只会使用 Chart 的默认配置选项,很多时候我们需要自定义 Chart 来指定我们想要的配置。使用 `helm show values` 可以查看 Chart 中的可配置选项:
```bash
$ helm show values bitnami/mysql # 为了方便展示,我删除了 `helm show values`输出中的`#`注释
# ... and many more
architecture: standalone
auth:
rootPassword: ""
database: my_database
username: ""
password: ""
replicationUser: replicator
replicationPassword: ""
existingSecret: ""
forcePassword: false
usePasswordFiles: false
customPasswordFiles: {}
initdbScripts: {}
# ... and many more
```
然后,你可以使用 YAML 格式的文件,覆盖上述任意配置项,并在安装过程中使用该文件。
```bash
$ echo '{auth.database: iam, auth.username: iam, auth.password: iam59!z$}' > values.yaml
$ helm install bitnami/mysql -f values.yaml --generate-name
```
上述命令将为 MySQL 创建一个名称为 `iam` 的默认用户,密码为`iam59!z$`,并且授予该用户访问新建的 `iam` 数据库的权限。Chart 中的其他默认配置保持不变。
安装过程中,有两种传递配置数据的方式。
* `-f, --values`:使用 YAML 文件覆盖配置。可以指定多次,优先使用最右边的文件。
* `--set`:通过命令行的方式对指定配置项进行覆盖。
如果同时使用两种方式,则 `--set` 中的值会被合并到 `--values` 中,但是 `--set` 中的值优先级更高。在`--set`中覆盖的内容会被保存在 ConfigMap 中。你可以通过 `helm get values <release-name>` 来查看指定 Release 中 `--set` 设置的值,也可以通过运行 `helm upgrade` 并指定 `--reset-values` 字段,来清除 `--set`中设置的值。
**这里我讲解下`--set`的格式和限制。**
`--set` 选项使用`0`或多个`key-value` 对。最简单的用法类似于`--set name=value`,等价于下面这个 YAML 格式:
```yaml
name: value
```
多个值之间使用逗号分割,因此`--set a=b,c=d` 的 YAML 表示是:
```yaml
a: b
c: d
```
`--set`还支持更复杂的表达式。例如,`--set outer.inner=value` 被转换成了:
```yaml
outer:
inner: value
```
列表使用花括号`{}`来表示。例如,`--set name={a, b, c}` 被转换成了:
```yaml
name:
- a
- b
- c
```
从 2.5.0 版本开始,我们可以使用数组下标的语法来访问列表中的元素了。例如 `--set servers[0].port=80` 就变成了:
```yaml
servers:
- port: 80
```
多个值也可以通过这种方式来设置。`--set servers[0] [0].host=``marmotedu` 变成了:
```yaml
servers:
- port: 80
host: marmotedu
```
如果需要在 `--set` 中使用特殊字符,你可以使用反斜线来进行转义,比如`--set name=value1\,value2` 就变成了:
```yaml
name: "value1,value2"
```
如果是深层嵌套的数据结构,可能很难用`--set` 来表达,更多内容你可以参考 [Values 文件](https://helm.sh/docs/chart_template_guide/values_files/)。
**第四步查看当前集群安装了哪些Release。**
通过`helm list`可以查看当前集群、当前Namespace下安装的Release列表
```bash
$ helm list
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION
mysql-1629528555 default 1 2021-08-21 14:49:19.101935218 +0800 CST deployed mysql-8.8.4 8.0.26
mysql-1629529348 default 1 2021-08-21 15:02:32.079969128 +0800 CST deployed mysql-8.8.4 8.0.26
```
可以看到我们创建了两个Release这些Release位于`default`命名空间中。上述命令也列出了Release的更新时间、状态、Chart的版本等。
**第五步,升级 Release并且在失败时恢复。**
部署完应用之后,后续还可能升级应用,可以通过`helm upgrade`命令来升级应用。升级操作会基于已有的Release根据提供的信息进行升级。Helm在更新时只会变更有更改的内容。
例如,这里我们升级`mysql-1629528555`变更它的Root密码
```bash
$ helm upgrade mysql-1629528555 bitnami/mysql --set auth.rootPassword='iam59!z$'
```
在上面的例子中,`mysql-1629528555` 这个 Release 使用相同的 Chart 进行升级,但使用了一个新的`rootPassword`配置。
我们可以使用 `helm get values` 命令,来看看配置值是否真的生效了:
```bash
$ helm get values mysql-1629528555
USER-SUPPLIED VALUES:
auth:
rootPassword: iam59!z$
```
可以看到`rootPassword` 的新值已经被部署到集群中了。
假如发布失败,我们也很容易通过 `helm rollback [RELEASE] [REVISION]` 命令,回滚到之前的发布版本。
```yaml
$ helm rollback mysql-1629528555 1
```
上面这条命令将我们的`mysql-1629528555`回滚到了它最初的版本。Release 版本其实是一个增量修订revision。 每当发生了一次安装、升级或回滚操作revision 的值就会加`1`。第一次 revision 的值永远是`1`。
我们可以使用 `helm history [RELEASE]` 命令来查看一个特定 Release 的修订版本号:
```bash
$ helm history mysql-1629528555
REVISION UPDATED STATUS CHART APP VERSION DESCRIPTION
1 Sat Aug 21 14:49:19 2021 superseded mysql-8.8.4 8.0.26 Install complete
2 Sat Aug 21 15:14:45 2021 deployed mysql-8.8.4 8.0.26 Upgrade complete
```
你还可以指定一些其他的选项,来自定义 Helm 在安装、升级、回滚期间的行为。这里,我介绍一些常用的参数,供你参考。
* `--timeout`:一个 Go duration 类型的值,用来表示等待 Kubernetes 命令完成的超时时间,默认值为 `5m0s`
* `--no-hooks`:不运行当前命令的钩子。
* `--wait`:表示必须要等到所有的 Pods 都处于 ready 状态、PVC 都被绑定、Deployments处在 ready 状态的Pods 个数达到最小值Desired减去 maxUnavailable才会标记该 Release 为成功。最长等待时间由 `--timeout` 值指定。如果达到超时时间Release 将被标记为 `FAILED`
这里需要注意,当 Deployment 的 replicas 被设置为1但其滚动升级策略中的`maxUnavailable` 没有被设置为`0`时,`--wait` 将返回就绪,因为已经满足了最小 ready Pod 数。
**第六步卸载Release。**
你可以使用`helm uninstall`命令卸载一个Release
```bash
$ helm uninstall mysql-1629528555
```
上述命令会从Kubernetes卸载 `mysql-1629528555` 它将删除和该版本关联的所有资源Service、Deployment、Pod、ConfigMap等包括该Release的所有版本历史。
如果你在执行 `helm uninstall` 的时候提供`--keep-history` 选项, Helm将会保存版本历史。 你可以通过`helm status`命令查看该版本的信息:
```bash
$ helm status mysql-1629528555
Status: UNINSTALLED
...
```
因为 `--keep-history` 选项会让Helm跟踪你的版本即使你卸载了它们所以你可以审计集群历史甚至使用 `helm rollback` 回滚版本。
### Helm命令
上面我介绍了Helm的一些命令的用法如果你想查看Helm提供的所有命令可以执行`helm help`。或者,你也可以执行`helm <subcommand> -h`来查看某个子命令的用法,例如:
```bash
$ helm get -h
This command consists of multiple subcommands which can be used to
get extended information about the release, including:
- The values used to generate the release
- The generated manifest file
- The notes provided by the chart of the release
- The hooks associated with the release
Usage:
helm get [command]
# ... and many more
```
我整理了一份命令列表,供你参考:
![图片](https://static001.geekbang.org/resource/image/c4/bb/c4fa82cf7bf7fc5c98314419b1e0febb.png?wh=1920x4212)
上面这些命令中,有些提供了子命令和命令行参数,具体你可以执行`helm <subcommand> -h`来查看。
## 总结
今天我介绍了Helm的基础知识并给你演示了如何基于Helm部署IAM应用。
当一个应用包含了很多微服务时手动在Kubernetes集群中部署、升级、回滚这些微服务是一件非常复杂的工作。这时候我们就需要一个服务编排方案来编排这些服务从而提高服务部署和维护的效率。
目前业界提供了多种服务编排方案其中最流行的是HelmHelm已经成为一个事实上的Kubernetes服务编排标准。
在Helm中有Chart、Repository和Release三大基本概念。Chart 代表一个Helm包里面包含了运行Kubernetes应用需要的所有资源定义YAML文件Repository是Chart仓库用来存放和共享 Helm ChartRelease是运行在 Kubernetes 集群中的 Chart 的实例。
我们可以通过  `helm install [NAME] [CHART] [flags]` 来安装一个Chart包通过 `helm upgrade [RELEASE] [CHART] [flags]` 来更新一个Helm Release通过 `helm uninstall RELEASE_NAME [...] [flags]` 来卸载一个Helm Release。另外`helm` 命令行工具还提供了其他的功能,你可以再回顾一遍。
## 课后练习
1. 思考下如果使用Helm创建服务是否会存在先启动服务再创建服务配置从而导致服务启动时加载配置失败的问题如果有Helm可以怎样解决这个问题
2. 尝试将IAM应用制作成一个Chart包并通过Helm安装。
欢迎你在留言区与我交流讨论,我们下一讲见。