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

TiDB ダッシュボード UI は、v4.0 以降のバージョンの PDコンポーネントに組み込まれており、追加の展開は必要ありません。標準の TiDB クラスターをデプロイするだけで、TiDB ダッシュボードがそこに表示されます。

注記:

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

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

注記:

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

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

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

PD インスタンスが初めて実行されるとき、それらは自動的に相互にネゴシエートして、TiDB ダッシュボードにサービスを提供するインスタンスを 1 つ選択します。 TiDB ダッシュボードは他の PD インスタンスでは実行されません。 TiDB ダッシュボード サービスは、PD インスタンスが再起動されたり、新しい PD インスタンスが参加したりしても、選択した 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

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

TiUPを使用してデプロイされた実行中のクラスターの場合、 tiup ctl:v<CLUSTER_VERSION> pdコマンドを使用して TiDB ダッシュボードを提供する PD インスタンスを変更するか、TiDB ダッシュボードが無効になっているときに 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コマンドを使用して、TiDB ダッシュボードを実行するインスタンスを再ネゴシエートするように PD に要求します ( 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 ダッシュボードを再度有効にすることもできます。 別の PD インスタンスに切り替えて TiDB ダッシュボードを提供するを参照してください。

次は何ですか

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