本篇文档将主要讲述如何从 0 开始部署一个基于私有化 Kubernetes 集群的云原生存算分离的分布式数据库 MatrixOne。

由于该文档会涉及到众多 Kubernetes 相关的名词，为了让大家能够理解搭建流程，这里对涉及到的重要名词进行简单解释，如果需要详细了解 Kubernetes 相关的内容，可以直接参考 Kubernetes 中文社区 | 中文文档

Pod 是 Kubernetes 中最小的资源管理组件，Pod 也是最小化运行容器化应用的资源对象。一个 Pod 代表着集群中运行的一个进程。简单理解，我们可以把一组提供特定功能的应用成为一个 pod，它会包含一个或者多个容器对象，共同对外提供服务。

Storage Class，简称 SC，用于标记存储资源的特性和性能，管理员可以将存储资源定义为某种类别，正如存储设备对于自身的配置描述（Profile）。根据 SC 的描述可以直观的得知各种存储资源的特性，就可以根据应用对存储资源的需求去申请存储资源了。

PersistentVolume，简称 PV，PV 作为存储资源，主要包括存储能力、访问模式、存储类型、回收策略、后端存储类型等关键信息的设置。

PersistentVolumeClaim，简称 PVC，作为用户对存储资源的需求申请, 主要包括存储空间请求、访问模式、PV 选择条件和存储类别等信息的设置。

由于 MatrixOne 的分布式部署依赖于 Kubernetes 集群，因此我们需要一个 Kubernetes 集群。本篇文章将指导你通过使用 Kuboard-Spray 的方式搭建一个 Kubernetes 集群。

对于集群环境，需要做如下准备：

各个机器情况分布具体如下所示：

Kuboard-Spray 是用来可视化部署 Kubernetes 集群的一个工具。它会使用 Docker 快速拉起一个能够可视化部署 Kubernetes 集群的 Web 应用。Kubernetes 集群环境部署完成后，可以将该 Docker 应用停掉。

由于会使用到 Docker，因此需要具备 Docker 的环境。使用以下命令在跳板机安装并启动 Docker：

环境准备完成后，即可部署 Kuboard-Spray。

执行以下命令安装 Kuboard-Spray：

如果由于网络问题导致镜像拉取失败，可以使用下面的备用地址：

执行完成后，即可在浏览器输入 http://192.168.56.9 (跳板机 IP 地址）打开 Kuboard-Spray 的 Web 界面，输入用户名 admin，默认密码 Kuboard123，即可登录 Kuboard-Spray 界面，如下所示：

登录之后，即可开始部署 Kubernetes 集群。

登录 Kuboard-Spray 界面之后，即可开始可视化部署 Kubernetes 集群。

安装界面会通过在线下载的方式，下载 Kubernetes 集群所对应的资源包，以实现离线安装 Kubernetes 集群。

点击资源包管理，选择对应版本的 Kubernetes 资源包下载：

下载 spray-v2.19.0c_Kubernetes-v1.24.10_v2.9-amd64 版本

点击导入后，选择加载资源包，选择合适的下载源，等待资源包下载完成。

此时会 pull 相关的镜像依赖：

镜像资源包拉取成功后，返回 Kuboard-Spray 的 Web 界面，可以看到对应版本的资源包已经导入完成。

本章节将指导你进行 Kubernetes 集群的安装。

选择集群管理，选择添加集群安装计划：

在弹出的对话框中，定义集群的名称，选择刚刚导入的资源包的版本，再点击确定。如下图所示：

按照事先定义好的角色分类，Kubernetes 集群采用 1 master + 1 worker +1 etcd 的模式进行部署。

在上一步定义完成集群名称，并选择完成资源包版本，点击确定之后，接下里可以直接接入到集群规划阶段。

选择对应节点的角色和名称：

在每一个节点填写完角色和节点名称后，请在右侧填写对应节点的连接信息，如下图所示：

填写完所有的角色之后，点击保存。接下里就可以准备安装 Kubernetes 集群了。

在上一步填写完成所有角色，并保存后，点击执行，即可开始 Kubernetes 集群的安装。

如下图所示，点击确定，开始安装 Kubernetes 集群：

安装 Kubernetes 集群时，会在对应节点上执行 ansible 脚本，安装 Kubernetes 集群。整体事件会根据机器配置和网络不同，需要等待的时间不同，一般情况下需要 5 ~ 10 分钟。

Note: 如果出现错误，你可以看日志的内容，确认是否是 Kuboard-Spray 的版本不匹配，如果版本不匹配，请更换合适的版本。

安装完成后，到 Kubernetes 集群的 master 节点上执行 kubectl get node：

命令结果如上图所示，即表示 Kubernetes 集群安装完成。

Operator 的安装依赖于 helm，因此需要先安装 helm。

Note: 本章节均是在 master0 节点操作。

下载 helm 安装包：

如果由于网络问题造成下载缓慢，你可以到官网下载最新的二进制安装包，上传到服务器。

解压并安装：

验证版本，查看是否安装完成：

出现上面所示版本信息即表示安装完成。

CSI 为 Kubernetes 的存储插件，为 MinIO 和 MarixOne 提供存储服务。本章节将指导你使用 local-path-provisioner 插件。

Note: 本章节均是在 master0 节点操作。

使用下面的命令行，安装 CSI：

安装成功后，命令行显示如下所示：

Note: 安装完成后，该 storageClass 会在 worker 节点的 "/opt/local-path-provisioner" 目录提供存储服务。你可以修改为其它路径。

设置缺省 storageClass：

设置缺省成功后，命令行显示如下：

MinIO 的作用是为 MatrixOne 提供对象存储。本章节将指导你部署一个单节点的 MinIO。

Note: 本章节均是在 master0 节点操作。

安装并启动 MinIO 的命令行如下：

Note

安装并启动 MinIO 成功后，命令行显示如下所示：

启动后，使用 http:// Kubernetes 集群任何一台机器的 ip:32001 即可登录 MinIO 的页面，创建对象存储的信息。如下图所示，账户密码即上述步骤中 --set rootUser=rootuser,rootPassword=rootpass123 设置的 rootUser 和 rootPassword：

登录完成后，你需要创建对象存储相关的信息：

a. 点击 Bucket > Create Bucket，在 Bucket Name 中填写 Bucket 的名称 minio-mo。填写完成后，点击右下方按钮 Create Bucket。

b. 在当前 minio-mo 中，点击 Choose or create a new path，在 New Folder Path 中填写名称 test，填写完成后，点击 Create，即完成创建。

本章节将指导你部署 MatrixOne 集群。

Note: 本章节均是在 master0 节点操作。

使用如下命令行安装 matrixone-operator：

安装成功后，使用如下命令行进行再次确认：

如上上代码行所示，对应 Pod 状态均正常。

自定义 MatrixOne 集群的 yaml 文件，示例如下：

编写如下 mo.yaml 的文件：

定义 MatrixOne 访问 MinIO 的 secret 服务：

用户名和密码使用创建 MinIO 集群时设定的 rootUser 和 rootPassword。

使用如下命令行部署 MatrixOne 集群：

需等待 10 来分钟，如发生 pod 重启，请继续等待。直到如下显示表示部署成功：

由于提供对外访问的 CN 的 pod id 不是 node ip，因此，你需要将对应服务的端口映射到 MatrixOne 节点上。本章节将指导你使用 kubectl port-forward 连接 MatrixOne 集群。

指定允许本地访问或指定某台机器或者所有机器访问后，使用 MySQL 客户端连接 MatrixOne：

显式 mysql> 后，分布式的 MatrixOne 集群搭建连接完成。