TiUP部署 TiDB 数据库集群

最新推荐文章于 2025-09-17 19:25:40 发布

原创

最新推荐文章于 2025-09-17 19:25:40 发布 · 2.7k 阅读

CC 4.0 BY-SA版权

文章标签：

本文介绍了如何使用TiUP工具部署和管理TiDB集群，包括在本地搭建测试集群和模拟生产环境集群的步骤。通过TiUPcluster组件，可以实现部署、启动、关闭、销毁、扩容、升级等运维操作。此外，还提供了访问和测试集群的方法以及清理集群的命令。

TiUP 是 TiDB 4.0 版本引入的集群运维工具，TiUP cluster 是 TiUP 提供的使用 Golang 编写的集群管理组件，通过 TiUP cluster 组件就可以进行日常的运维工作，包括部署、启动、关闭、销毁、弹性扩缩容、升级 TiDB 集群，以及管理 TiDB 集群参数。

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

本次演示在线安装，仅适用于快速上手体验，不适用于生产环境：
1.TiDB部署本地测试集群（支持 Mac 和 Linux）
2.在单机上模拟部署生产环境集群（支持 Linux）
3. 生产部署可参考官网文档：PingCAP官方文档

 适用场景：利用本地 Mac 或者单机 Linux 环境快速部署 TiDB 测试集群，体验 TiDB 集群的基本架构，以及TiDB、TiKV、PD、监控等基础组件的运行。

1.下载并安装TiUP

curl --proto '=https' --tlsv1.2 -sSf https://tiup-mirrors.pingcap.com/install.sh | sh

2.声明全局环境变量
#source <profile 文件绝对路径>

source /root/.bash_profile

3.在当前 session 执行以下命令启动集群
运行最新版本的TiDB集群，其中TiDB、TiKV、PD和TiFlash实例个1个

tiup playground

也可以指定TiDB版本以及各组件实例个数:

tiup playground v5.0.0 --db 2 --pd 3 --kv 3 --monitor

上述命令会在本地下载并启动某个版本的集群（例如 v5.0.0），--monitor 表示同时部署监控组件。
最新版本可以通过执行 tiup list tidb 来查看。

注意：
(1).以这种方式执行的 playground，在结束部署测试后 TiUP 会清理掉原集群数据，重新执行该命令后会得到一个全新的集群。
(2).默认监听 127.0.0.1，服务仅本地可访问。若需要使服务可被外部访问，可使用 --host 参数指定监听网卡绑定外部可访问的 IP

4.新开启一个 session 以访问 TiDB 数据库
使用 TiUP client 连接 TiDB:

tiup client

也可使用 MySQL 客户端连接 TiDB：

mysql --host 127.0.