TiUP 安装与使用教程

1. 项目目录结构及介绍

TiUP 的目录结构通常如下：

.
├── bin          # 存放可执行文件，如 tiup、tiup-playground 等
├── etc           # 配置文件夹，存储 TiUP 的全局设置
├── home          # 用户数据目录，包括组件的元数据、集群的日志等
└── libexec       # 内部使用的脚本和程序

• bin: 存放 TiUP 可执行命令，通过将该路径添加到 $PATH 环境变量中，可以在终端中直接运行 TiUP 命令。
• etc: 包含 TiUP 的配置文件，一般不需要用户直接修改。
• home: TiUP 运行时产生的用户数据，例如集群的配置、日志文件和状态信息。
• libexec: 用于 TiUP 内部功能的脚本和辅助工具。

2. 项目启动文件介绍

主要的启动文件是 tiup，它是一个 Bash 脚本，负责初始化 TiUP 环境并执行实际操作。在终端中，你可以通过以下命令启动 TiUP：

./bin/tiup

或者，当你将 bin 目录添加到 $PATH 后，可以直接输入：

tiup

这将显示 TiUP 的帮助菜单，列出可用的子命令，如 playground（创建本地测试集群）、install（安装组件）等。

3. 项目的配置文件介绍

TiUP 的配置文件通常位于 etc 目录下，但是默认情况下没有特定的用户配置文件。大多数配置可以通过命令行参数或环境变量来设定。例如，你可以使用 --mirror 参数指定镜像源，或者通过设置 TIUP_MIRROR 环境变量来改变默认的下载地址。

如果你需要自定义 TiUP 的行为，可以创建一个名为 .tiuprc 的文件放在你的家目录下（通常是 $HOME/.tiuprc），然后在这个文件中添加特定的配置选项。具体的选项可以通过 tiup help config 查看。

请注意，这只是一个基础教程，详细的使用指南和配置选项可以从 TiUP 的官方文档中获取：https://docs.pingcap.com/tidb/stable/tiup-manual-zh#%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6

完成以上步骤后，你应该对 TiUP 的基本结构和操作有了初步了解。接下来，可以尝试安装 TiDB 组件并管理你的集群了。如有任何疑问，查阅官方文档或社区资源会有更多帮助。