Finish the command section

Author: lucklove

tiup/tiup-command-completion.md

@@ -0,0 +1,46 @@
+---
+title: tiup completion
+aliases: ['/docs-cn/dev/tiup/tiup-command-completion/']
+---
+
+# tiup completion
+
+## 介绍
+
+为了记忆命令的心智负担，TiUP 提供了 `tiup completion` 命令用于生成命令行自动补全的配置文件，目前支持 `bash` 和 `zsh` 两种 shell 的命令补全。
+
+如果是 bash，需要提前安装好 bash-completion：
+
+- macOS 的安装方式为：`brew install bash-completion` 或者 `brew install bash-completion@2`（Bash 4.1+）
+- Linux 的安装方式为：使用包管理器安装 `bash-completion` 包
+
+## 语法
+
+```sh
+tiup completion <shell>
+```
+
+`<shell>` 为 shell 类型，目前支持 `bash` 和 `zsh`。
+
+## 使用方式
+
+### bash
+
+将自动补全代码写入一个文件，并且在 .bash_profile 中 source 之：
+
+```sh
+tiup completion bash > ~/.completion.bash.inc
+
+printf "
+# tiup shell completion
+source '$HOME/.completion.bash.inc'
+" >> $HOME/.bash_profile
+
+source $HOME/.bash_profile
+```
+
+### zsh
+
+```sh
+tiup completion zsh > "${fpath[1]}/_tiup"
+```

tiup/tiup-command-env.md

@@ -0,0 +1,29 @@
+---
+title: tiup env
+aliases: ['/docs-cn/dev/tiup/tiup-command-env/']
+---
+
+# tiup env
+
+## 介绍
+
+TiUP 为用户提供了灵活的定制化接口，其中一部分是使用环境变量来实现的，命令 `tiup env` 用于查询 TiUP 支持用户自定义的环境变量以及它们此时的值。
+
+## 语法
+
+```sh
+tiup env [name1...N]
+```
+
+`[name1...N]` 用于查看指定的环境变量，若不指定，则查看所有支持的环境变量。
+
+## 选项
+
+无
+
+## 输出
+
+- 若未指定 `[name1...N]`，则输出 "{key}"="{value}" 列表
+- 若指定了 `[name1...N]`，则按顺序输出 "{value}" 列表
+
+以上输出若 value 为空则代表其未设置，TiUP 会采用默认行为。

tiup/tiup-command-help.md

@@ -0,0 +1,26 @@
+---
+title: tiup help
+aliases: ['/docs-cn/dev/tiup/tiup-command-help/']
+---
+
+# tiup help
+
+## 介绍
+
+TiUP 在命令行界面为用户提供了丰富的帮助信息，这些帮助信息可以通过 `help` 命令或者 `--help` 参数获得，基本上，`tiup help <command>` 等价于 `tiup <command> --help`。
+
+## 语法
+
+```sh
+tiup help [command]
+```
+
+`[command]` 用于指定要查看哪个命令的帮助信息，若不指定，则查看 TiUP 自身的帮助信息。
+
+## 选项
+
+无
+
+## 输出
+
+`[command]` 或 TiUP 的帮助信息。

tiup/tiup-command-mirror-merge.md

@@ -0,0 +1,33 @@
+---
+title: tiup mirror merge
+aliases: ['/docs-cn/dev/tiup/tiup-command-mirror-merge/']
+---
+
+# tiup mirror merge
+
+## 介绍
+
+命令 `tiup mirror merge` 用于合并一个或多个镜像到当前镜像。在合并之前，需要使用命令 [tiup mirror set](/tiup/tiup-command-mirror-set.md) 指定当一个有权限发布组件的前镜像。
+
+执行此命令需要满足几个条件：
+
+- 目标镜像的所有组件的管理员 ID 必须在当前镜像中存在
+- 执行该命令的用户的 `${TIUP_HOME}/keys` 目录中有上述管理员 ID 在当前镜像中对应的所有的私钥
+
+## 语法
+
+```sh
+tiup mirror merge <mirror-dir-1> [mirror-dir-N] [flags]
+```
+
+- `<mirror-dir-1>`：要合并到当前镜像的第一个镜像
+- `[mirror-dir-N]`：要合并到当前镜像的第 N 个镜像
+
+## 选项
+
+无
+
+## 输出
+
+- 成功：无输出
+- 当前镜像缺失目标镜像某个组件的管理员，或 `${TIUP_HOME}/keys` 缺失该管理员的私钥：`Error: missing owner keys for owner %s on component %s`

tiup/tiup-command-mirror.md

@@ -37,4 +37,4 @@ tiup mirror <command> [flags]
 - [modify](/tiup/tiup-command-mirror-modify.md): 修改当前镜像中的组件属性
 - [rotate](/tiup/tiup-command-mirror-rotate.md): 更新当前镜像中的根证书
 - [clone](/tiup/tiup-command-mirror-rotate.md): 从已有镜像克隆一个新的镜像
-- merge: 合并两个或多个镜像
+- [merge](/tiup/tiup-command-mirror-merge.md): 合并镜像

tiup/tiup-command-telemetry.md

@@ -0,0 +1,47 @@
+---
+title: tiup telemetry
+aliases: ['/docs-cn/dev/tiup/tiup-command-telemetry/']
+---
+
+# tiup telemetry
+
+## 介绍
+
+TiDB、TiUP 及 TiDB Dashboard 默认会收集使用情况信息，并将这些信息分享给 PingCAP 用于改善产品，例如，通过这些使用情况信息，PingCAP 可以了解常见的 TiDB 集群操作，从而确定新功能优先级。
+
+当 TiUP 遥测功能开启时，执行 TiUP 命令时将会将使用情况信息分享给 PingCAP，包括（但不限于）：
+
+- 随机生成的遥测标示符
+- TiUP 命令的执行情况，如命令执行是否成功、命令执行耗时等
+- 使用 TiUP 进行部署的情况，如部署的目标机器硬件信息、组件版本号、修改过的部署配置名称等
+
+TiUP 使用命令 `tiup telemetry` 来控制遥测。
+
+## 语法
+
+```sh
+tiup telemetry <command>
+```
+
+`<command>` 代表子命令，支持的子命令列表请参考下方命令一节。
+
+## 命令
+
+### status
+
+命令 `tiup telemetry status` 查看当前的遥测设置，输出以下信息：
+
+- status: 当前是否开启遥测（enable|disable）
+- uuid: 随机生成的遥测标示符
+
+### reset
+
+命令 `tiup telemetry reset` 重置当前的遥测标示符，以一个新的随机标识符代替之。
+
+### enable
+
+命令 `tiup telemetry enable` 启用遥测。
+
+### disable
+
+命令 `tiup telemetry disable` 停用遥测。

tiup/tiup-reference.md

@@ -98,10 +98,10 @@ tiup [flags] <component> [args...]      # 运行组件
 - [status](/tiup/tiup-command-status.md)：查看组件运行状态
 - [clean](/tiup/tiup-command-clean.md)：清理组件数据目录
 - [mirror](/tiup/tiup-command-mirror.md)：镜像管理
-- telemetry：遥测开关
-- completion：TiUP 命令补全
-- env：查看 TiUP 相关环境变量
-- help：查看特定命令或组件的帮助文档
+- [telemetry](/tiup/tiup-command-telemetry.md)：遥测开关
+- [completion](/tiup/tiup-command-completion.md)：TiUP 命令补全
+- [env](/tiup/tiup-command-env.md)：查看 TiUP 相关环境变量
+- [help](/tiup/tiup-command-help.md)：查看特定命令或组件的帮助文档
 
 ## 组件清单