课程名称:2.5.3 Usage of PD control(PD Control 的典型使用场景)
学习时长:
10min
课程收获:
熟练使用 pd-ctl 工具,查看集群信息,调度策略,调度参数配置
课程内容:
本课程介绍了 pd control 工具的使用,以及如何通过 pd control 工具获取集群中相关信息和使用 pd control 对 pd 调度进行一些控制,通过本课程的学习,理解 pd 中关于调度策略的相关概念,并能通过 pd-ctl 工具对调度策略进行控制。
PD Control 是 PD 的命令行工具,用于获取集群状态信息和调整集群。
安装方式
使用 TiUP
可直接通过 tiup ctl pd -u http://<pd_ip>:<pd_port> [-i]
使用。
下载安装包
如需下载最新版本的 pd-ctl
,直接下载 TiDB 安装包即可,因为 pd-ctl
包含在 TiDB 安装包中。
安装包 | 操作系统 | 架构 | SHA256 校验和 |
---|---|---|---|
https://download.pingcap.org/tidb-{version}-linux-amd64.tar.gz (pd-ctl) |
Linux | amd64 | https://download.pingcap.org/tidb-{version}-linux-amd64.sha256 |
注意:
下载链接中的
{version}
为 TiDB 的版本号。例如v4.0.0-rc.2
版本的下载链接为https://download.pingcap.org/tidb-v4.0.0-rc.2-linux-amd64.tar.gz
。也可以使用latest
替代{version}
来下载最新的未发布版本。
源码编译
- Go Version 1.13 以上
- 在 PD 项目根目录使用
make
或者make pd-ctl
命令进行编译,生成 bin/pd-ctl
简单例子
单命令模式:
Copy
./pd-ctl store -u http://127.0.0.1:2379
交互模式:
Copy
./pd-ctl -i -u http://127.0.0.1:2379
使用环境变量:
Copy
export PD_ADDR=http://127.0.0.1:2379 &&
./pd-ctl
使用 TLS 加密:
Copy
./pd-ctl -u https://127.0.0.1:2379 --cacert="path/to/ca" --cert="path/to/cert" --key="path/to/key"
命令行参数 (flags)
--cacert
- 指定 PEM 格式的受信任 CA 证书的文件路径
- 默认值:""
--cert
- 指定 PEM 格式的 SSL 证书的文件路径
- 默认值:""
--detach
/ -d
- 使用单命令行模式(不进入 readline)
- 默认值: true
--help
/ -h
- 输出帮助信息
- 默认值:false
--interact
/ -i
- 使用交互模式(进入 readline)
- 默认值:false
--key
- 指定 PEM 格式的 SSL 证书密钥文件路径,即
--cert
所指定的证书的私钥 - 默认值: “”
--pd
/ -u
- 指定 PD 的地址
- 默认地址:
http://127.0.0.1:2379
- 环境变量:
PD_ADDR
--version
/ -V
- 打印版本信息并退出
- 默认值: false