重要

現在表示されているページは、TiDBのアーカイブされたドキュメント (非更新) です。TiDBをご利用の場合、最新のLTS (Long Term Support) バージョンの使用を推奨します。

重要

このページは英語版のページを機械翻訳しています。原文はこちらからご覧ください。

tiup cluster patch

クラスターの実行中にサービスのバイナリを動的に置き換える必要がある場合 (つまり、置き換えプロセス中にクラスターを利用できるようにしておく必要がある場合)、 tiup cluster patchコマンドを使用できます。コマンドの実行後、TiUP は次のことを行います。

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

構文

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

次の手順に従って、このコマンドに必要なバイナリパッケージを事前にパックする必要があります。

置き換えるコンポーネントの名前${component} (tidb、tikv、pd...)、コンポーネントの${version} (v4.0.0、v4.0.1 ...)、およびオペレーティングシステム${os} ( linux ) とプラットフォーム${arch}を特定します。コンポーネントが実行される場所。
コマンド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 は300秒待ってからサービスを直接再起動します。

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

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

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

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

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

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

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

tiup-clusterの実行ログ。