tiup cluster import
TiDB v4.0 より前では、TiDB クラスターは主に TiDB Ansible を使用してデプロイされていました。TiDB v4.0 以降のリリースでは、 TiUP クラスタ は、クラスターを管理用のtiup-clusterコンポーネントに転送するimportコマンドを提供します。
注記：
- 管理のために TiDB Ansible 構成をTiUPにインポートした後は、クラスター操作に TiDB Ansible を使用しないでください。そうしないと、メタ情報の不一致により競合が発生する可能性があります。
- TiDB Ansible を使用してデプロイされたクラスターが次のいずれかの状況にある場合は、
importコマンドを使用しないでください。
- TLS暗号化が有効になっているクラスター
- 純粋な KV クラスター (TiDB インスタンスのないクラスター)
- Kafka が有効になっているクラスター
- Spark が有効になっているクラスター
- TiDB Lightning/TiKV インポーターが有効になっているクラスター
- 監視メトリックを収集するために古い
pushモードをまだ使用しているクラスター (デフォルト モードpullを変更しない場合は、importコマンドの使用がサポートされます)- デフォルト以外のポート（
group_varsディレクトリで設定されたポートは互換性がある）がnode_exporter_port/blackbox_exporter_portを使用してinventory.ini構成ファイルで個別に設定されているクラスタ- TiDB Ansible を使用してデプロイされたクラスター内の一部のノードが監視コンポーネントなしでデプロイされている場合は、まず TiDB Ansible を使用して
inventory.iniファイルのmonitored_serversセクションに対応するノード情報を追加し、次にdeploy.yamlプレイブックを使用して監視コンポーネントを完全にデプロイする必要があります。そうしないと、クラスターをTiUPにインポートした後にメンテナンス操作を実行すると、監視コンポーネントが不足しているためにエラーが発生する可能性があります。
構文
tiup cluster import [flags]
オプション
-d, --dir
- TiDB Ansible が配置されているディレクトリを指定します。
- データ型:
STRING - このオプションは、現在のディレクトリ (デフォルト値) が渡され、デフォルトで有効になります。
--ansible-config
- Ansible 構成ファイルのパスを指定します。
- データ型:
STRING - このオプションは、
. /ansible.cfg(デフォルト値) が渡されるとデフォルトで有効になります。
--inventory
- Ansible インベントリ ファイルの名前を指定します。
- データ型:
STRING - このオプションはデフォルトで有効になっており、
inventory.ini(デフォルト値) が渡されます。
--no-backup
- TiDB Ansible が配置されているディレクトリ内のファイルのバックアップを無効にするかどうかを制御します。
- データ型:
BOOLEAN - このオプションは、デフォルトで値
falseで無効になっています。インポートが成功すると、オプション-dirで指定されたディレクトリ内のすべてのものがディレクトリ${TIUP_HOME}/.tiup/storage/cluster/clusters/{cluster-name}/ansible-backupにバックアップされます。このディレクトリに複数のインベントリ ファイルがある場合 (複数のクラスターがデプロイされている場合)、このオプションを有効にすることをお勧めします。このオプションを有効にするには、このオプションをコマンドに追加し、値trueを渡すか、値を渡さないようにする必要があります。
--rename
- インポートされたクラスターの名前を変更します。
- データ型:
STRING - デフォルト: NULL。このオプションがコマンドで指定されていない場合は、インベントリで指定された cluster_name がクラスター名として使用されます。
-h, --help
- ヘルプ情報を出力します。
- データ型:
BOOLEAN - このオプションは、値
falseでデフォルトで無効になっています。このオプションを有効にするには、このオプションをコマンドに追加し、値trueを渡すか、値を渡さないようにする必要があります。
出力
インポート プロセスのログを表示します。