使用 TiUP 部署 TiDB 集群

    目前 TiUP 可以支持部署 TiDB、TiFlash、TiDB Binlog、TiCDC，以及监控系统。本文将介绍不同集群拓扑的具体部署步骤。

    环境与系统配置检查

    第 2 步：在中控机上安装 TiUP 组件

    使用普通用户登录中控机，以 用户为例，后续安装 TiUP 及集群管理操作均通过该用户完成：

    1. 执行如下命令安装 TiUP 工具：

    2. 按如下步骤设置 TiUP 环境变量：

      重新声明全局环境变量：

      1.  source .bash_profile

      确认 TiUP 工具是否安装：

      1.  which tiup

    3. 安装 TiUP cluster 组件

      1.  tiup cluster

    4. 如果已经安装，则更新 TiUP cluster 组件至最新版本：

      预期输出 “Update successfully!” 字样。

    5. 验证当前 TiUP cluster 版本信息。执行如下命令查看 TiUP cluster 组件版本：

      第 3 步：编辑初始化配置文件

      请根据不同的集群拓扑，编辑 TiUP 所需的集群初始化配置文件。

      这里举出常见的 6 种场景，请根据链接中的拓扑说明，以及给出的配置文件模板，新建一个配置文件 topology.yaml。如果有其他组合场景的需求，请根据多个模板自行调整。

      • 增加 TiFlash 拓扑架构

        包含最小拓扑的基础上，同时部署 TiFlash。TiFlash 是列式的存储引擎，已经逐步成为集群拓扑的标配。适合 Real-Time HTAP 业务。

      • 包含最小拓扑的基础上，同时部署 TiCDC。TiCDC 是 4.0 版本开始支持的 TiDB 增量数据同步工具，支持多种下游 (TiDB/MySQL/MQ)。相比于 TiDB Binlog，TiCDC 有延迟更低、天然高可用等优点。在部署完成后，需要启动 TiCDC，通过 cdc cli 创建同步任务。

      • 包含最小拓扑的基础上，同时部署 TiDB Binlog。TiDB Binlog 是目前广泛使用的增量同步组件，可提供准实时备份和同步功能。

      • 增加 TiSpark 拓扑架构

        包含最小拓扑的基础上，同时部署 TiSpark 组件。TiSpark 是 PingCAP 为解决用户复杂 OLAP 需求而推出的产品。TiUP cluster 组件对 TiSpark 的支持目前为实验性特性。

      • 适用于单台机器，混合部署多个实例的情况，也包括单机多实例，需要额外增加目录、端口、资源配比、label 等配置。

      • 跨机房部署拓扑架构

        以典型的 两地三中心 架构为例，介绍跨机房部署架构，以及需要注意的关键设置。

      1. tiup cluster deploy tidb-test v4.0.0 ./topology.yaml --user root [-p] [-i /home/root/.ssh/gcp_rsa]

      以上部署命令中：

      • 部署版本为 ，最新版本可以通过执行 tiup list tidb 来查看 TiUP 支持的版本
      • 初始化配置文件为 topology.yaml
      • —user root：通过 root 用户登录到目标主机完成集群部署，该用户需要有 ssh 到目标机器的权限，并且在目标机器有 sudo 权限。也可以用其他有 ssh 和 sudo 权限的用户完成部署。
      • [-i] 及 [-p]：非必选项，如果已经配置免密登陆目标机，则不需填写。否则选择其一即可，[-i] 为可登录到目标机的 root 用户（或 —user 指定的其他用户）的私钥，也可使用 [-p] 交互式输入该用户的密码
      • 如果需要指定在目标机创建的用户组名，可以参考。

      预期日志结尾输出会有 Deployed cluster `tidb-test` successfully 关键词，表示部署成功。

      第 5 步：查看 TiUP 管理的集群情况

      1. tiup cluster list

      TiUP 支持管理多个 TiDB 集群，该命令会输出当前通过 TiUP cluster 管理的所有集群信息，包括集群名称、部署用户、版本、密钥信息等：

      第 6 步：检查部署的 TiDB 集群情况

      例如，执行如下命令检查 tidb-test 集群情况：

      1. tiup cluster display tidb-test

      预期输出包括 tidb-test 集群中实例 ID、角色、主机、监听端口和状态（由于还未启动，所以状态为 Down/inactive）、目录信息。

      1. tiup cluster start tidb-test

      预期结果输出 Started cluster `tidb-test` successfully 标志启动成功。

      第 8 步：验证集群运行状态

      • 通过 TiUP 检查集群状态
      1. tiup cluster display tidb-test

      预期结果输出，注意 Status 状态信息为 Up 说明集群状态正常

      • 执行如下命令登录数据库：

      此外，也需要验证监控系统、TiDB Dashboard 的运行状态，以及简单命令的执行，验证方式可参考。

      探索更多

      如果你已同时部署了 TiFlash，接下来可参阅以下文档：

      如果你已同时部署了 ，接下来可参阅以下文档：