tiup cluster upgrade
tiup cluster upgradeコマンドは、指定されたクラスターを特定のバージョンにアップグレードするために使用されます。
構文
tiup cluster upgrade <cluster-name> <version> [flags]
<cluster-name>: 操作対象のクラスター名。クラスター名を忘れた場合は、 クラスターリストコマンドで確認できます。<version>: アップグレードするターゲットバージョン (例:v8.5.0)。現在、現在のクラスターよりも高いバージョンへのアップグレードのみが許可されており、ダウングレードは許可されていません。また、ナイトリーバージョンへのアップグレードも許可されていません。
オプション
--force
- クラスターをアップグレードするには、クラスターが現在起動していることを確認する必要があります。場合によっては、クラスターが起動していないときにアップグレードする必要があるかもしれません。このとき、
--force使用してアップグレード中のエラーを無視し、バイナリ ファイルを強制的に置き換えてクラスターを起動することができます。 - データ型:
BOOLEAN - デフォルト: false
注記：
サービスを提供しているクラスターのアップグレードを強制すると、サービスが利用できなくなる可能性があります。起動されていないクラスターは、アップグレードが成功すると自動的に起動されます。
--transfer-timeout
- PD または TiKV をアップグレードする場合、アップグレードされたノードのリーダーが最初に他のノードに移行されます。移行プロセスには時間がかかり、
-transfer-timeoutオプションで最大待機時間 (秒単位) を設定できます。タイムアウト後、待機はスキップされ、サービスは直接アップグレードされます。 - データ型:
uint - デフォルト: 600
注記：
待機をスキップしてサービスを直接アップグレードすると、サービスのパフォーマンスが不安定になる可能性があります。
--設定チェックを無視
- バイナリが更新されると、
<binary> --config-check <config-file>使用して TiDB、TiKV、および PD コンポーネントの構成チェックが実行されます。<binary>新しくデプロイされたバイナリへのパスであり、<config-file>ユーザー構成に基づいて生成された構成ファイルです。 このチェックをスキップするには、--ignore-config-checkオプションを使用できます。 - データ型:
BOOLEAN - デフォルト: false
--バージョンチェックを無視
- アップグレードする前に、 TiUP はターゲット バージョンが現在のバージョン以上であるかどうかを確認します。このチェックをスキップするには、
--ignore-version-checkオプションを使用できます。 - データ型:
BOOLEAN - このオプションは、値
falseでデフォルトで無効になっています。このオプションを有効にするには、このオプションをコマンドに追加し、値trueを渡すか、値を渡さないようにします。
--offline
- 現在のクラスターが実行中でないことを宣言します。このオプションを指定すると、 TiUP はサービス リーダーを別のノードに移動したり、サービスを再起動したりせず、クラスター コンポーネントのバイナリ ファイルのみを置き換えます。
- データ型:
BOOLEAN - このオプションは、値
falseでデフォルトで無効になっています。このオプションを有効にするには、このオプションをコマンドに追加し、値trueを渡すか、値を渡さないようにします。
--pdバージョン
- PD のバージョンを指定します。このオプションを設定すると、PD のバージョンはクラスターのバージョンと一致しなくなります。
- データ型:
STRINGS - このオプションが設定されていない場合、PD のバージョンはクラスターのバージョンと一致し続けます。
--tikv バージョン
- TiKV のバージョンを指定します。このオプションを設定すると、TiKV のバージョンはクラスターのバージョンと一致しなくなります。
- データ型:
STRINGS - このオプションが設定されていない場合、TiKV のバージョンはクラスターのバージョンと一致したままになります。
--tikv-cdc バージョン
- TiKV CDC のバージョンを指定します。このオプションを設定すると、TiKV CDC のバージョンはクラスターのバージョンと一致しなくなります。
- データ型:
STRINGS - このオプションが設定されていない場合、TiKV CDC のバージョンはクラスターのバージョンと一致し続けます。
--tiflash バージョン
- TiFlashのバージョンを指定します。このオプションを設定すると、 TiFlashのバージョンはクラスターのバージョンと一致しなくなります。
- データ型:
STRINGS - このオプションが設定されていない場合、 TiFlashのバージョンはクラスターのバージョンと一致したままになります。
--cdc バージョン
- TiCDC のバージョンを指定します。このオプションを設定すると、TiCDC のバージョンはクラスターのバージョンと一致しなくなります。
- データ型:
STRINGS - このオプションが設定されていない場合、TiCDC のバージョンはクラスターのバージョンと一致し続けます。
--tiproxy バージョン
- TiProxy のバージョンを指定します。このオプションを設定すると、TiProxy のバージョンはクラスターのバージョンと一致しなくなります。
- データ型:
STRINGS - このオプションが設定されていない場合、TiProxy のバージョンはクラスターのバージョンと一致したままになります。
--tidb ダッシュボードバージョン
- TiDB ダッシュボードのバージョンを指定します。このオプションを設定すると、TiDB ダッシュボードのバージョンはクラスターのバージョンと一致しなくなります。
- データ型:
STRINGS - このオプションが設定されていない場合、TiDB ダッシュボードのバージョンはクラスターのバージョンと一致し続けます。
--アラートマネージャバージョン
- アラート マネージャーのバージョンを指定します。このオプションを設定すると、アラート マネージャーのバージョンはクラスターのバージョンと一致しなくなります。
- データ型:
STRINGS - このオプションが設定されていない場合、アラート マネージャーのバージョンはクラスターのバージョンと一致したままになります。
--blackbox-exporter-version
- Blackbox Exporter のバージョンを指定します。このオプションを設定すると、Blackbox Exporter のバージョンはクラスターのバージョンと一致しなくなります。
- データ型:
STRINGS - このオプションが設定されていない場合、Blackbox Exporter のバージョンはクラスターのバージョンと一致したままになります。
--node-exporter-version
- Node Exporter のバージョンを指定します。このオプションを設定すると、Node Exporter のバージョンはクラスターのバージョンと一致しなくなります。
- データ型:
STRINGS - このオプションが設定されていない場合、Node Exporter のバージョンはクラスターのバージョンと一致し続けます。
-h, --help
- ヘルプ情報を出力します。
- データ型:
BOOLEAN - このオプションは、値
falseでデフォルトで無効になっています。このオプションを有効にするには、このオプションをコマンドに追加し、値trueを渡すか、値を渡さないようにします。
---アップグレード前のスクリプト
- アップグレード前にスクリプトを実行します。
- データ型:
STRINGS - このオプションは、アップグレードするノードで実行されるスクリプトのパスを指定します。
---アップグレード後のスクリプト
- アップグレード後にスクリプトを実行します。
- データ型:
STRINGS - このオプションは、ノードのアップグレード後に実行されるスクリプトのパスを指定します。このスクリプトは、アップグレードされたノード自体で実行されます。
出力
アップグレードの進行状況のログ。