部署 TiDB Dashboard

    注意

    TiDB v6.5.0 且 TiDB Operator v1.4.0 之后，在 Kubernetes 上支持将 TiDB Dashboard 作为独立的 Pod 部署。具体信息，参考 TiDB Operator 部署独立的 TiDB Dashboard。

    请参阅下列文档了解如何部署标准 TiDB 集群：

    部署 - 图2

    注意

    TiDB Dashboard 目前不能在低于 4.0 版本的集群中部署或使用。

    当集群中部署了多个 PD 实例时，其中仅有一个 PD 实例会固定地提供 TiDB Dashboard 服务。

    各个 PD 首次运行时会自动协商出其中某一个实例提供 TiDB Dashboard 服务。协商完毕后，无论重启或扩容，都会固定在这个实例上运行 TiDB Dashboard 服务，除非该实例被手动缩容。其他 PD 实例不会运行 TiDB Dashboard 服务。这个协商过程无需用户介入，会自动完成。

    当用户访问不提供 TiDB Dashboard 服务的 PD 实例时，浏览器将会收到重定向指令，自动引导用户重新访问提供了 TiDB Dashboard 服务的 PD 实例，从而能正常使用。流程如下图所示。

    注意

    提供 TiDB Dashboard 服务的 PD 实例不一定与 PD leader 一致。

    使用 TiUP 部署时，对于已启动的集群，可通过 命令查看哪个 PD 节点提供了 TiDB Dashboard 服务（将 CLUSTER_NAME 替换为集群名称）：

    输出样例如下：

    1. http://192.168.0.123:2379/dashboard/

    部署 - 图5

    注意

    该功能在 TiUP Cluster v1.0.3 或更高版本部署工具中提供。

    升级 TiUP Cluster 步骤

    1. tiup update --self
    2. tiup update cluster --force

    切换其他 PD 实例提供 TiDB Dashboard 服务

    使用 TiUP 部署时，对于已启动的集群，可使用 tiup ctl:v<CLUSTER_VERSION> pd 命令切换其他 PD 实例运行 TiDB Dashboard，或在禁用 TiDB Dashboard 的情况下重新指定一个 PD 实例运行 TiDB Dashboard：

    其中：

    • 将 替换为任意 PD 实例的 IP 和端口

    修改完毕后，可使用 tiup cluster display 命令确认修改是否生效（将 CLUSTER_NAME 替换为集群名称）：

    1. tiup cluster display CLUSTER_NAME --dashboard

    警告

    切换 TiDB Dashboard 将会丢失之前 TiDB Dashboard 实例所存储的本地数据，包括流量可视化历史、历史搜索记录等。

    使用 TiUP 部署时，对于已启动的集群，可使用 tiup ctl:v<CLUSTER_VERSION> pd 命令在所有 PD 实例上禁用 TiDB Dashboard（将 替换为任意 PD 实例的 IP 和端口）：

    1. tiup ctl:v<CLUSTER_VERSION> pd -u http://127.0.0.1:2379 config set dashboard-address none

    禁用 TiDB Dashboard 后，查询哪个 PD 实例提供 TiDB Dashboard 服务将会失败：

    浏览器访问任意 PD 实例的 TiDB Dashboard 地址也将提示失败：

    1. Dashboard is not started.

    使用 TiUP 部署时，对于已启动的集群，可使用 tiup ctl:v<CLUSTER_VERSION> pd 命令，要求 PD 重新协商出某一个实例运行 TiDB Dashboard（将 127.0.0.1:2379 替换为任意 PD 实例的 IP 和端口）：

    1. tiup ctl:v<CLUSTER_VERSION> pd -u http://127.0.0.1:2379 config set dashboard-address auto

    修改完毕后，使用 命令查看 PD 自动协商出的 TiDB Dashboard 实例地址（将 CLUSTER_NAME 替换为集群名称）：

    还可以通过手动指定哪个 PD 实例运行 TiDB Dashboard 服务的方式重新启用 TiDB Dashboard，具体操作参见上文切换其他 PD 实例提供 TiDB Dashboard 服务。

    警告

    若新启用的 TiDB Dashboard 实例与禁用前的实例不一致，将会丢失之前 TiDB Dashboard 实例所存储的本地数据，包括流量可视化历史、历史搜索记录等。

    • 参阅访问 TiDB Dashboard 章节了解如何访问及登录集群上的 TiDB Dashboard 界面。
    • 参阅章节了解如何增强 TiDB Dashboard 的安全性，如配置防火墙等。