TiDBダッシュボードをデプロイ

TiDB ダッシュボード UI は、v4.0 以降のバージョンの PDコンポーネントに組み込まれているため、追加のデプロイメントは必要ありません。標準の TiDB クラスターをデプロイするだけで、TiDB ダッシュボードが利用可能になります。

注記:

TiDB v6.5.0 (以降) およびTiDB Operator v1.4.0 (以降) では、Kubernetes 上の独立した Pod として TiDB Dashboard をデプロイすることがサポートされています。詳細については、 TiDB ダッシュボードをTiDB Operatorに独立してデプロイ参照してください。

標準の TiDB クラスターをデプロイする方法については、次のドキュメントを参照してください。

注記:

TiDB Dashboard を v4.0 より前の TiDB クラスターにデプロイすることはできません。

複数のPDインスタンスを使用したデプロイメント

クラスターに複数の PD インスタンスがデプロイされている場合、これらのインスタンスのうち 1 つだけが TiDB ダッシュボードとして機能します。

PD インスタンスが初めて実行されると、インスタンス間で自動的にネゴシエートされ、TiDB ダッシュボードを提供するインスタンスが 1 つ選択されます。TiDB ダッシュボードは他の PD インスタンスでは実行されません。PD インスタンスが再起動されたり、新しい PD インスタンスが参加したりしても、TiDB ダッシュボード サービスは、選択された PD インスタンスによって常に提供されます。ただし、TiDB ダッシュボードを提供する PD インスタンスがクラスターから削除されると (スケールインされると)、再ネゴシエーションが行われます。ネゴシエーション プロセスでは、ユーザーの介入は必要ありません。

TiDB ダッシュボードを提供していない PD インスタンスにアクセスすると、ブラウザが自動的にリダイレクトされ、TiDB ダッシュボードを提供している PD インスタンスへのアクセスが誘導され、正常にサービスにアクセスできるようになります。このプロセスは、以下の画像に示されています。

Process Schematic

注記:

TiDB ダッシュボードを提供する PD インスタンスは、PD リーダーではない可能性があります。

実際にTiDBダッシュボードを提供しているPDインスタンスを確認する

TiUPを使用してデプロイされた実行中のクラスターの場合、 tiup cluster displayコマンドを使用して、どの PD インスタンスが TiDB ダッシュボードを提供しているかを確認できますCLUSTER_NAMEクラスター名に置き換えます。

tiup cluster display CLUSTER_NAME --dashboard

サンプル出力は次のとおりです。

http://192.168.0.123:2379/dashboard/

注記:

この機能は、 tiup clusterデプロイメント ツールの新しいバージョン (v1.0.3 以降) でのみ使用できます。

TiUPクラスタのアップグレード
tiup update --self tiup update cluster --force

TiDBダッシュボードを提供するために別のPDインスタンスに切り替える

TiUP を使用してデプロイされた実行中のクラスターの場合、 tiup ctl:v<CLUSTER_VERSION> pdコマンドを使用して、TiDB ダッシュボードを提供する PD インスタンスを変更したり、無効になっている場合に TiDB ダッシュボードを提供する PD インスタンスを再指定したりできます。

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

上記のコマンドでは:

  • 127.0.0.1:2379任意の PD インスタンスの IP とポートに置き換えます。
  • 9.9.9.9:2379 TiDB ダッシュボード サービスを実行する新しい PD インスタンスの IP とポートに置き換えます。

変更が有効になっているかどうかを確認するには、 tiup cluster displayコマンドを使用します ( CLUSTER_NAMEクラスター名に置き換えます)。

tiup cluster display CLUSTER_NAME --dashboard

TiDBダッシュボードを無効にする

TiUPを使用してデプロイされた実行中のクラスターの場合は、 tiup ctl:v<CLUSTER_VERSION> pdコマンドを使用してすべての PD インスタンスで TiDB ダッシュボードを無効にします ( 127.0.0.1:2379任意の PD インスタンスの IP とポートに置き換えます)。

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

TiDB ダッシュボードを無効にすると、どの PD インスタンスが TiDB ダッシュボード サービスを提供しているかの確認が失敗します。

Error: TiDB Dashboard is disabled

ブラウザ経由で任意の PD インスタンスの TiDB ダッシュボード アドレスにアクセスしても失敗します。

Dashboard is not started.

TiDBダッシュボードを再度有効にする

TiUP を使用してデプロイされた実行中のクラスターの場合は、 tiup ctl:v<CLUSTER_VERSION> pdコマンドを使用して、PD にインスタンスの再ネゴシエートを要求し、TiDB ダッシュボードを実行します ( 127.0.0.1:2379任意の PD インスタンスの IP とポートに置き換えます)。

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

上記のコマンドを実行した後、 tiup cluster displayコマンドを使用して、PD によって自動的にネゴシエートされた TiDB ダッシュボード インスタンス アドレスを表示できます ( CLUSTER_NAMEクラスター名に置き換えます)。

tiup cluster display CLUSTER_NAME --dashboard

TiDB ダッシュボードを提供する PD インスタンスを手動で指定することで、TiDB ダッシュボードを再度有効にすることもできます。 TiDBダッシュボードを提供するために別のPDインスタンスに切り替える参照してください。

次は何か

このページは役に立ちましたか?