tiup cluster scale-in
tiup cluster scale-inコマンドはクラスターをスケールインするために使用され、指定されたノードのサービスをオフラインにし、指定されたノードをクラスターから削除し、それらのノードから残りのファイルを削除します。
コンポーネントのオフラインプロセスの特別な処理
TiKV およびTiFlashコンポーネントは非同期的にオフラインになるため (最初にTiUP がAPI を介してノードを削除する必要がある)、停止プロセスには長い時間がかかる (ノードが正常にオフラインになったかどうかをTiUPが継続的に確認する必要がある) ため、TiKV およびTiFlashコンポーネントは特に次のように処理されます。
TiKV およびTiFlashコンポーネントの場合:
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を渡すか、値を渡さないでください。
出力
スケールイン プロセスのログを表示します。