tiup cluster reload
クラスタ構成の変更後、設定を有効にするには、 tiup cluster reloadコマンドを使用してクラスタをリロードする必要があります。このコマンドは、制御マシンの設定をサービスが稼働しているリモートマシンに公開し、アップグレードプロセスに従ってサービスを順番に再起動します。再起動プロセス中もクラスタは引き続き利用可能です。
構文
tiup cluster reload <cluster-name> [flags]
<cluster-name> : 操作対象のクラスター名。
オプション
--force
- 再ロード プロセス中のエラーを無視し、強制的に再ロードします。
- データ型:
BOOLEAN - デフォルト: false
--transfer-timeout
- PDまたはTiKVを再起動する際、再起動されたノードのリーダーノードが最初に他のノードに移行されるため、移行プロセスには時間がかかります。最大待機時間(秒単位)を
-transfer-timeoutに設定できます。タイムアウト後、サービスは待機せずに直接再起動できます。 - データ型:
UINT - デフォルト: 600
注記:
待機をスキップして直接再起動する場合、サービスのパフォーマンスが不安定になる可能性があります。
--ignore-config-check
- コンポーネントのバイナリファイルがデプロイされた後、
<binary> --config-check <config-file>使用して TiDB、TiKV、PD コンポーネントの設定がチェックされます。3<binary>デプロイされたバイナリファイルのパスです。5<config-file>ユーザー設定に基づいて生成された設定ファイルです。このチェックをスキップしたい場合は、このオプションを使用できます。 - データ型:
BOOLEAN - デフォルト: false
-N, --node
- 再起動するノードを指定します。指定しない場合は、すべてのノードが再起動されます。このオプションの値は、ノードIDのカンマ区切りのリストです。ノードIDは、
tiup cluster displayコマンドで返されるクラスターステータステーブルの最初の列から取得できます。 - データ型:
STRINGS - このオプションがコマンドで指定されていない場合は、デフォルトですべてのノードが選択されます。
注記:
-R, --roleオプションを同時に指定した場合は、-N, --nodeと-R, --role両方の指定に一致するサービス ノードのみが再起動されます。- オプション
--skip-restart指定した場合、オプション-N, --nodeは無効になります。
-R, --role
- 再起動するロールを指定します。指定しない場合は、すべてのロールが再起動されます。このオプションの値は、ノードロールのカンマ区切りのリストです。ロールは、表クラスターステータスの2番目の列です。
- データ型:
STRINGS - コマンドでこのオプションを指定しない場合は、すべてのロールがデフォルトで選択されます。
注記:
-N, --nodeオプションを同時に指定した場合は、-N, --nodeと-R, --role両方の指定に一致するサービス ノードのみが再起動されます。- オプション
--skip-restart指定した場合、オプション-R, --roleは無効になります。
--skip-restart
tiup cluster reloadコマンドは 2 つの操作を実行します。
- すべてのノード構成を更新します
- 指定されたノードを再起動します
--skip-restartオプションを指定すると、ノードを再起動せずに構成のみが更新されるため、更新された構成は適用されず、対応するサービスの次回の再起動まで有効になりません。
- データ型:
BOOLEAN - デフォルト: false
-h, --help
- ヘルプ情報を出力します。
- データ型:
BOOLEAN - デフォルト: false
--pre-restart-script
- リロード前にスクリプトを実行します。
- データ型:
STRINGS - このオプションは、リロードするノードで実行されるスクリプトのパスを指定します。1
--skip-restarttrueに設定した場合は無効になります。
--post-restart-script
- リロード後にスクリプトを実行します。
- データ型:
STRINGS - このオプションは、ノードのリロード後に実行されるスクリプトのパスを指定します。1
--skip-restarttrueに設定されている場合は有効になりません。
出力
tiup-clusterの実行ログ。