tiup cluster scale-in
tiup cluster scale-inコマンドを使用してクラスターをスケールインします。これにより、指定されたノードのサービスがオフラインになり、指定されたノードがクラスターから削除され、それらのノードから残りのファイルが削除されます。
コンポーネントのオフライン プロセスの特定の処理
TiKV、 TiFlash、および TiDB Binlogコンポーネントは非同期的にオフラインにされ (最初に 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, --ノード
- 停止するノードを指定します。複数のノードはカンマで区切ります。
- データ型:
STRING - デフォルト値はありません。このオプションは必須であり、値は null であってはなりません。
--force
- 指定したノードをクラスターから強制的に削除するかどうかを制御します。場合によっては、オフラインにするノードのホストがダウンし、SSH 経由でノードに接続して操作できない場合があるため、オプション
--forceを使用してノードをクラスターから強制的に削除できます。 - データ型:
BOOLEAN - このオプションはデフォルトで無効になっており、値は
falseです。このオプションを有効にするには、このオプションをコマンドに追加し、値true渡すか、値を何も渡さないでください。
--transfer-timeout
- PD または TiKV ノードが削除される場合、ノードのリージョンリーダーが最初に別のノードに転送されます。転送プロセスには時間がかかるため、
--transfer-timeoutを構成して最大待機時間 (秒単位) を設定できます。タイムアウト後、tiup cluster scale-inコマンドは待機をスキップし、スケールインを直接開始します。 - データ型:
UINT - このオプションはデフォルトで有効になっており、
300秒 (デフォルト値) が渡されます。
ノート：
リーダーの転送が完了するのを待たずに PD または TiKV ノードを直接オフラインにすると、サービスのパフォーマンスが低下する可能性があります。
-h, --help
- ヘルプ情報を出力します。
- データ型:
BOOLEAN - このオプションはデフォルトで無効になっており、値は
falseです。このオプションを有効にするには、このオプションをコマンドに追加し、値true渡すか、値を何も渡さないでください。
出力
スケールイン プロセスのログを表示します。