KubeSphere 部署 TiDB 云原生分布式数据库

TiDB 是 PingCAP 公司自主研发的开源分布式关系型数据库 TiDB，为企业关键业务打造，具备「分布式强一致性事务、在线弹性水平扩展、故障自恢复的高可用、跨数据中心多活」等核心特性，助力企业最大化发挥数据价值，释放企业增长空间。

KubeSphere 是在 Kubernetes 之上构建的以应用为中心的多租户容器平台，完全开源，支持多云与多集群管理，提供全栈的 IT 自动化运维的能力，简化企业的 DevOps 工作流。KubeSphere 提供了运维友好的向导式操作界面，帮助企业快速构建一个强大和功能丰富的容器云平台。

本文将介绍如何在 KubeSphere 上部署 TiDB。

部署环境准备

KubeSphere 是由青云 QingCloud 开源的容器平台，支持在任何基础设施上安装部署。在青云公有云上支持一键部署 KubeSphere（QKE）。

下面以在青云云平台快速启用 KubeSphere 容器平台为例部署 TiDB 分布式数据库，至少需要准备 3 个可调度的 node 节点。你也可以在任何 Kubernetes 集群或 Linux 系统上安装 KubeSphere，可以点击【阅读原文】参考KubeSphere 官方文档。

1\. 登录青云控制台：https://console.qingcloud.com/，点击左侧容器平台，选择 KubeSphere，点击创建并选择合适的集群规格：

2\. 创建完成后登录到 KubeSphere 平台界面：

3\. 点击下方的 Web Kubectl 集群客户端命令行工具，连接到 Kubectl 命令行界面。执行以下命令安装 TiDB Operator CRD：

kubectl apply -f https://raw.githubusercontent.com/pingcap/tidb-operator/v1.1.6/manifests/crd.yaml

 4\. 执行后的返回结果如下：

5\. 点击左上角平台管理，选择访问控制，新建企业空间，这里命名为 dev-workspace

6\. 进入企业空间，选择应用仓库，添加一个 TiDB 的应用仓库：

7\. 将 PingCAP 官方 Helm 仓库添加到 KubeSphere 容器平台，Helm 仓库地址如下：

https://charts.pingcap.org

8\. 添加方式如下：

部署 TiDB-Operator

1\. 首选创建一个项目（namespace）用于运行 TiDB 集群：

2\. 创建完成后点击进入项目，选择应用，部署新应用：

3\. 选择来自应用模板:

4\. 选择 PingCAP，该仓库包含了多个 Helm Chart，当前主要部署 TiDB Operator 和TiDB Cluster。

5\. 点击TiDB Operator 进入 Chart 详情页，点击配置文件可查看或下载默认的 values.yaml，选择版本，点击部署：

6\. 配置应用名称并选择应用版本，确认应用部署位置：

7\. 继续下一步，该步骤可以在界面直接编辑 values.yaml 文件，自定义配置，当前保留默认即可：

8\. 点击部署，等待应用状态变为活跃：

9\. 点击工作负载（Deployment），查看TiDB Operator 部署了 2 个 Deployment 类型资源：

部署 TiDB-Cluster

1.TiDB Operator 部署完成后，可以继续部署TiDB Cluster。与部署TiDB Operator 操作相同，选择左侧应用，点击TiDB Cluster：

2\. 切换到配置文件，选择版本，下载 values.yaml 到本地： 

3\. TiDB Cluster 中部分组件需要持久存储卷，青云公有云平台提供了以下几种类型的 StorageClass：

/ # kubectl get sc
NAME                       PROVISIONER     RECLAIMPOLICY   VOLUMEBINDINGMODE   ALLOWVOLUMEEXPANSION   AGE
csi-high-capacity-legacy   csi-qingcloud   Delete          Immediate           true                   101m
csi-high-perf              csi-qingcloud   Delete          Immediate           true                   101m
csi-ssd-enterprise         csi-qingcloud   Delete          Immediate           true                   101m
csi-standard (default)     csi-qingcloud   Delete          Immediate           true                   101m
csi-super-high-perf        csi-qingcloud   Delete  

