暂无图片
暂无图片
暂无图片
暂无图片
暂无图片

使用playground运行TiDB本地测试集群

原创 龙舌兰地落🌏 2024-10-04
579

TiDB 是一个分布式系统。最基础的 TiDB 测试集群通常由 2 个 TiDB 实例、3 个 TiKV 实例、3 个 PD 实例和可选的 TiFlash 实例构成。通过 TiUP Playground,可以快速搭建出上述的一套基础测试集群,步骤如下:

环境准备

TiUP工具:
TiUP是TiDB4.0版本引入的集群运维工具,通过TiUP可以进行TiDB的日常运维工作,包括部署、启动、关闭、销毁、弹性扩容和升级TiDB集群,以及管理TiDB集群参数。
每个集群节点都要部署TiUP。

TiUP的playground组件可以在本地环境中模拟出一个TiDB集群,也就是说,使用playground的命令可以一键搭建出一个TiDB集群,这个集群可供测试使用,但不适用于生产环境,只适用于单机 Linux 环境快速部署 TiDB 测试集群,体验 TiDB 集群的基本架构,以及 TiDB、TiKV、PD、监控等基础组件的运行。(测试环境操作系统为ubuntu16.04)。

此外需要可以连接到外网环境,以方便下载软件安装介质。

TiUP安装

1.下载并安装TiUP

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

安装完成后会提示如下信息:

Successfully set mirror to https://tiup-mirrors.pingcap.com
Detected shell: bash
Shell profile:  /home/user/.bashrc
/home/user/.bashrc has been modified to add tiup to PATH
open a new terminal or source /home/user/.bashrc to use it
Installed path: /home/user/.tiup/bin/tiup
===============================================
Have a try:     tiup playground
===============================================

2.声明全局环境变量
TiUP 安装完成后会提示 Shell profile 文件的绝对路径。在执行以下 source 命令前,需要将 ${your_shell_profile} 修改为 Shell profile 文件的实际位置。

source ${your_shell_profile}

如:

source  /home/user/.bashrc

使用playground运行集群

运行集群
在当前 session 执行以下命令启动集群:
直接运行 tiup playground 命令会运行最新版本的 TiDB 集群,其中 TiDB、TiKV、PD 和 TiFlash 实例各 1 个:

tiup playground

也可以指定 TiDB 版本以及各组件实例个数,命令类似于:

tiup playground v8.1.1 --db 2 --pd 3 --kv 3

或者:

tiup playground v8.1.1 --db 2 --pd 3 --kv 3 --monitor

上述命令会在本地下载并启动某个版本的集群(例如 v8.1.1)。最新版本可以通过执行 tiup list tidb 来查看。
运行过程可以看到先启动PD、再启动TiKV、再启动TiDB。
运行结果将显示集群的访问方式:

CLUSTER START SUCCESSFULLY, Enjoy it ^-^
To connect TiDB: mysql --host 127.0.0.1 --port 4000 -u root -p (no password) --comments
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 会清理掉原集群数据,重新执行该命令后会得到一个全新的集群。因此我们运行完毕后要光标悬停再此,不要Control+C,也不要关闭session窗口。
  • 若希望持久化数据,可以执行 TiUP 的 --tag 参数:tiup --tag <your-tag> playground ...,详情参考 TiUP 参考手册

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

tiup client

也可使用 MySQL 客户端连接 TiDB,不要求密码:

mysql --host 127.0.0.1 --port 4000 -u root

TiUP Playground 默认监听 127.0.0.1,服务仅本地可访问。若需要使服务可被外部访问,可使用 --host 参数指定监听网卡绑定外部可访问的 IP。

管理与监控工具
通过http://127.0.0.1:9090访问 TiDB 的 Prometheus 管理界面。
通过http://127.0.0.1:2379/dashboard访问 TiDB Dashboard 页面,默认用户名为 root,密码为空。
通过http://127.0.0.1:3000访问 TiDB 的 Grafana 界面,默认用户名和密码都为 admin
(可选)将数据加载到 TiFlash 进行分析。

清理集群
测试完成之后,可以通过执行以下步骤来清理集群:
按下 Control+C 键停掉上述启用的 TiDB 服务。
等待服务退出操作完成后,执行以下命令:

tiup clean --all

注意在生产环境要慎用这个命令,因为还会清除数据。

参考官网:

https://docs.pingcap.com/zh/tidb/stable/quick-start-with-tidb
「喜欢这篇文章,您的关注和赞赏是给作者最好的鼓励」
关注作者
【版权声明】本文为墨天轮用户原创内容,转载时必须标注文章的来源(墨天轮),文章链接,文章作者等基本信息,否则作者和墨天轮有权追究责任。如果您发现墨天轮中有涉嫌抄袭或者侵权的内容,欢迎发送邮件至:contact@modb.pro进行举报,并提供相关证据,一经查实,墨天轮将立刻删除相关内容。

文章被以下合辑收录

评论