单机部署TiDB

莠畅缕 发表于 2025-6-30 18:42:57

目录

[*]一、准备环境

[*]1、os版本确认
[*]2、关闭防火墙及SELinux

[*]2.1、关闭防火墙服务
[*]2.2、关闭SELinux

[*]3、关闭大页内存
[*]4、检测及关闭系统swap
[*]5、TiDB集群拓扑
[*]6、内存推荐

[*]二、实施部署

[*]1、下载并安装TiUP
[*]2、声明全局环境变量
[*]3、安装 TiUP 的 cluster 组件
[*]4、调大 sshd 服务的连接数限制
[*]5、创建拓扑配置文件
[*]6、执行集群部署命令

[*]6.1、交互式输入root用户密码和y继续

[*]7、启动集群
[*]8、查看集群列表和拓扑结构

[*]8.1、查看已部署的集群列表
[*]8.2、查看集群的拓扑结构和状态

[*]9、访问集群端点

[*]9.1、安装MySQL客户端
[*]9.2、使用MySQL客户端访问TiDB数据库

[*]10、访问Grafana监控页面
[*]11、集群 TiDB Dashboard 监控页面

[*]三、卸载TiDB

[*]1、语法
[*]2、选项

官网 - 在单机上模拟部署生产环境集群
一、准备环境

1、os版本确认

[*]目前 TiUP Cluster 支持在 x86_64（AMD64）和 ARM 架构上部署 TiDB 集群

[*]在 AMD64 架构下，建议使用 CentOS 7.3 及以上版本 Linux 操作系统
[*]在 ARM 架构下，建议使用 CentOS 7.6 (1810) 版本 Linux 操作系统

[*]仅centos版本
[*]cat /etc/centos-releasehttps://raw.githubusercontent.com/misakivv/lingxing-typora-images/master/Documentimage-20250627112224297.png
[*]通用脚本
[*]#!/bin/bashbash /dev/null elif [ -f /etc/redhat-release ]; then rhel_ver=$(awk '{print $(NF-1)}' /etc/redhat-release 2>/dev/null) echo "RHEL Version: $rhel_ver" rpm -q redhat-release-server --queryformat 'Release Package: %{VERSION}-%{RELEASE}\n' 2>/dev/null || rpm -q redhat-release --queryformat 'Release Package: %{VERSION}-%{RELEASE}\n' 2>/dev/null fi # Ubuntu if [ -f /etc/lsb-release ]; then echo "Ubuntu Version: $(lsb_release -ds 2>/dev/null || grep DISTRIB_DESCRIPTION /etc/lsb-release | cut -d= -f2)" fi # Debian if [ -f /etc/debian_version ]; then debian_ver=$(cat /etc/debian_version 2>/dev/null) echo "Debian Version: $debian_ver" fi # Amazon Linux if grep -q "Amazon Linux" /etc/os-release 2>/dev/null; then echo "Amazon Linux Version: $(grep PRETTY_NAME /etc/os-release | cut -d'"' -f2)" fi # Alpine if [ -f /etc/alpine-release ]; then echo "Alpine Version: $(cat /etc/alpine-release)" fi} 2>/dev/null# 核心系统信息echo -e "\n===== Core System Info ====="echo "Kernel Version: $(uname -r)"echo "System Arch: $(uname -m)"echo "Hostname: $(hostname -f 2>/dev/null || hostname)"# 增强版uptime信息echo -n "Uptime: "if uptime -p &>/dev/null; then uptime -p | sed 's/up //'else awk '{printf "%d days, %d hours", int($1/86400), int(($1%86400)/3600)}' /proc/uptimefi# 内存信息echo -e "\n===== Memory Usage ====="free -h | awk '/Mem:/{printf "Total: %s, Used: %s, Free: %s (%.1f%% used)\n", $2, $3, $4, $3/$2*100}'# 磁盘根分区信息echo -e "\n===== Disk Usage (Root) ====="df -h / | awk 'NR==2{printf "Total: %s, Used: %s, Avail: %s (%.1f%% used)\n", $2, $3, $4, $5}'echo -e "\n===== ====="EOF
2、关闭防火墙及SELinux

