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 インスタンスにアクセスするように案内され、サービスに通常どおりアクセスできるようになります。このプロセスを以下の図に示します。
注記:
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 ダッシュボードを提供するを参照してください。
次は何ですか
TiDB ダッシュボード UI にアクセスしてログインする方法については、 TiDB ダッシュボードにアクセスするを参照してください。
ファイアウォールの構成など、TiDB ダッシュボードのセキュリティを強化する方法については、 セキュリティTiDB ダッシュボードを参照してください。