使用 TiUP 部署 TiDB 集群

1.创建tidb用户

groupadd tidb && useradd tidb -g  tidb

echo "tidb"|passwd --stdin tidb

2.下载离线包

在软件下载中心选择对应版本的TiDB-community-server 软件包和 TiDB-community-toolkit 软件包

https://pingkai.cn/download#tidb-community

3.将离线包发送到目标集群的中控机后，执行以下命令安装 TiUP 组件：

su - tidb

mkdir /data/soft -p  

tar xzvf tidb-community-server-${version}-linux-amd64.tar.gz && \
sh tidb-community-server-${version}-linux-amd64/local_install.sh && \
source /home/tidb/.bash_profile

4.合并离线包

执行以下命令合并离线组件到 server 目录下

tar xf tidb-community-toolkit-${version}-linux-amd64.tar.gz
ls -ld tidb-community-server-${version}-linux-amd64 tidb-community-toolkit-${version}-linux-amd64
cd tidb-community-server-${version}-linux-amd64/
cp -rp keys ~/.tiup/
tiup mirror merge ../tidb-community-toolkit-${version}-linux-amd64

5.编辑初始化集群拓扑文件

vi.topology.yaml

# 全局配置，所有组件默认继承这些参数，组件可单独覆盖
global:                 
  user: "tidb"           # 集群运行的系统用户（需在所有节点提前创建，如tidb用户）
  ssh_port: 22           # 所有节点的SSH端口（默认22，若节点SSH端口不同需在组件中单独指定）
  deploy_dir: "/tidb-deploy"  # 所有组件的二进制文件安装目录（如TiDB/PD的可执行文件存放路径）
  data_dir: "/tidb-data"      # 所有组件的数据存储目录（如TiKV的存储文件、PD的元数据存放路径）
​
# 监控相关配置，所有节点都会部署的基础监控组件
monitored:             
  node_exporter_port: 9100  # 节点级监控组件（node_exporter）的端口，用于采集CPU/内存等主机指标
  blackbox_exporter_port: 9115  # 黑盒监控组件（blackbox_exporter）的端口，用于监控网络连通性、端口存活等
​
# 各组件的核心功能配置（对应组件的配置文件参数）
server_configs:
 tidb:                 
    log.slow-threshold: 300  # 慢查询阈值（单位：毫秒），执行时间超过300ms的SQL会被记录到慢查询日志
  tikv:                 
    readpool.storage.use-unified-pool: false  # 关闭存储层读请求的统一线程池（专用线程池处理存储读请求）
    readpool.coprocessor.use-unified-pool: true  # 开启协处理器读请求的统一线程池（优化计算任务调度）
  pd:                    
    replication.enable-placement-rules: true  # 启用PD的Placement Rules功能（控制数据副本分布策略）
    replication.location-labels: ["host"]    # 副本分布的维度标签（此处按"主机"划分，确保副本分散在不同节点）
  tiflash:              
    logger.level: "info"  # 日志级别（info为默认，调试时可改为debug）
​
# PD集群节点列表
pd_servers:
 - host: 10.160.196.89
 - host: 10.160.196.90
 - host: 10.160.196.91
 
# TiDB集群节点列表
tidb_servers:
 - host: 10.160.196.89
 - host: 10.160.196.90
 - host: 10.160.196.93
 
# TiKV集群节点列表
tikv_servers:
 - host: 10.160.196.89
 - host: 10.160.196.90
 - host: 10.160.196.91
 - host: 10.160.196.92
​
# 监控聚合组件（Prometheus）
monitoring_servers:
 - host: 10.160.196.92
​
# 监控可视化组件（Grafana）部署节点
grafana_servers:
 - host: 10.160.196.92

6.集群主机之间互信

中控主机 tidb用户执行 ssh-keygen生产 id_rsa.pub

ssh-copy -i /home/tidb/.ssh/id_rsa.pub  tidb@10.160.196.89
ssh-copy -i /home/tidb/.ssh/id_rsa.pub  tidb@10.160.196.90
ssh-copy -i /home/tidb/.ssh/id_rsa.pub  tidb@10.160.196.91
ssh-copy -i /home/tidb/.ssh/id_rsa.pub  tidb@10.160.196.92

7.执行部署命令
检查集群存在的潜在风险

tiup cluster check ./topology.yaml --user tidb -p

自动修复集群存在的潜在风险：

tiup cluster check ./topology.yaml --apply --user tidb -p

部署 TiDB 集群

tiup cluster deploy tidb-test v7.1.0 ./topology.yaml --user tidb -p

8.查看 TiUP 管理的集群情况

tiup cluster list

检查部署的 TiDB 集群情况

tiup cluster display tidb-test

9.启动集群

方式一：安全启动

tiup cluster start tidb-test --init

方式二：普通启动

tiup cluster start tidb-test

10.验证集群运行状

tiup cluster display tidb-test