本地快速部署 TiDB 集群

    playground 组件的基本用法：

    如果直接执行 命令，则 TiUP playground 会使用本地安装的 TiDB/TiKV/PD 组件或者安装这些组件的稳定版本，来启动一个由 1 个 TiKV、1 个 TiDB、1 个 PD 和 1 个 TiFlash 实例构成的集群。该命令实际做了以下事情：

    • 因为该命令没有指定 playground 的版本，TiUP 会先查找已安装的 playground 的最新版本，假设已安装的 playground 最新版为 v1.11.3，则该命令相当于 tiup playground:v1.11.3
    • 如果 playground 从未安装过任何版本的 TiDB/TiKV/PD 组件，TiUP 会先安装这些组件的最新稳定版，然后再启动运行这些组件的实例
    • 因为该命令没有指定 TiDB/PD/TiKV 各组件的版本，默认情况下，它会使用各组件的最新发布版本，假设当前为 v6.5.2，则该命令相当于 tiup playground:1.11.3 v6.5.2
    • 因为该命令也没有指定各组件的个数，默认情况下，它会启动由 1 个 TiDB、1 个 TiKV、1 个 PD 和 1 个 TiFlash 实例构成的最小化集群
    • 在依次启动完各个 TiDB 组件后，playground 会提醒集群启动成功，并告诉你一些有用的信息，譬如如何通过 MySQL 客户端连接集群、如何访问 等

    playground 的命令行参数说明：

    1. Flags:
    2.       --db int                   设置集群中 TiDB 节点的数量（默认为1）
    3.       --db.host host             指定 TiDB 的监听地址
    4.       --db.binpath string        指定 TiDB 二进制文件的位置（开发调试用，可忽略）
    5.       --db.config string         指定 TiDB 的配置文件（开发调试用，可忽略）
    6.       --db.timeout int           指定 TiDB 最长等待超时时间，单位为秒。若配置为 0，则永不超时。
    7.       --drainer int              设置集群中 Drainer 数据
    8.       --drainer.binpath string   指定 Drainer 二进制文件的位置（开发调试用，可忽略）
    9.       --drainer.config string    指定 Drainer 的配置文件
    10.   -h, --help                     打印帮助信息
    11.       --host string              设置每个组件的监听地址（默认为 127.0.0.1），如果要提供给别的电脑访问，可设置为 0.0.0.0
    12.       --kv int                   设置集群中 TiKV 节点的数量（默认为1）
    13.       --kv.binpath string        指定 TiKV 二进制文件的位置（开发调试用，可忽略）
    14.       --kv.config string         指定 TiKV 的配置文件（开发调试用，可忽略）
    15.       --mode string              指定 playground 的运行模式，取值选项为 'tidb'（默认）和 'tikv-slim'
    16.       --pd int                   设置集群中 PD 节点的数量（默认为1）
    17.       --pd.host host             指定 PD 的监听地址
    19.       --pd.config string         指定 PD 的配置文件（开发调试用，可忽略）
    20.       --pump int                 设置集群中 Pump 节点的数量（非 0 的时候 TiDB 会开启 TiDB Binlog）
    21.       --pump.binpath string      指定 Pump 二进制文件的位置（开发调试用，可忽略）
    22.       --pump.config string       指定 Pump 的配置文件（开发调试用，可忽略）
    23.   -T, --tag string               设置 playground 的 tag 信息
    24.       --ticdc int                设置集群中 TiCDC 节点的数量（默认为 0）
    25.       --ticdc.config string      指定 TiCDC 的配置文件（开发调试用，可忽略）
    26.       --tiflash int              设置集群中 TiFlash 节点的数量（默认为 1）
    27.       --tiflash.binpath string   指定 TiFlash 的二进制文件位置（开发调试用，可忽略）
    28.       --tiflash.config string    指定 TiFlash 的配置文件（开发调试用，可忽略）
    29.       --tiflash.timeout int      指定 TiFlash 最长等待超时时间，单位为秒，若配置为 0，则永不超时。
    30.   -v, --version                  显示 playground 的版本号
    31.       --without-monitor          设置不使用 Prometheus 和 Grafana 的监控功能。若不添加此参数，则默认开启监控功能。

    使用示例

    1. tiup list tidb

    启动一个指定版本的 TiDB 集群

    1. tiup playground ${version}

    将 ${version} 替换为所需的版本号。

    覆盖 PD 的默认配置

    首先，你需要复制 PD 的。假设你将复制的配置文件放置在 ~/config/pd.toml，按需修改一些内容后，执行以下命令可以覆盖 PD 的默认配置：

    默认启动 playground 时，各个组件都是使用官方镜像组件包中的二进制文件启动的，如果本地编译了一个临时的二进制文件想要放入集群中测试，可以使用 --{comp}.binpath 这个参数替换，例如执行以下命令替换 TiDB 的二进制文件：

    1. tiup playground --db.binpath /xx/tidb-server

    启动多个组件实例

    默认情况下各启动一个 TiDB、TiKV 和 PD 实例，如果希望启动多个，可以加上如下参数：

    1. tiup playground --db 3 --pd 3 --kv 3

    Playground 集群在命令行退出时，会默认清空所有的集群数据。如果想要启动一个数据不被自动删除的 Playground 集群，需要在启动时指定集群 tag，指定后可以在 ~/.tiup/data 路径下找到该集群的数据。在集群启动时指定 tag 的方法如下：

    TiUP 提供了 client 组件，用于自动寻找并连接 playground 在本地启动的 TiDB 集群，使用方式为：

    1. tiup client

    该命令会在控制台上提供当前机器上由 playground 启动的 TiDB 集群列表，选中需要连接的 TiDB 集群，点击回车后，可以打开一个自带的 MySQL 客户端以连接 TiDB。

    查看已启动集群的信息

    1. tiup playground display

    可以看到如下信息：

    1. Pid    Role     Uptime
    2. ---    ----     ------
    3. 84518  pd       35m22.929404512s
    4. 84519  tikv     35m22.927757153s
    5. 84520  pump     35m22.92618275s
    6. 86189  tidb     exited
    7. 86526  tidb     34m28.293148663s

    扩容集群的命令行参数与启动集群的相似。以下命令可以扩容两个 TiDB：

    缩容集群

    1. tiup playground scale-in --pid 86526