tiup cluster patch

tiup cluster patch

在集群运行过程中，如果需要动态替换某个服务的二进制文件（即替换过程中保持集群可用），那么可以使用 tiup cluster patch 命令，它会完成以下几件事情：

将用于替换的二进制包上传到目标机器
如果目标服务是 TiKV、TiFlash 或者 TiDB Binlog 之类的存储服务，则先通过 API 下线节点
停止目标服务
解压二进制包，替换服务
启动目标服务

语法

1. tiup cluster patch <cluster-name> <package-path> [flags]

<cluster-name> 代表要操作的集群名
<package-path> 为用于替换的二进制包路径

准备二进制包

在运行 tiup cluster patch 命令之前，你需要打包所需的二进制文件。请按照以下步骤操作：

确定以下变量的值：
${component}：需要替换的组件名（例如 tidb、tikv、pd）。
${version}：组件的版本（例如 v7.1.0、v6.5.2）。
${os}：操作系统 (linux)。
${arch}：组件运行的平台 (amd64、arm64)。
下载当前的组件包：

1. wget https://tiup-mirrors.pingcap.com/${component}-${version}-${os}-${arch}.tar.gz -O /tmp/${component}-${version}-${os}-${arch}.tar.gz 3. 创建临时打包目录：

1. mkdir -p /tmp/package && cd /tmp/package 4. 解压原来的二进制包：

1. tar xf /tmp/${component}-${version}-${os}-${arch}.tar.gz 5. 查看临时打包目录中的文件结构：

1. find . 6. 将要替换的二进制文件或配置文件复制到临时目录的对应位置。 7. 将临时目录中的所有文件打包：

1. tar czf /tmp/${component}-hotfix-${os}-${arch}.tar.gz *

完成上述步骤后，你可以在 tiup cluster patch 命令中使用 /tmp/${component}-hotfix-${os}-${arch}.tar.gz 作为 <package-path>。

选项

--overwrite

对某个组件（比如 TiDB，TiKV）进行 patch 后，如果要在该集群扩容该组件，tiup-cluster 会默认使用 patch 前的版本。如果希望后续扩容的时候也使用 patch 之后的版本，需要指定 --overwrite 选项。
数据类型：BOOLEAN
该选项默认关闭，默认值为 false。在命令中添加该选项，并传入 true 值或不传值，均可开启此功能。