国产鲲鹏服务器 Kylin Linux 部署 TiDB v8.5.5 实战（TiUP 单机部署完整教程）

文章目录

一、环境说明
[二、安装 TiUP 部署工具](#二、安装 TiUP 部署工具)
[三、安装 TiDB cluster 组件](#三、安装 TiDB cluster 组件)
四、创建部署目录
[五、创建 topology.yaml 文件](#五、创建 topology.yaml 文件)
[六、部署 TiDB 集群](#六、部署 TiDB 集群)
[七、部署报错（sudo 权限问题）](#七、部署报错（sudo 权限问题）)
八、目录授权并重新部署
[九、初始化 TiDB 集群](#九、初始化 TiDB 集群)
十、安装客户端并连接测试
[十一、验证 TiDB 是否正常运行](#十一、验证 TiDB 是否正常运行)
总结

一、环境说明

本次部署环境如下

项目	配置
CPU	12 Core
内存	48 GB
操作系统	Kylin Linux Advanced Server V10
架构	ARM64（Kunpeng）

本教程使用 TiDB 官方部署工具 TiUP 进行单机部署。

二、安装 TiUP 部署工具

执行以下命令安装 TiUP

bash 复制代码

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

安装完成后，新打开一个终端窗口或者执行

bash 复制代码

source ~/.bashrc

检查安装是否成功

bash 复制代码

tiup --version

示例输出

bash 复制代码

1.16.4 v1.16.2-nightly-90
Go Version: go1.24.1
Git Ref: master
GitHash: 908be86076919952e4c3f1e52c214c2f45be14e9

三、安装 TiDB cluster 组件

TiUP 通过组件方式管理 TiDB 集群，需要安装cluster组件。

执行命令

bash 复制代码

tiup install cluster

示例输出

bash 复制代码

download https://tiup-mirrors.pingcap.com/cluster-v1.16.4-linux-arm64.tar.gz

四、创建部署目录

进入 /opt 目录并创建 TiDB 安装目录

bash 复制代码

cd /opt
mkdir tidb
cd tidb

五、创建 topology.yaml 文件

创建集群拓扑文件

bash 复制代码

vim topology.yaml

文件内容如下：

bash 复制代码

global:
  user: "tidb"
  ssh_port: 22
  deploy_dir: "/opt/tidb/tidb-deploy"
  data_dir: "/opt/tidb/tidb-data"

server_configs:
  tidb: {}
  tikv:
    storage.block-cache.capacity: "10GB"
  pd: {}

pd_servers:
  - host: 192.168.0.119

tidb_servers:
  - host: 192.168.0.119
    port: 4000
    status_port: 10080

tikv_servers:
  - host: 192.168.0.119
    port: 20160
    status_port: 20180

说明:

IP 地址需要修改为自己的服务器 IP

deploy_dir 为部署目录

data_dir 为数据目录

storage.block-cache.capacity 表示 TiKV 的缓存大小

六、部署 TiDB 集群

执行部署命令

bash 复制代码

tiup cluster deploy tidb-single v8.5.5 topology.yaml --user root -p

参数说明：

参数	说明
tidb-single	集群名称
v8.5.5	TiDB 版本
--user root	使用 root 用户初始化环境
-p	SSH 使用密码登录

如需查看可安装版本：

bash 复制代码

tiup list tidb

七、部署报错（sudo 权限问题）

在部署过程中可能出现如下报错

executor.ssh.execute_failed

sudo: no tty present and no askpass program specified

该问题是由于 tidb 用户没有 sudo 权限导致。

解决方法：

bash 复制代码

#编辑 sudoers 文件：
visudo

bash 复制代码

# 在文件最后添加：
tidb ALL=(ALL) NOPASSWD: ALL
保存退出即可。

八、目录授权并重新部署

bash 复制代码

chown -R tidb.tidb /opt/tidb

然后重新执行部署命令

bash 复制代码

tiup cluster deploy tidb-single v8.5.5 topology.yaml --user root -p

部署成功后会看到

bash 复制代码

Cluster `tidb-single` deployed successfully

九、初始化 TiDB 集群

部署完成后，需要初始化并启动集群

bash 复制代码

tiup cluster start tidb-single --init

示例输出

bash 复制代码

Started cluster `tidb-single` successfully
The root password of TiDB database has been changed.
The new password is: 'e@25*17b-t68DA+Lgv'

注意

bash 复制代码

The new password is: 'xxxxx'

该密码只会显示一次，需要记录保存。

十、安装客户端并连接测试

安装 MySQL 客户端

bash 复制代码

yum -y install mariadb

连接 TiDB 数据库

bash 复制代码

mysql -h127.0.0.1 -P4000 -uroot -p

输入初始化生成的 root 密码即可登录。

登录后建议修改 root 密码

bash 复制代码

ALTER USER 'root'@'%' IDENTIFIED BY 'Tidb@123456';
FLUSH PRIVILEGES;

十一、验证 TiDB 是否正常运行

执行以下 SQL 查看版本信息

bash 复制代码

SELECT tidb_version();

示例输出

bash 复制代码

Release Version: v8.5.5
Edition: Community
Store: tikv

说明 TiDB 已成功运行。

总结

本文介绍了在鲲鹏ARM服务器+Kylin Linux V10环境下，使用TiUP工具部署 TiDBv8.5.5单节点集群的完整过程，并记录了部署过程中遇到的sudo权限问题及解决方法。

通过以上步骤，可以快速完成 TiDB 单机环境部署，适用于：简洁精准

实用高效

清晰易懂简洁精准

实用高效

清晰易懂

学习测试环境
开发环境
小规模业务场景