使用 TiUP 命令管理组件

    • list：查询组件列表，用于了解可以安装哪些组件，以及这些组件可选哪些版本
    • install：安装某个组件的特定版本
    • update：升级某个组件到最新的版本
    • uninstall：卸载组件
    • status：查看组件运行状态
    • clean：清理组件实例
    • help：打印帮助信息，后面跟其他 TiUP 命令则是打印该命令的使用方法

    本文介绍常用的组件管理操作及相应命令。

    你可以使用 命令来查询组件列表。该命令用法如下：

    • tiup list：查看当前有哪些组件可以安装
    • tiup list ${component}：查看某个组件有哪些版本可以安装

    你也可以在命令中组合使用以下参数 (flag)：

    • --installed：查看本地已经安装了哪些组件，或者已经安装了某个组件的哪些版本
    • --all：显式隐藏的组件

    示例一：查看当前已经安装的所有组件

    示例二：从服务器获取 TiKV 所有可安装版本组件列表

    1. tiup list tikv

    你可以使用 tiup install 命令来安装组件。该命令的用法如下：

    • tiup install <component>：安装指定组件的最新稳定版
    • tiup install <component>:[version]：安装指定组件的指定版本

    示例一：使用 TiUP 安装最新稳定版的 TiDB

    1. tiup install tidb

    示例二：使用 TiUP 安装 nightly 版本的 TiDB

    1. tiup install tidb:nightly

    示例三：使用 TiUP 安装 v3.0.6 版本的 TiKV

    1. tiup install tikv:v3.0.6

    在官方组件提供了新版之后，你可以使用 tiup update 命令来升级组件。除了以下几个参数，该命令的用法基本和 tiup install 相同：

    • --all：升级所有组件
    • ：升级至 nightly 版本
    • --self：升级 TiUP 自己至最新版本
    • --force：强制升级至最新版本
    1. tiup update --all

    示例二：升级所有组件至 nightly 版本

    示例三：升级 TiUP 至最新版本

    1. tiup update --self

    安装完成之后，你可以使用 tiup <component> 命令来启动相应的组件：

    1. tiup [flags] <component>[:version] [args...]
    3. Flags:
    4.   -T, --tag string                     为组件实例指定 tag

    该命令需要提供一个组件的名字以及可选的版本，若不提供版本，则使用该组件已安装的最新稳定版。

    在组件启动之前，TiUP 会先为它创建一个目录，然后将组件放到该目录中运行。组件会将所有数据生成在该目录中，目录的名字就是该组件运行时指定的 tag 名称。如果不指定 tag，则会随机生成一个 tag 名称，并且在实例终止时自动删除工作目录。

    如果想要多次启动同一个组件并复用之前的工作目录，就可以在启动时用 --tag 指定相同的名字。指定 tag 后，在实例终止时就不会自动删除工作目录，方便下次启动时复用。

    示例一：运行 v3.0.8 版本的 TiDB

    1. tiup tidb:v3.0.8

    示例二：指定 tag 运行 TiKV

    1. tiup --tag=experiment tikv

    你可以使用 tiup status 命令来查看组件的运行状态：

      运行该命令会得到一个实例列表，每行一个实例。列表中包含这些列：

      • Name：实例的 tag 名称
      • Component：实例的组件名称
      • PID：实例运行的进程 ID
      • Status：实例状态，RUNNING 表示正在运行， 表示已经终止
      • Created Time：实例的启动时间
      • Directory：实例的工作目录，可以通过 --tag 指定
      • Binary：实例的可执行程序，可以通过 --binpath 指定
      • Args：实例的运行参数

      支持以下参数：

      • --all：清除所有的实例信息

      其中 tag 表示要清理的实例 tag，如果使用了 --all 则不传递 tag。

      示例一：清理 tag 名称为 experiment 的组件实例

      1. tiup clean experiment

      示例二：清理所有组件实例

      1. tiup clean --all

      TiUP 安装的组件会占用本地磁盘空间，如果不想保留过多老版本的组件，可以先查看当前安装了哪些版本的组件，然后再卸载某个组件。

      你可以使用 tiup uninstall 命令来卸载某个组件的所有版本或者特定版本，也支持卸载所有组件。该命令用法如下：

      1. tiup uninstall [component][:version] [flags]

      支持的参数：

      • --all：卸载所有的组件或版本
      • --self：卸载 TiUP 自身

      component 为要卸载的组件名称，version 为要卸载的版本，这两个都可以省略，省略任何一个都需要加上 --all 参数：

      • 若省略版本，加 --all 表示卸载该组件所有版本
      • 若版本和组件都省略，则加 --all 表示卸载所有组件及其所有版本

      示例一：卸载 v3.0.8 版本的 TiDB

      示例二：卸载所有版本的 TiKV

      1. tiup uninstall tikv --all