You are viewing the archived documentation of TiDB, which no longer receives updates.

View latest LTS version docs

PD Microservice Deployment Topology

This document describes the deployment topology of PD microservices based on the minimal TiDB topology.

Topology information

InstanceCountPhysical machine configurationIPConfiguration
TiDB216 VCore 32GB * 110.0.1.1
10.0.1.2
Default port
Global directory configuration
PD34 VCore 8GB * 110.0.1.3
10.0.1.4
10.0.1.5
Default port
Global directory configuration
TSO24 VCore 8GB * 110.0.1.6
10.0.1.7
Default port
Global directory configuration
Scheduling24 VCore 8GB * 110.0.1.8
10.0.1.9
Default port
Global directory configuration
TiKV316 VCore 32GB 2TB (nvme ssd) * 110.0.1.10
10.0.1.11
10.0.1.12
Default port
Global directory configuration
Monitoring & Grafana14 VCore 8GB * 1 500GB (ssd)10.0.1.13Default port
Global directory configuration

Topology template

Simple template for the PD microservice topology
# # Global variables are applied to all deployments and used as the default value of # # the deployments if a specific deployment value is missing. global: user: "tidb" ssh_port: 22 deploy_dir: "/tidb-deploy" data_dir: "/tidb-data" listen_host: 0.0.0.0 arch: "amd64" pd_mode: "ms" # To enable PD microservices, you must specify this field as "ms". monitored: node_exporter_port: 9200 blackbox_exporter_port: 9215 # # Specifies the configuration of PD servers. pd_servers: - host: 10.0.1.3 - host: 10.0.1.4 - host: 10.0.1.5 # # Specifies the configuration of TiDB servers. tidb_servers: - host: 10.0.1.1 - host: 10.0.1.2 # # Specifies the configuration of TiKV servers. tikv_servers: - host: 10.0.1.10 - host: 10.0.1.11 - host: 10.0.1.12 # # Specifies the configuration of TSO servers. tso_servers: - host: 10.0.1.6 - host: 10.0.1.7 # # Specifies the configuration of Scheduling servers. scheduling_servers: - host: 10.0.1.8 - host: 10.0.1.9 # # Specifies the configuration of Prometheus servers. monitoring_servers: - host: 10.0.1.13 # # Specifies the configuration of Grafana servers. grafana_servers: - host: 10.0.1.13

For detailed descriptions of the configuration items in the preceding TiDB cluster topology file, see Topology configuration file for deploying TiDB using TiUP.

Key parameters

  • The instance-level host configuration in tso_servers only supports IP address, not domain name.
  • For detailed descriptions of TSO configuration items, see TSO configuration file.
  • The instance-level host configuration in scheduling_servers only supports IP address, not domain name.
  • For detailed descriptions of Scheduling configuration items, see Scheduling configuration file.