4\. 这里选择 csi-standard 类型，values.yaml 中的 StorageClassName 字段默认配置为 local-storage。因此，在下载的 yaml 文件中直接替换所有的 local-storage 字段为 csi-standard。在最后一步使用修改后的 values.yaml 覆盖应用配置文本框中的内容，当然也可以手动编辑配置文件逐个替换：

5\. 这里仅修改 storageClassName 字段用于引用外部持久存储，如果需要将TiDB、TiKV 或 PD 组件调度到独立节点，可参考 NodeAffinity 相关参数进行修改。点击部署，将TiDB Cluster 部署到容器平台，最终在应用列表中可以看到如下 2 个应用：

查看 TiDB 集群监控

1\. TiDB 集群部署后需要一定时间完成初始化，选择工作负载，查看 Deployment 无状态应用：

2\. 查看有状态副本集（StatefulSets），其中TiDB、TiKV 和 PD 等组件都为有状态应用：

3\. 在 KubeSphere 监控面板查看TiDB负载情况，可以看到 CPU、内存、网络流出速率有明显的变化：

4\. 在 KubeSphere 监控面板查看 TiKV 负载情况：

5\. 查看容器组（Pod）列表，TiDB集群包含了 3 个 PD、2 个TiDB以及 3 个 TiKV 组件：

6\. 点击存储管理，查看存储卷，其中 TiKV 和 PD 这 2 个组件使用了持久化存储：

7\. 查看某个存储卷用量信息，以 TiKV 为例，可以看到当前存储的存储容量和剩余容量等监控数据。

8\. 在 KubeSphere 项目首页查看TiDB Cluster 项目中资源用量排行：

访问 TiDB 集群

1\. 点击左侧服务，查看 TiDB 集群创建和暴露的服务信息。

2\. 其中 TiDB 服务 4000 端口绑定的服务类型为 NodePort，直接可以在集群外通过 nodeIP 访问。测试使用 MySQL 客户端连接数据库。

[root@k8s-master1 ~]# docker run -it --rm mysql bash


[root@0d7cf9d2173e:/# mysql -h 192.168.1.102 -P 32682 -u root    
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 201
Server version: 5.7.25-TiDB-v4.0.6 TiDB Server (Apache License 2.0) Community Edition, MySQL 5.7 compatible
 
Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
 
Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.


Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
 
mysql> show databases;
+--------------------+
| Database           |
+--------------------+
| INFORMATION_SCHEMA |
| METRICS_SCHEMA     |
| PERFORMANCE_SCHEMA |
| mysql              |
| test               |
+--------------------+
5 rows in set (0.01 sec)
 
mysql>

查看 Grafana 监控面板

另外，TiDB 自带了 Prometheus 和 Grafana，用于数据库集群的性能监控，可以看到 Grafana 界面的 Serivce 3000 端口同样绑定了 NodePort 端口。访问 Grafana UI，查看某个指标：

总结

KubeSphere 容器平台对于云原生应用部署非常友好，对于还不熟悉 Kubernetes 的应用开发者而又希望通过在界面简单配置完成 TiDB 集群的部署，可以参考以上步骤快速上手。我们将在下一期的文章中，为大家分享另一种部署玩法：将 TiDB 应用上架到 KubeSphere 应用商店实现真正的一键部署。

另外，TiDB 还可以结合 KubeSphere 的多集群联邦功能，部署 TiDB 应用时可一键分发 TiDB 不同的组件副本到不同基础设施环境的多个 Kubernetes 集群，实现跨集群、跨区域的高可用。如果大家感兴趣，我们将在后续的文章中为大家分享 TiDB 在 KubeSphere 实现多集群联邦的混合云部署架构。