tiup cluster upgrade

tiup cluster upgradeコマンドは、指定されたクラスターを特定のバージョンにアップグレードするために使用されます。

構文

tiup cluster upgrade <cluster-name> <version> [flags]
  • <cluster-name> : 操作するクラスター名。クラスター名を忘れた場合は、 クラスタ リストコマンドで確認できます。
  • <version> : アップグレード先のターゲット バージョン。現在、現在のクラスターよりも高いバージョンへのアップグレードのみが許可されています。つまり、ダウングレードは許可されていません。また、ナイトリー バージョンへのアップグレードも許可されていません。

オプション

--force

  • クラスターをアップグレードするには、クラスターが現在開始されていることを確認する必要があります。場合によっては、クラスターが開始されていないときにアップグレードする必要があります。この時点で、 --forceを使用してアップグレード中のエラーを無視し、バイナリ ファイルを強制的に置き換えてクラスターを起動できます。
  • データ型: BOOLEAN
  • デフォルト: false

ノート:

サービスを提供しているクラスターのアップグレードを強制すると、サービスが利用できなくなる可能性があります。アップグレードが正常に完了すると、未起動のクラスターが自動的に起動されます。

--transfer-timeout

  • PD または TiKV をアップグレードすると、アップグレードされたノードのリーダーが最初に他のノードに移行されます。移行プロセスには時間がかかりますが、オプション-transfer-timeoutで最大待機時間 (秒単位) を設定できます。タイムアウト後、待機はスキップされ、サービスは直接アップグレードされます。
  • データ型: uint
  • デフォルト: 300

ノート:

待機をスキップしてサービスを直接アップグレードすると、サービスのパフォーマンスが低下する可能性があります。

--ignore-config-check

  • バイナリが更新された後、 <binary> --config-check <config-file>を使用して TiDB、TiKV、および PD コンポーネントで構成チェックが実行されます。 <binary>は新しくデプロイされたバイナリへのパスで、 <config-file>はユーザー構成に基づいて生成された構成ファイルです。このチェックをスキップするには、 --ignore-config-checkオプションを使用できます。
  • データ型: BOOLEAN
  • デフォルト: false

--offline

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

-h, --help

  • ヘルプ情報を出力します。
  • データ型: BOOLEAN
  • デフォルト: false

出力

アップグレードの進行状況のログ。

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

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