tiup cluster downgrade
命令 tiup cluster downgrade 用于将指定集群降级到特定版本。
语法
tiup cluster downgrade <cluster-name> <version> [flags]<cluster-name>为要操作的集群名字,如果忘记集群名字可通过集群列表查看。<version>为要降级到的目标版本,例如v8.5.3。
限制
- 当前仅支持标准集群降级,不支持 Fusion 或 Ultra 集群。
- 仅支持降级到比当前集群更低的版本,不支持相同版本重放,也不支持升级。
- 目标版本必须与当前版本处于同一 minor 发布线。
- 当前集群 Edition 必须与目标安装包 Edition 一致。
- 只有命中 TiUP 内置降级规则的版本路径才允许执行降级。
选项
--force
- 跳过部分保护性等待,直接继续降级。
- 数据类型:
BOOLEAN - 该选项默认关闭,默认值为
false。在命令中添加该选项,并传入true值或不传值,均可开启此功能。
警告:
强制降级可能导致集群性能抖动或服务不可用,请仅在明确接受风险时使用。
--transfer-timeout(uint,默认 600)
在降级 PD、TiKV 或 TiCDC 时,TiUP 会先尝试迁移 Leader 或 Drain capture。可以通过设置 --transfer-timeout 指定最长等待时间(单位为秒),超时后会跳过等待并继续执行降级。
注意
若出现跳过等待直接降级的情况,服务性能可能会出现抖动。
-h, --help
- 输出帮助信息。
- 数据类型:
BOOLEAN - 该选项默认关闭,默认值为
false。在命令中添加该选项,并传入true值或不传值,均可开启此功能。
输出
降级服务的日志。