2.1、关闭防火墙服务

systemctl stop firewalld.servicesystemctl disable firewalld.servicesystemctl status firewalld.service2.2、关闭SELinux

sed -i "s/SELINUX=enforcing/SELINUX=disabled/" /etc/selinux/configgetenforcehttps://raw.githubusercontent.com/misakivv/lingxing-typora-images/master/Documentimage-20250627114216308.png
3、关闭大页内存

cat /sys/kernel/mm/transparent_hugepage/enabledcat /sys/kernel/mm/transparent_hugepage/defragecho never > /sys/kernel/mm/transparent_hugepage/enabledecho never > /sys/kernel/mm/transparent_hugepage/defragcat /sys/kernel/mm/transparent_hugepage/enabledcat /sys/kernel/mm/transparent_hugepage/defraghttps://raw.githubusercontent.com/misakivv/lingxing-typora-images/master/Documentimage-20250627114433205.png
4、检测及关闭系统swap

echo "vm.swappiness = 0">> /etc/sysctl.confsysctl -pswapoff -a && swapon -a如果在部署时使用参数 --user root -p 就可以忽略免密互信，对于有需求的可以参考免密互信
5、TiDB集群拓扑

最小规模的 TiDB 集群拓扑包含以下实例：
实际部署时IP即为本机实际IP
实例个数IP配置TiKV3127.0.0.1使用递增的端口号以避免冲突TiDB1127.0.0.1使用默认端口和其他配置PD1127.0.0.1使用默认端口和其他配置TiFlash1127.0.0.1使用默认端口和其他配置Monitor1127.0.0.1使用默认端口和其他配置6、内存推荐

最小化安装我尝试过的内存设置是至少8.6G，推荐本地测试集群内存设置为16G
二、实施部署

1、下载并安装TiUP

遇到 curl SSL 证书验证失败的情况，在命令后面增加 --insecure 即可
curl --proto '=https' --tlsv1.2 -sSf https://tiup-mirrors.pingcap.com/install.sh | shhttps://raw.githubusercontent.com/misakivv/lingxing-typora-images/master/Documentimage-20250627134340094.png
2、声明全局环境变量

${your_shell_profile} 在安装TiUP输出的信息中有，对应着声明即可
source /root/.bash_profile3、安装 TiUP 的 cluster 组件

tiup cluster# 如果机器已经安装 TiUP cluster，需要更新软件版本：tiup update --self && tiup update clusterhttps://raw.githubusercontent.com/misakivv/lingxing-typora-images/master/Documentimage-20250627135012754.png
4、调大 sshd 服务的连接数限制

[*]由于模拟多机部署，需要通过 root 用户调大 sshd 服务的连接数限制。修改 /etc/ssh/sshd_config 将 MaxSessions 调至 20。
[*]sed -i '/^#*MaxSessions[[:space:]]\+\+/s/.*/MaxSessions 20/' /etc/ssh/sshd_config
[*]https://raw.githubusercontent.com/misakivv/lingxing-typora-images/master/DocumentDocumentimage-20250613174836425.png
[*]重启sshd服务
[*]service sshd restart
5、创建拓扑配置文件

[*]user: "tidb"：表示通过 tidb 系统用户（部署会自动创建）来做集群的内部管理，默认使用 22 端口通过 ssh 登录目标机器
[*]replication.enable-placement-rules：设置这个 PD 参数来确保 TiFlash 正常运行
[*]host：设置为本部署主机的 IP，单机部署IP设置为 127.0.0.1 即可
global: user: "tidb" ssh_port: 22 deploy_dir: "/tidb-deploy" data_dir: "/tidb-data"monitored: node_exporter_port: 9100 blackbox_exporter_port: 9115server_configs: tidb: instance.tidb_slow_log_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: 127.0.0.1tidb_servers: - host: 127.0.0.1tikv_servers: - host: 127.0.0.1 port: 20160 status_port: 20180 config: server.labels: { host: "logic-host-1" } - host: 127.0.0.1 port: 20161 status_port: 20181 config: server.labels: { host: "logic-host-2" } - host: 127.0.0.1 port: 20162 status_port: 20182 config: server.labels: { host: "logic-host-3" }tiflash_servers: - host: 127.0.0.1monitoring_servers: - host: 127.0.0.1grafana_servers: - host: 127.0.0.16、执行集群部署命令

