单机部署TiDB

• 一、准备环境
  
  
  
  • 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、选项
    
  
  

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

• 目前 TiUP Cluster 支持在 x86_64（AMD64）和 ARM 架构上部署 TiDB 集群
  
  
  
  • 在 AMD64 架构下，建议使用 CentOS 7.3 及以上版本 Linux 操作系统
    
  • 在 ARM 架构下，建议使用 CentOS 7.6 (1810) 版本 Linux 操作系统
    
  
  

• 仅centos版本
  
• 1. cat /etc/centos-release

  复制代码
  
  
  
• 通用脚本
  
• 1. #!/bin/bash
  2. bash <<'EOF'
  3. # 获取详细系统信息
  4. echo "===== [System Info Collector] ====="
  5. echo "=== Generated at: $(date '+%Y-%m-%d %H:%M:%S %Z') ==="
  7. # OS详细信息
  8. echo -e "\n===== OS Details ====="
  9. if [ -f /etc/os-release ]; then
  10.     cat /etc/os-release
  11. else
  12.     echo "WARNING: /etc/os-release not found!"
  13. fi
  15. # 发行版特定信息
  16. echo -e "\n===== Version Details ====="
  17. {
  18.     # CentOS/RHEL
  19.     if [ -f /etc/centos-release ]; then
  20.         centos_ver=$(awk '{print $4}' /etc/centos-release 2>/dev/null)
  21.         echo "CentOS Version: $centos_ver"
  22.         rpm -q centos-release --queryformat 'Release Package: %{VERSION}-%{RELEASE}\n' 2>/dev/null
  23.         
  24.     elif [ -f /etc/redhat-release ]; then
  25.         rhel_ver=$(awk '{print $(NF-1)}' /etc/redhat-release 2>/dev/null)
  26.         echo "RHEL Version: $rhel_ver"
  27.         rpm -q redhat-release-server --queryformat 'Release Package: %{VERSION}-%{RELEASE}\n' 2>/dev/null ||
  28.         rpm -q redhat-release --queryformat 'Release Package: %{VERSION}-%{RELEASE}\n' 2>/dev/null
  29.     fi
  30.    
  31.     # Ubuntu
  32.     if [ -f /etc/lsb-release ]; then
  33.         echo "Ubuntu Version: $(lsb_release -ds 2>/dev/null || grep DISTRIB_DESCRIPTION /etc/lsb-release | cut -d= -f2)"
  34.     fi
  35.    
  36.     # Debian
  37.     if [ -f /etc/debian_version ]; then
  38.         debian_ver=$(cat /etc/debian_version 2>/dev/null)
  39.         echo "Debian Version: $debian_ver"
  40.     fi
  41.    
  42.     # Amazon Linux
  43.     if grep -q "Amazon Linux" /etc/os-release 2>/dev/null; then
  44.         echo "Amazon Linux Version: $(grep PRETTY_NAME /etc/os-release | cut -d'"' -f2)"
  45.     fi
  46.    
  47.     # Alpine
  48.     if [ -f /etc/alpine-release ]; then
  49.         echo "Alpine Version: $(cat /etc/alpine-release)"
  50.     fi
  51. } 2>/dev/null
  53. # 核心系统信息
  54. echo -e "\n===== Core System Info ====="
  55. echo "Kernel Version: $(uname -r)"
  56. echo "System Arch: $(uname -m)"
  57. echo "Hostname: $(hostname -f 2>/dev/null || hostname)"
  59. # 增强版uptime信息
  60. echo -n "Uptime: "
  61. if uptime -p &>/dev/null; then
  62.     uptime -p | sed 's/up //'
  63. else
  64.     awk '{printf "%d days, %d hours", int($1/86400), int(($1%86400)/3600)}' /proc/uptime
  65. fi
  67. # 内存信息
  68. echo -e "\n===== Memory Usage ====="
  69. free -h | awk '/Mem:/{printf "Total: %s, Used: %s, Free: %s (%.1f%% used)\n", $2, $3, $4, $3/$2*100}'
  71. # 磁盘根分区信息
  72. echo -e "\n===== Disk Usage (Root) ====="
  73. df -h / | awk 'NR==2{printf "Total: %s, Used: %s, Avail: %s (%.1f%% used)\n", $2, $3, $4, $5}'
  75. echo -e "\n===== [End of Report] ====="
  76. EOF

  复制代码

如果在部署时使用参数 --user root -p 就可以忽略免密互信，对于有需求的可以参考免密互信

实际部署时IP即为本机实际IP

• 由于模拟多机部署，需要通过 root 用户调大 sshd 服务的连接数限制。修改 /etc/ssh/sshd_config 将 MaxSessions 调至 20。
  
• 1. sed -i '/^#*MaxSessions[[:space:]]\+[0-9]\+/s/.*/MaxSessions 20/' /etc/ssh/sshd_config

  复制代码
• 
  
  
• 重启sshd服务
  
• 1. service sshd restart

  复制代码

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

• 参数  表示设置集群名称
  
• 参数  表示设置集群版本，例如 v8.5.1。可以通过 tiup list tidb 命令来查看当前支持部署的 TiDB 版本
  
• 参数 --user 表示初始化环境的用户
  
• 参数 -p 表示在连接目标机器时使用密码登录
  

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

• 在某些情况下，有可能集群中的某些节点已经宕机，导致无法通过 SSH 连接到节点进行操作，这个时候可以通过 --force 选项忽略这些错误。
  
• 数据类型：BOOLEAN
  
• 该选项默认关闭，默认值为 false。在命令中添加该选项，并传入 true 值或不传值，均可开启此功能。