部署本地测试集群
- 适用场景:利用本地单机 Linux 环境快速部署 TiDB 测试集群,体验 TiDB 集群的基本架构,以及 TiDB、TiKV、PD、监控等基础组件的运行。
1.下载并安装 TiUP
~$ curl --proto '=https' --tlsv1.2 -sSf https://tiup-mirrors.pingcap.com/install.sh | sh
2.声明全局环境变量
注意
TiUP 安装完成后会提示对应
profile
文件的绝对路径。在执行以下source
命令前,需要根据profile
文件的实际位置修改命令。
~$ source /home/cwj0/.bashrc
3.在当前 session 执行以下命令启动集群
-
直接运行
tiup playground
命令会运行最新版本的 TiDB 集群,其中 TiDB、TiKV、PD 和 TiFlash 实例各 1 个:tiup playground # tiup --tag tidb_tag playground # 持久化 # tiup playground # 下次直接执行,就不会下载了
-
也可以指定 TiDB 版本以及各组件实例个数,命令类似于:
tiup playground v5.4.0 --db 2 --pd 3 --kv 3
上述命令会在本地下载并启动某个版本的集群(例如 v5.4.0)。最新版本可以通过执行
tiup list tidb
来查看。运行结果将显示集群的访问方式:
CLUSTER START SUCCESSFULLY, Enjoy it ^-^
To connect TiDB: mysql --comments --host 127.0.0.1 --port 4000 -u root -p (no password)
To view the dashboard: http://127.0.0.1:2379/dashboard
PD client endpoints: [127.0.0.1:2379]
To view the Prometheus: http://127.0.0.1:9090
To view the Grafana: http://127.0.0.1:3000
注意
- 以这种方式执行的 playground,在结束部署测试后 TiUP 会清理掉原集群数据,重新执行该命令后会得到一个全新的集群。
- 若希望持久化数据,可以执行 TiUP 的
--tag
参数:tiup --tag <your-tag> playground ...
,详情参考 TiUP 参考手册。
4.新开启一个 session 以访问 TiDB 数据库
-
使用 TiUP
client
连接 TiDB:tiup client
-
也可使用 MySQL 客户端连接 TiDB:
mysql --host 127.0.0.1 --port 4000 -u root
5.访问TiDB管理界面
通过 http://127.0.0.1:9090 访问 TiDB 的 Prometheus 管理界面。
6.访问TiDB Dashboard页面
通过 http://127.0.0.1:2379/dashboard 访问 TiDB Dashboard 页面,默认用户名为 root,密码为空。
7.访问 TiDB 的 Grafana 界面
通过 http://127.0.0.1:3000 访问 TiDB 的 Grafana 界面,默认用户名和密码都为 admin。
8.(可选)
将数据加载到 TiFlash 进行分析。
9.清理集群
测试完成之后,可以通过执行以下步骤来清理集群:
i. 通过按下 ctrl + c 键停掉进程。
ii. 执行以下命令:
tiup clean --all
注意
TiUP Playground 默认监听
127.0.0.1
,服务仅本地可访问。若需要使服务可被外部访问,可使用--host
参数指定监听网卡绑定外部可访问的 IP。
10.superset连接
mysql://root@127.0.0.1:4000/mysql
11.下次连接
tiup playground
参考地址:
https://docs.pingcap.com/zh/tidb/stable/quick-start-with-tidb