11.TiDB集群部署

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

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

1 ·

CC 4.0 BY-SA版权

原文链接：https://docs.pingcap.com/zh/tidb/stable

tidb 专栏收录该内容

11 篇文章

订阅专栏

本文介绍了最小规模 TiDB 集群拓扑的搭建步骤，包括下载安装 TiUP、安装其 cluster 组件、更新软件版本、调大 sshd 服务连接数限制、创建并启动集群、执行部署命令、启动集群，还说明了访问 TiDB 数据库、Grafana 监控和 Dashboard 的方法。

最小规模的 TiDB 集群拓扑：

实例	个数	IP	配置
TiKV	3	10.0.1.1 10.0.1.1 10.0.1.1	避免端口和目录冲突
TiDB	1	10.0.1.1	默认端口全局目录配置
PD	1	10.0.1.1	默认端口全局目录配置
TiFlash	1	10.0.1.1	默认端口全局目录配置
Monitor	1	10.0.1.1	默认端口全局目录配置

1.下载并安装 TiUP：

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

2. 安装 TiUP 的 cluster 组件：

tiup cluster

3. 如果机器已经安装 TiUP cluster，需要更新软件版本：

tiup update --self && tiup update cluster

4. 如果使用单机模拟多机部署，需要通过 root 用户调大 sshd 服务的连接数限制：

i.修改 /etc/ssh/sshd_config 将 MaxSessions 调至 20。

ii. 重启 sshd 服务：

service sshd restart

5. 创建并启动集群

按下面的配置模板，编辑配置文件，命名为 topo.yaml，其中：

user: "tidb"：表示通过 tidb 系统用户（部署会自动创建）来做集群的内部管理，默认使用 22 端口通过 ssh 登录目标机器
replication.enable-placement-rules：设置这个 PD 参数来确保 TiFlash 正常运行
host：设置为本部署主机的 IP

配置模板如下：

# # Global variables are applied to all deployments and used as the default value of
# # the deployments if a specific deployment value is missing.
global:
 user: "tidb"
 ssh_port: 22
 deploy_dir: "/usr/local/yunji/tidb"
 data_dir: "/usr/local/yunji/tidb/data"

# # Monitored variables are applied to all the machines.
monitored:
 node_exporter_port: 9100
 blackbox_exporter_port: 9115

server_configs:
 tidb:
   log.slow-threshold: 300
 tikv:
   readpool.storage.use-unified-pool: false
   readpool.coprocessor.use-unified-pool: true
 pd:
   replication.enable-placement-rules: true
   replication.location-labels: ["host"]
 tiflash:
   logger.level: "info"

pd_servers:
 - host: 172.16.0.82

tidb_servers:
 - host: 172.16.0.82

tikv_servers:
 - host: 172.16.0.82
   port: 20160
   status_port: 20180
   config:
     server.labels: { host: "logic-host-1" }

 - host: 172.16.0.82
   port: 20161
   status_port: 20181
   config:
     server.labels: { host: "logic-host-2" }

 - host: 172.16.0.82
   port: 20162
   status_port: 20182
   config:
     server.labels: { host: "logic-host-3" }

tiflash_servers:
 - host: 172.16.0.82

monitoring_servers:
 - host: 172.16.0.82

grafana_servers:
 - host: 172.16.0.82

6.执行集群部署命令：

tiup cluster deploy <cluster-name> <tidb-version> ./topo.yaml --user root -p

参数 <cluster-name> 表示设置集群名称
参数 <tidb-version> 表示设置集群版本，可以通过 tiup list tidb 命令来查看当前支持部署的 TiDB 版本

按照引导，输入”y”及 root 密码，来完成部署：

7. 启动集群：

tiup cluster start <cluster-name>

8.访问集群

访问 TiDB 数据库，密码为空：mysql -h {ip} -P 4000 -u root
访问 TiDB 的 Grafana 监控：通过 http://{grafana-ip}:3000 访问集群 Grafana 监控页面，默认用户名和密码均为 admin。
访问 TiDB 的 Dashboard：通过 http://{pd-ip}:2379/dashboard 访问集群 TiDB Dashboard 监控页面，默认用户名为 root，密码为空。