1.查看集群列表
tiup cluster list
2.啟動集群
啟動集群操作會按 PD -> TiKV -> Pump -> TiDB -> TiFlash -> Drainer 的順序啟動整個 TiDB 集群所有組件(同時也會啟動監控組件):
tiup cluster start ${cluster-name}
注意:
你需要將 ${cluster-name} 替換成實際的集群名字,若忘記集群名字,可通過 tiup cluster list 查看。
該命令支持通過 -R 和 -N 參數來只啟動部分組件。
3. 例如,下列命令只啟動 PD 組件:
tiup cluster start ${cluster-name} -R pd
下列命令只啟動 1.2.3.4 和 1.2.3.5 這兩台機器上的 PD 組件:
tiup cluster start ${cluster-name} -N 1.2.3.4:2379,1.2.3.5:2379
注意:
若通過 -R 和 -N 啟動指定組件,需要保證啟動順序正確(例如需要先啟動 PD 才能啟動 TiKV),否則可能導致啟動失敗。
4.查看集群狀態
集群啟動之后需要檢查每個組件的運行狀態,以確保每個組件工作正常。TiUP 提供了 display 命令,節省了登錄到每台機器上去查看進程的時間。
tiup cluster display ${cluster-name}
5.重命名集群
部署並啟動集群后,可以通過 tiup cluster rename 命令來對集群重命名:
tiup cluster rename ${cluster-name} ${new-name}
6.關閉集群
關閉集群操作會按 Drainer -> TiFlash -> TiDB -> Pump -> TiKV -> PD 的順序關閉整個 TiDB 集群所有組件(同時也會關閉監控組件):
tiup cluster stop ${cluster-name}
和 start 命令類似,stop 命令也支持通過 -R 和 -N 參數來只停止部分組件。
例如,下列命令只停止 TiDB 組件:
tiup cluster stop ${cluster-name} -R tidb
下列命令只停止 1.2.3.4 和 1.2.3.5 這兩台機器上的 TiDB 組件:
tiup cluster stop ${cluster-name} -N 1.2.3.4:4000,1.2.3.5:4000
7.清除集群數據
此操作會關閉所有服務,並清空其數據目錄或/和日志目錄,並且無法恢復,需要謹慎操作。
清空集群所有服務的數據,但保留日志:
tiup cluster clean ${cluster-name} --data
清空集群所有服務的日志,但保留數據:
tiup cluster clean ${cluster-name} --log
清空集群所有服務的數據和日志:
tiup cluster clean ${cluster-name} --all
清空 Prometheus 以外的所有服務的日志和數據:
tiup cluster clean ${cluster-name} --all --ignore-role prometheus
銷毀集群
銷毀集群操作會關閉服務,清空數據目錄和部署目錄,並且無法恢復,需要謹慎操作。
tiup cluster destroy ${cluster-name}