TiDB教程（2）TiDB集群管理工具tiup使用教程

tiup是TiDB官方提供的集群管理工具，支持查看集群信息和状态、启动停止集群、修改配置参数、销毁集群等功能。
1、查看集群列表
tiup cluster可以用来管理多个TiDB集群，在每个TiDB集群部署完毕后，都会出现在TiUP集群列表里，通过tiup cluster list命令进行查看

tiup cluster list

tiup cluster start test_tidb
tiup cluster start test_tidb -R pd  #只启动 PD 组件
tiup cluster start test_tidb -N 1.2.3.4:2379,1.2.3.5:2379  #只启动 1.2.3.4 和 1.2.3.5 这两台机器上的 PD 组件

tiup cluster display test_tidb

4、修改配置参数

集群运行过程中可以通过tiup cluster edit-config命令修改组件参数，最后滚动生效

tiup cluster edit-config test_tidb   #会以编辑模式打开test_tidb集群配置文件
server_configs:  #全局生效
  tidb: 
    log.slow-threshold: 300 
tidb_servers:   #指定节点生效
- host: 10.0.1.11 
  port: 4000 
  config: 
    log.slow-threshold: 300 

tiup cluster reload test_tidb [-N <nodes>] [-R <roles>]  #执行 reload 命令滚动分发配置、重启相应组件

5、重命名集群

部署并启动集群后，可以通过 tiup cluster rename 命令来对集群重命名

tiup cluster rename ${cluster-name} ${new-name}

6、关闭集群 

关闭集群操作会按Drainer -> TiFlash -> TiDB -> Pump -> TiKV -> PD的顺序进行。和 start 命令类似，stop 命令也支持通过-R 和-N 参数来只停止部分组件

tiup cluster stop ${cluster-name} 
tiup cluster stop ${cluster-name} -R tidb 
tiup cluster stop ${cluster-name} -N 1.2.3.4:4000,1.2.3.5:4000

# 清空集群所有服务的数据，但保留日志
tiup cluster clean ${cluster-name} --data 
# 清空集群所有服务的日志，但保留数据
tiup cluster clean ${cluster-name} --log 
#清空集群所有服务的数据和日志
tiup cluster clean ${cluster-name} --all 
# 清空节点 172.16.13.11:9000以外的所有服务的日志和数据
tiup cluster clean ${cluster-name} --all --ignore-node 172.16.13.11:9000 
# 清空部署在 172.16.13.12 以外的所有服务的日志和数据： 
tiup cluster clean ${cluster-name} --all --ignore-node 172.16.13.12

tiup cluster destroy ${cluster-name}