# 使用 TiUP 部署步骤 3-初始化集群拓扑文件

__*TiDB 部署步骤*__
__*TiUP 拓扑文件*__

![left](./student-guide/diagram/ClusterTopologyFile_zh_001_20220614.png)
-------------------------------------------------------------
请根据不同的集群拓扑,编辑 TiUP 所需的集群初始化配置文件。

集群初始化配置文件可以通过 TiUP 工具在中控机上面创建 YAML 格式配置文件,例如 topology.yaml:
tiup cluster template > topology.yaml

执行 vi topology.yaml,查看配置文件的内容:
global:
  user: "tidb"
  ssh_port: 22
  deploy_dir: "/tidb-deploy"
  data_dir: "/tidb-data"
server_configs: {}
pd_servers:
  - host: 10.0.1.4
  - host: 10.0.1.5
  - host: 10.0.1.6
tidb_servers:
  - host: 10.0.1.7
  - host: 10.0.1.8
  - host: 10.0.1.9
tikv_servers:
  - host: 10.0.1.1
  - host: 10.0.1.2
  - host: 10.0.1.3
monitoring_servers:
  - host: 10.0.1.4
grafana_servers:
  - host: 10.0.1.4
alertmanager_servers:
  - host: 10.0.1.4

注意:
混合部署场景也可以使用 tiup cluster template --full > topology.yaml 生成的建议拓扑模板
跨机房部署场景可以使用 tiup cluster template --multi-dc > topology.yaml 生成的建议拓扑模板。

详细内容,请参考:https://docs.pingcap.com/zh/tidb/stable/production-deployment-using-tiup