tiup: add tiup cluster tls (#20831)

Author: xhebox

TOC.md

@@ -502,6 +502,7 @@
         - [tiup cluster start](/tiup/tiup-component-cluster-start.md)
         - [tiup cluster stop](/tiup/tiup-component-cluster-stop.md)
         - [tiup cluster template](/tiup/tiup-component-cluster-template.md)
+        - [tiup cluster tls](/tiup/tiup-component-cluster-tls.md)
         - [tiup cluster upgrade](/tiup/tiup-component-cluster-upgrade.md)
       - TiUP DM 命令
         - [TiUP DM 命令概览](/tiup/tiup-component-dm.md)

tiup/tiup-cluster-topology-reference.md

@@ -66,6 +66,8 @@ summary: 介绍通过 TiUP 部署或扩容 TiDB 集群时提供的拓扑文件
     - `io_read_bandwidth_max`：读磁盘 I/O 的最大带宽，例如："/dev/disk/by-path/pci-0000:00:1f.2-scsi-0:0:0:0 100M"
     - `io_write_bandwidth_max`：写磁盘 I/O 的最大带宽，例如："/dev/disk/by-path/pci-0000:00:1f.2-scsi-0:0:0:0 100M"
     - `limit_core`：控制 core dump 的大小
+    - `timeout_stop_sec`：控制 systemd 服务停止的超时时间
+    - `timeout_start_sec`：控制 systemd 服务启动的超时时间
 
 `global` 配置示例：
 

tiup/tiup-component-cluster-tls.md

@@ -0,0 +1,49 @@
+---
+title: tiup cluster tls
+summary: tiup cluster tls 命令用于开启、或关闭集群组件之间的 TLS。
+---
+
+# tiup cluster tls
+
+命令 `tiup cluster tls` 用于开启集群组件之间的 TLS (Transport Layer Security)，会自签发证书下发到各个节点。
+
+## 语法
+
+```shell
+tiup cluster tls <cluster-name> <enable/disable> [flags]
+```
+
+`<cluster-name>` 为要启用自启的集群。
+
+## 选项
+
+### --clean-certificate
+
+- 当 TLS 关闭时，指定此选项可清理之前生成的证书。
+- 数据类型：`BOOLEAN`
+- 默认值：`false`
+- 如果不指定该选项，之后开启 TLS 时，可能沿用旧证书。
+
+### --force
+
+- 强制执行开启或关闭 TLS 的流程，不管当前集群是否开启 TLS。
+- 数据类型：`BOOLEAN`
+- 默认值：`false`
+- 如果不指定该选项，开关状态相同时跳过执行。
+
+### --reload-certificate
+
+- 当 TLS 开启时，指定此选项可重新生成证书。
+- 数据类型：`BOOLEAN`
+- 默认值：`false`
+- 如果不指定该选项，已经生成过证书后，不会再生成新证书。
+
+### -h, --help
+
+- 输出帮助信息。
+- 数据类型：`BOOLEAN`
+- 该选项默认关闭，默认值为 `false`。在命令中添加该选项，并传入 `true` 值或不传值，均可开启此功能。
+
+## 输出
+
+tiup-cluster 的执行日志。

tiup/tiup-component-cluster-upgrade.md

@@ -114,6 +114,13 @@ tiup cluster upgrade <cluster-name> <version> [flags]
 - 数据类型：`STRINGS`
 - 不指定该选项时，Node Exporter 的版本与集群版本保持一致。
 
+### --restart-timeout
+
+- 指定滚动升级之间的间隔，即在升级组件后等待一段时间。
+- 数据类型: `STRINGS`。支持所有 [`golang time.ParseDuration`](https://pkg.go.dev/time#ParseDuration) 能够解析的数据类型。
+- 默认值：`0`
+- 不指定该选项时，升级组件后不会等待。
+
 ### -h, --help
 
 - 输出帮助信息。