tiup cluster deploy

命令 tiup cluster deploy 用于部署一个全新的集群。

语法

  1. tiup cluster deploy <cluster-name> <version> <topology.yaml> [flags]
  • <cluster-name> 表示新集群的名字，不能和现有集群同名
  • <version> 为要部署的 TiDB 集群版本号，如 v4.0.9
  • <topology.yaml> 为事先编写好的拓扑文件

选项

-u, —user（string，默认为当前执行命令的用户）

指定连接目标机器的用户名，该用户在目标机器上需要有免密 sudo root 的权限。

-i, —identity_file（string，默认 ~/.ssh/id_rsa）

指定连接目标机器的密钥文件。

-p, —password（boolean，默认 false）

在连接目标机器时使用密码登陆，不可和 -i/--identity_file 同时使用。

—ignore-config-check（boolean，默认 false）

在组件二进制文件部署之后，会对 TiDB，TiKV 和 PD 组件执行配置检查，检查方式为 <binary> --config-check <config-file>，其中 <bianry> 为部署的二进制文件的路径，<config-file> 为根据用户配置生成的配置文件。

如果想要跳过该项检查，可以使用该选项。

—no-labels（boolean，默认 false）

当两个或多个 TiKV 部署到同一台机器时，会存在一个风险：由于 PD 无法感知集群的拓扑结构，可能将一个 Region 的多个副本调度到一台物理机上的不同 TiKV，这样这台物理机就成为了单点。为了避免这种情况，用户可以通过 label 来告诉 PD 不要将相同的 Region 调度到同一台机器上（配置方式参考通过拓扑 label 进行副本调度）。

但是对于测试环境，可能并不在意是否将一个 Region 的副本调度到了同一台机器上，这个时候可以使用 --no-labels 来绕过检查。

—skip-create-user（boolean，false）

在部署集群时，tiup-cluster 会先检查拓扑文件中指定的用户名是否存在，如果不存在就会创建一个。指定 --skip-create-user 选项后不再检查用户是否存在，直接跳过创建步骤。

-h, —help（boolean，默认 false）

输出帮助信息。

输出

部署日志。