tiup cluster import

在 TiDB 4.0 以前的版本,集群多是通过 TiDB Ansible 部署的。TiUP Cluster 提供了 import 命令用于让这些集群过渡到使用 tiup-cluster 组件管理。

注意:

  • TiDB Ansible 配置导入到 TiUP 中管理后,不能再通过 TiDB Ansible 对集群进行操作,否则可能因元信息不一致造成冲突
  • 如果使用 TiDB Ansible 部署的集群存在以下情况之一,暂不支持导入:
    • 启用了 TLS 加密功能的集群
    • 纯 KV 集群(没有 TiDB 实例的集群)
    • 启用了 `Kafka 的集群
    • 启用了 Spark` 的集群
    • 启用了 TiDB Lightning/ Importer 的集群
    • 仍使用老版本 push 的方式收集监控指标(从 v3.0 起默认为 pull 模式,如果没有特意调整过则可以支持)
    • inventory.ini 配置文件中单独为机器的 node_exporter / blackbox_exporter 通过 node_exporter_port/blackbox_exporter_port 设置了非默认端口(在 group_vars 目录中统一配置的可以兼容)

语法

  1. tiup cluster import [flags]

选项

-d, —dir string(string, 默认 当前目录)

指定 TiDB Ansible 所在目录。

—ansible-config(string,默认 “./ansible.cfg”)

指定 Ansible 的配置文件路径。

—inventory string(string,默认 “inventory.ini”)

指定 Ansible inventory 文件的名字。

—no-backup(boolean,默认 false)

默认情况下,导入成功之后会将 --dir 指定的目录里所有内容备份到 ${TIUP_HOME}/.tiup/storage/cluster/clusters/{cluster-name}/ansible-backup 下。该选项用于禁用默认的备份步骤,如果该目录下有多个 inventory 文件(部署了多个集群),推荐禁用默认备份。

—rename(string,默认为空)

重命名导入的集群。默认集群名为 inventory 中指定的 cluster_name。

-h, —help(boolean,默认 false)

输出帮助信息。

输出

导入过程的日志信息。