tiup dm patch

クラスタの実行中にサービスのバイナリーを動的に置き換える必要がある場合（つまり、置き換え中にクラスタを使用可能な状態に保つため）、 tiup dm patchコマンドを使用できます。このコマンドは次のことを行います。

• 交換用のバイナリパッケージをターゲットマシンにアップロードします。
• APIを使用して関連ノードをオフラインにします。
• ターゲットサービスを停止します。
• バイナリパッケージを解凍し、サービスを置き換えます。
• ターゲットサービスを開始します。

構文

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

• <cluster-name> ：操作するクラスタの名前。
• <package-path> ：置換に使用されるバイナリパッケージへのパス。

準備

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

• 置き換えるコンポーネントの名前${component} （dm-master、dm-worker ...）、コンポーネントの${version} （v2.0.0、v2.0.1 ...）、およびオペレーティングシステム${os}とプラットフォーム${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 dm patchコマンドで<package-path>の値として/tmp/${component}-hotfix-${os}-${arch}.tar.gzを使用できます。

オプション

--overwrite

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

-N、-node

• 置き換えるノードを指定します。このオプションの値は、ノードIDのコンマ区切りのリストです。 [tiup dm display](/tiup/tiup-component-dm-display.md)コマンドによって返されるクラスタステータステーブルの最初の列からノードIDを取得できます。
• データ型： STRING
• このオプションが指定されていない場合、TiUPはデフォルトで置き換えるすべてのノードを選択します。

ノート：

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

-R、-role

• 置き換える役割を指定します。このオプションの値は、ノードの役割のコンマ区切りのリストです。ノードの役割は、 [tiup dm display](/tiup/tiup-component-dm-display.md)コマンドによって返されるクラスタステータステーブルの2番目の列から取得できます。
• データ型： STRING
• このオプションが指定されていない場合、TiUPはデフォルトで置き換えるすべての役割を選択します。

ノート：

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

--offline

• 現在のクラスタがオフラインであることを宣言します。このオプションを指定すると、 TiUP DMは、サービスを再起動せずに、所定の場所にあるクラスタコンポーネントのバイナリファイルのみを置き換えます。

-h, --help

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

出力

tiup-dmの実行ログ。

<<前のページに戻るTiUP DMコマンドリスト