tiup cluster scale-in
tiup cluster scale-inコマンドはクラスターのスケールインに使用されます。これにより、指定されたノードのサービスがオフラインになり、指定されたノードがクラスターから削除され、残りのファイルがそれらのノードから削除されます。
コンポーネントのオフラインプロセスの特別な処理
TiKV、 TiFlash、および TiDB Binlogコンポーネントは非同期的にオフラインになり ( TiUP が最初に API を介してノードを削除する必要がある)、停止プロセスに長い時間がかかるため ( TiUP はノードが正常にオフラインになったかどうかを継続的に確認する必要がある)、 TiKV、 TiFlash、および TiDB Binlogコンポーネントは、特に次のように処理されます。
TiKV、 TiFlash、および TiDB Binlogコンポーネントの場合:
TiUPクラスタはAPI を通じてノードをオフラインにし、プロセスの完了を待たずに直接終了します。
スケールイン中のノードのステータスを確認するには、
tiup cluster displayコマンドを実行し、ステータスがTombstoneになるまで待つ必要があります。Tombstone状態のノードをクリーンアップするには、tiup cluster pruneコマンドを実行する必要があります。tiup cluster pruneコマンドは次の操作を実行します。- オフラインになったノードのサービスを停止します。
- オフラインになったノードのデータ ファイルをクリーンアップします。
- クラスター トポロジを更新し、オフラインになったノードを削除します。
他のコンポーネントの場合:
- PD コンポーネントをオフラインにすると、 TiUP クラスタ はAPI を通じて指定されたノードをクラスターから迅速に削除し、指定された PD ノードのサービスを停止してから、関連するデータ ファイルをノードから削除します。
- 他のコンポーネントを停止すると、 TiUPクラスタはノード サービスを直接停止し、指定されたノードから関連データ ファイルを削除します。
構文
tiup cluster scale-in <cluster-name> [flags]
<cluster-name>は、スケールインするクラスターの名前です。クラスター名を忘れた場合は、 tiup cluster listコマンドを使用して確認できます。
オプション
-N、--node
- 削除するノードを指定します。複数のノードはカンマで区切られます。
- データ型:
STRING - デフォルト値はありません。このオプションは必須であり、値は null であってはなりません。
--force
- 指定したノードをクラスターから強制的に削除するかどうかを制御します。場合によっては、オフラインにするノードのホストがダウンし、操作のために SSH 経由でノードに接続できなくなることがあります。そのため、
--forceオプションを使用してクラスターからノードを強制的に削除できます。 - データ型:
BOOLEAN - このオプションは、値
falseを指定するとデフォルトで無効になります。このオプションを有効にするには、このオプションをコマンドに追加し、値true渡すか、値を渡しません。
--transfer-timeout
- PD または TiKV ノードが削除される場合、最初にノード上のリージョンリーダーが別のノードに転送されます。転送プロセスには時間がかかるため、
--transfer-timeoutを設定することで最大待機時間 (秒単位) を設定できます。タイムアウト後、tiup cluster scale-inコマンドは待機をスキップし、スケールインを直接開始します。 - データ型:
UINT - このオプションはデフォルトで有効になり、
600秒 (デフォルト値) が渡されます。
ノート：
リーダー転送の完了を待たずに、PD または TiKV ノードが直接オフラインになると、サービスのパフォーマンスが不安定になる可能性があります。
-h, --help
- ヘルプ情報を印刷します。
- データ型:
BOOLEAN - このオプションは、値
falseを指定するとデフォルトで無効になります。このオプションを有効にするには、このオプションをコマンドに追加し、値true渡すか、値を渡しません。
出力
スケールインプロセスのログを表示します。