tiup cluster patch

クラスターの実行中にサービスのバイナリを動的に置き換える必要がある場合 (つまり、置き換えプロセス中にクラスターを使用可能な状態に保つ必要がある場合)、 tiup cluster patchコマンドを使用できます。コマンドの実行後、 TiUP は次の処理を実行します。

置換用のバイナリパッケージをターゲットマシンにアップロードします。
ターゲットサービスが TiKV、 TiFlash、TiDB Binlogなどのstorageサービスの場合、 TiUP はまず API 経由で関連ノードをオフラインにします。
対象サービスを停止します。
バイナリパッケージを解凍し、サービスを置き換えます。
対象サービスを開始します。

構文

tiup cluster patch <cluster-name> <package-path> [flags]

tiup cluster patchコマンドを実行する前に、必要なバイナリパッケージをパックする必要があります。次の手順を実行します。

次の変数を決定します。
- ${component} : 置換するコンポーネントの名前 ( tidb 、 tikv 、 pdなど)。
- ${version} :コンポーネントのバージョン ( v8.1.0やv7.5.1など)。
- ${os} :オペレーティングシステム（ linux ）。
- ${arch} :コンポーネントが実行されるプラットフォーム ( amd64 、 arm64 )。

次のコマンドを使用して、現在のコンポーネントパッケージをダウンロードします。

wget https://tiup-mirrors.pingcap.com/${component}-${version}-${os}-${arch}.tar.gz -O /tmp/${component}-${version}-${os}-${arch}.tar.gz

ファイルをパックするための一時ディレクトリを作成し、そこに移動します。
```
mkdir -p /tmp/package && cd /tmp/package
```

元のバイナリパッケージを抽出します。

tar xf /tmp/${component}-${version}-${os}-${arch}.tar.gz

一時ディレクトリ内のファイル構造を確認します。
```
find .
```
バイナリファイルまたは構成ファイルを一時ディレクトリ内の対応する場所にコピーします。
すべてのファイルを一時ディレクトリにパックします。
```
tar czf /tmp/${component}-hotfix-${os}-${arch}.tar.gz *
```

上記の手順を完了したら、 tiup cluster patchコマンドの<package-path>として/tmp/${component}-hotfix-${os}-${arch}.tar.gz使用できます。

特定のコンポーネント(TiDB や TiKV など) にパッチを適用した後、tiup クラスターがコンポーネントをスケールアウトすると、 TiUP はデフォルトで元のコンポーネントバージョンを使用します。将来クラスターがスケールアウトするときにパッチを適用したバージョンを使用するには、コマンドでオプション--overwriteを指定する必要があります。
データ型: BOOLEAN
このオプションは、デフォルトで値falseで無効になっています。このオプションを有効にするには、このオプションをコマンドに追加し、値trueを渡すか、値を渡さないようにする必要があります。

PD または TiKV サービスを再起動する場合、TiKV/PD は最初に再起動するノードのリーダーを別のノードに転送します。転送プロセスには時間がかかるため、オプション--transfer-timeoutを使用して最大待機時間 (秒単位) を設定できます。タイムアウト後、 TiUP はサービスを直接再起動します。
データ型: UINT
このオプションを指定しない場合、 TiUP は600秒待機した後、サービスを直接再起動します。

注記：
タイムアウト後にTiUP がサービスを直接再起動すると、サービスのパフォーマンスが不安定になる可能性があります。

置換するノードを指定します。このオプションの値はtiup cluster displayノード ID のコンマ区切りリストです。3 コマンドによって返されるクラスターステータステーブルの最初の列からノード ID を取得できます。
データ型: STRINGS
このオプションが指定されていない場合、 TiUP はデフォルトで置換するノードを選択しません。

注記：
オプション-R, --roleが同時に指定されている場合、 TiUP は-N, --nodeと-R, --roleの両方の要件に一致するサービスノードを置き換えます。

置き換えるロールを指定します。このオプションの値は、ノードのロールのコンマ区切りリストです。3 コマンドによって返されるクラスターステータステーブルの 2 番目の列から、ノードにデプロイされてtiup cluster displayロールを取得できます。
データ型: STRINGS
このオプションが指定されていない場合、 TiUP はデフォルトで置き換えるロールを選択しません。

注記：
オプション-N, --nodeが同時に指定されている場合、 TiUP は-N, --nodeと-R, --roleの両方の要件に一致するサービスノードを置き換えます。

現在のクラスターが実行中でないことを宣言します。このオプションを指定すると、 TiUP はサービスリーダーを別のノードに移動したり、サービスを再起動したりせず、クラスターコンポーネントのバイナリファイルのみを置き換えます。
データ型: BOOLEAN
このオプションは、デフォルトで値falseで無効になっています。このオプションを有効にするには、このオプションをコマンドに追加し、値trueを渡すか、値を渡さないようにする必要があります。

ヘルプ情報を出力します。
データ型: BOOLEAN
このオプションは、値falseでデフォルトで無効になっています。このオプションを有効にするには、このオプションをコマンドに追加し、値trueを渡すか、値を渡さないようにする必要があります。

tiup-clusterの実行ログ。