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。コマンドでこのオプションを指定しない場合は、inventory で指定したクラスター名がクラスター名として使用されます。
-h, --help
- ヘルプ情報を出力します。
- データ型:
BOOLEAN - このオプションは、値
falseを指定するとデフォルトで無効になります。このオプションを有効にするには、このオプションをコマンドに追加し、値true渡すか、値を渡しません。
出力
インポートプロセスのログを表示します。