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渡すか、値を渡しません。
出力
スケールインプロセスのログを表示します。