TIDB 部署手册
部署
采用ansible方式部署，中控机可以是部署目标机器中的某一台。
中控机使用root安装包
yum -y install epel-release git curl sshpass
yum -y install python-pip
中控机配置
使用root用户
vi .pip/pip.conf
增加如下内容
[global]
timeout=60
index-url=http://yum.sfstg.com/pypi/root/pypi/+simple/
trusted-host=yum.sfstg.com
中控机升级pip版本
执行如下命令升级pip版本
pip install –U pip
中控机用户创建
useradd tidb
passwd tidb
配置 tidb 用户 sudo 免密码，将 tidb ALL=(ALL) NOPASSWD: ALL 添加到文件末尾即可。
# visudo
tidb ALL=(ALL) NOPASSWD: ALL
部署集群
部署安装包
需下载tidb-ansible-master安装包到本地环境home/tidb下面，使用tidb用户登录。
如下操作安装ansible
cd /home/tidb/tidb-ansible-master
sudo pip install -r ./requirements.txt
ansible --version
---无报错
在中控机上配置部署机器 ssh 互信及 sudo 规则
编辑host.ini， 增加集群IP， 集群ip为规划tidb集群的主机
$ cd /home/tidb/tidb-ansible-master
$ vi hosts.ini
[servers]
192.168.0.2
192.168.0.3
192.168.0.4
192.168.0.5
执行以下命令，按提示输入部署目标机器 root 用户密码。该步骤将在部署目标机器上创建 tidb 用户，并配置 sudo 规则，配置中控机与部署目标机器之间的 ssh 互信。
ssh-keygen -t rsa
ansible-playbook -i hosts.ini create_users.yml –k
ansible-playbook -i hosts.ini deploy_ntp.yml -k
在部署目标机器上安装 NTP 服务
分配机器资源，编辑 inventory.ini 文件
以 tidb 用户登录中控机，inventory.ini 文件路径为 /home/tidb/tidb-ansible－master/inventory.ini。
典型部署如下
[tidb_servers]
172.16.10.1
172.16.10.2
[pd_servers]
172.16.10.1
172.16.10.2
172.16.10.3
[tikv_servers]
TiKV1-1 ansible_host
TiKV1-2 ansible_host
TiKV2-1 ansible_host
TiKV2-2 ansible_host
TiKV3-1 ansible_host
TiKV3-2 ansible_host
[monitoring_servers]
172.16.10.1
[grafana_servers]
172.16.10.1
[monitored_servers]
172.16.10.2
172.16.10.3
172.16.10.4
172.16.10.5
172.16.10.6
[pd_servers:vars]
location_labels
各项参数含义参考附件
TiKV3-2
[pd_servers]—
Tikv3-2 ---tikv
ansible_host=172.16.10.6 –tikv
deploy_dir=/data1/deploy ---
[monitoring_servers]----
172.16.10.1
[monitored_servers]---
部署目录调整
部署目录通过 deploy_dir 变量控制，默认全局变量已设置为 /home/tidb/deploy，对所有服务生效。如数据盘挂载目录为 /data1，可设置为 /data1/deploy，样例如下:
## Global variables
[all:vars]
deploy_dir = /data1/deploy
如为某一服务单独设置部署目录，可在配置服务主机列表时配置主机变量，以 TiKV 节点为例，其他服务类推，请务必添加第一列别名，以免服务混布时混淆。
TiKV1-1 ansible_host=172.16.10.4 deploy_dir=/data1/deploy
其他变量调整
注： 以下控制变量开启请使用首字母大写 True，关闭请使用首字母大写 False。
变量
含义
cluster_name
集群名称，可调整
tidb_version
TiDB 版本，TiDB-Ansible 各分支默认已配置
process_supervision
进程监管方式，默认为 systemd，可选 supervise
timezone
修改部署目标机器时区，默认为 Asia/Shanghai，可调整，与set_timezone 变量结合使用
set_timezone
默认为 True，即修改部署目标机器时区，关闭可修改为 False
enable_firewalld
开启防火墙，默认不开启，如需开启，请将部署建议-网络要求 中的端口加入白名单
enable_ntpd
检测部署目标机器 NTP 服务，默认为 True，请勿关闭
set_hostname
根据 IP 修改部署目标机器主机名，默认为 False
dev_mode
当 dev_mode = True 时，Ansible 不去检测部署目录机器的 CPU，内存和磁盘性能，默认为 False
enable_binlog
是否部署 pump 并开启 binlog，默认为 False，依赖 Kafka 集群，参见zookeeper_addrs 变量
zookeeper_addrs
binlog Kafka 集群的 zookeeper 地址
enable_slow_query_log
TiDB 慢查询日志记录到单独文件({{ deploy_dir }}/log/tidb_slow_query.log)，默认为 False，记录到 tidb 日志
deploy_without_tidb
KV 模式，不部署 TiDB 服务，仅部署 PD、TiKV 及监控服务，请将inventory.ini 文件中 tidb_servers 主机组 IP 设置为空。
alertmanager_target
可选：如果你已单独部署 alertmanager，可配置该变量，格式：alertmanager_host:alertmanager_port
grafana_admin_user
Grafana 管理员帐号用户名，默认为 admin
grafana_admin_password
Grafana 管理员帐号密码，默认为 admin，用于 Ansible 导入 Dashboard 和创建 API Key，如后期通过 grafana web 修改了密码，请更新此变量
collect_log_recent_hours
采集日志时，采集最近几个小时的日志，默认为 2 小时
enable_bandwidth_limit
在中控机上从部署目标机器拉取诊断数据时，是否限速，默认为 True，与 collect_bandwidth_limit 变量结合使用
collect_bandwidth_limit
在中控机上从部署目标机器拉取诊断数据时限速多少，单位: Kbit/s，默认 10000，即 10Mb/s，如果是单机多 TiKV 实例部署方式，需除以单机实例个数
检测环境
执行以下命令如果所有 server 返回 tidb 表示 ssh 互信配置成功。
ansible -i inventory.ini all -m shell -a 'whoami'
执行以下命令如果所有 server 返回 root 表示 tidb 用户 sudo 免密码配置成功
ansible -i inventory.ini all -m shell -a 'whoami' -b
初始化系统环境，修改内核参数
ansible-playbook bootstrap.yml
--以下报错可以忽略
ERROR MESSAGE SUMMARY ***************************************************************************************************************
[tidb149]: Ansible FAILED! => playbook: bootstrap.yml; TASK: check_system_optional : Preflight check - Check TiDB server's RAM; message: {"changed": false, "msg": "This machine does not have sufficient RAM to run TiDB, at least 16000 MB."}
部署 TiDB 集群软件并启动
ansible-playbook deploy.yml
ansible-playbook start.yml
部署完成
可以通过mysql客户端使用root免密登陆TIDB server 4000端口，使用mysql语法正常创建数据库及用户即可。
