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コマンドを実行する必要があります。5 コマンド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 - このオプションはデフォルトで有効になっており、
600秒 (デフォルト値) が渡されます。
注記：
リーダー転送が完了するのを待たずに PD ノードまたは TiKV ノードが直接オフラインになると、サービス パフォーマンスが不安定になる可能性があります。
-h, --help
- ヘルプ情報を出力します。
- データ型:
BOOLEAN - このオプションは、値
falseでデフォルトで無効になっています。このオプションを有効にするには、このオプションをコマンドに追加し、値trueを渡すか、値を渡さないようにする必要があります。
出力
スケールイン プロセスのログを表示します。