Question

本文主要说明 TiUP 的重要术语和核心概念。

TiUP 组件

TiUP 程序只包含少数几个命令，用来下载、更新、卸载组件。TiUP 通过各种组件来扩展其功能。组件是一个可以运行的程序或脚本，通过 tiup <component> 运行组件时，TiUP 会添加一组环境变量，并为该程序创建好对应的数据目录，然后运行该程序。

通过运行 tiup <component> 命令，你可以运行支持的 TiUP 组件，其中运行的逻辑为：

1. 如果用户通过 tiup <component>[:version] 运行指定某个组件的特定版本：

   • 组件在本地未安装任何版本，则从镜像服务器下载最新稳定版本
   • 组件在本地安装有其他版本，但是没有用户指定的版本，则从镜像服务器下载用户指定版本
   • 如果本地已经安装指定版本，则设置环境变量来运行已经安装的版本

2. 如果用户通过 tiup <component> 运行某个组件，且未指定任何版本：

   • 组件在本地未安装任何版本，则从镜像服务器下载最新稳定版本
   • 如果本地已经安装部分版本，则设置环境变量来运行已经安装的版本中的最新版本

TiUP 镜像仓库

TiUP 的所有组件都从镜像仓库 (mirrors) 下载，镜像仓库包含各个组件的 TAR 包以及对应的元信息（版本、入口启动文件、校验和）。TiUP 默认使用 PingCAP 官方的镜像仓库。用户可以通过 TIUP_MIRRORS 环境变量自定义镜像仓库。

镜像仓库可以是本地文件目录或在线 HTTP 服务器：

1. TIUP_MIRRORS=/path/to/local tiup list
2. TIUP_MIRRORS=https://private-mirrors.example.com tiup list