tiup cluster deploy ./topo.yaml --user root -p

[*]参数表示设置集群名称
[*]参数表示设置集群版本，例如 v8.5.1。可以通过 tiup list tidb 命令来查看当前支持部署的 TiDB 版本
[*]参数 --user 表示初始化环境的用户
[*]参数 -p 表示在连接目标机器时使用密码登录
tiup cluster deploy tidb_test1 v8.5.1 ./topo.yaml --user root -p6.1、交互式输入root用户密码和y继续

https://raw.githubusercontent.com/misakivv/lingxing-typora-images/master/Documentimage-20250627141953226.png
https://raw.githubusercontent.com/misakivv/lingxing-typora-images/master/Documentimage-20250627142653761.png
7、启动集群

tiup cluster start tidb_test1https://raw.githubusercontent.com/misakivv/lingxing-typora-images/master/DocumentDocumentimage-20250627142915472.png
8、查看集群列表和拓扑结构

8.1、查看已部署的集群列表

tiup cluster listhttps://raw.githubusercontent.com/misakivv/lingxing-typora-images/master/Documentimage-20250627143810593.png
8.2、查看集群的拓扑结构和状态

tiup cluster display tidb_test1https://raw.githubusercontent.com/misakivv/lingxing-typora-images/master/Documentimage-20250627144206296.png
9、访问集群端点

9.1、安装MySQL客户端

如果已安装，可以跳过这一步
yum install -y mysqlhttps://raw.githubusercontent.com/misakivv/lingxing-typora-images/master/Documentimage-20250627150309941.png
9.2、使用MySQL客户端访问TiDB数据库

密码为空
mysql -h 192.168.202.20 -P 4000 -u roothttps://raw.githubusercontent.com/misakivv/lingxing-typora-images/master/Documentimage-20250627151025690.png
10、访问Grafana监控页面

默认用户名和密码都是admin
http://192.168.202.20:3000https://raw.githubusercontent.com/misakivv/lingxing-typora-images/master/Documentimage-20250627162900496.png
11、集群 TiDB Dashboard 监控页面

http://{pd-ip}:2379/dashboardhttps://raw.githubusercontent.com/misakivv/lingxing-typora-images/master/Documentimage-20250627162207572.png
https://raw.githubusercontent.com/misakivv/lingxing-typora-images/master/Documentimage-20250627163501712.png
三、卸载TiDB

当业务下线之后，如果想将集群占有的机器释放出来让给其他业务使用，需要清理掉集群上的数据以及部署的二进制文件。tiup cluster destroy 命令会执行以下操作销毁集群：

[*]停止集群
[*]对于每个服务，删除其日志目录，部署目录，数据目录
[*]如果各个服务的数据目录/部署目录的父目录是由 tiup-cluster 创建的，也一并删除
1、语法

tiup cluster destroyhttps://raw.githubusercontent.com/misakivv/lingxing-typora-images/master/Documentimage-20250627164703524.png
2、选项

--force

[*]在某些情况下，有可能集群中的某些节点已经宕机，导致无法通过 SSH 连接到节点进行操作，这个时候可以通过 --force 选项忽略这些错误。
[*]数据类型：BOOLEAN
[*]该选项默认关闭，默认值为 false。在命令中添加该选项，并传入 true 值或不传值，均可开启此功能。
--retain-node-data（StringArray，默认为空）
指定需要保留数据的节点，如需指定多个，重复使用多次该选项：--retain-node-data--retain-node-data 。
--retain-role-data（StringArray，默认为空）
指定需要保留数据的角色，如需指定多个，重复使用多次该选项：--retain-role-data--retain-role-data 。

来源：豆瓜网用户自行投稿发布，如果侵权，请联系站长删除

页: [1]

豆瓜网's Archiver

单机部署TiDB