tiup cluster upgrade

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

構文

tiup cluster upgrade <cluster-name> <version> [flags]

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

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

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

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

注記：
待機をスキップしてサービスを直接アップグレードすると、サービスのパフォーマンスが不安定になる可能性があります。

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

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

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