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