tiup cluster scale-in

tiup cluster scale-inコマンドを使用してクラスターをスケールインします。これにより、指定されたノードのサービスがオフラインになり、指定されたノードがクラスターから削除され、それらのノードから残りのファイルが削除されます。

コンポーネントのオフライン プロセスの特定の処理

TiKV、TiFlash、および TiDB Binlogコンポーネントは非同期的にオフラインにされ (最初に API を介してノードを削除する必要があるため)、停止プロセスに時間がかかるため (ノードが正常にオフラインにされたかどうかを TiUP が継続的にチェックする必要があります)、 TiKV、TiFlash、および TiDB Binlogコンポーネントは、特に次のように処理されます。

  • TiKV、TiFlash、および TiDB Binlogコンポーネントの場合:

    1. TiUP クラスタは API を介してノードをオフラインにし、プロセスの完了を待たずに直接終了します。

    2. スケールイン中のノードのステータスを確認するには、 tiup cluster displayコマンドを実行し、ステータスがTombstoneになるのを待つ必要があります。

    3. 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を渡すか、値を何も渡さないでください。

出力

スケールイン プロセスのログを表示します。

<< 前のページに戻る - TiUP クラスタコマンド一覧

エコシステム
TiDB
TiKV
TiSpark
Chaos Mesh
© 2022 PingCAP. All Rights Reserved.