From 4e7be4020b81be4fbd9be635f72121da117cf224 Mon Sep 17 00:00:00 2001 From: houfaxin Date: Tue, 23 Jul 2024 14:27:55 +0800 Subject: [PATCH 01/14] Create roll-back-a-tidb-cluster.md --- zh/roll-back-a-tidb-cluster.md | 84 ++++++++++++++++++++++++++++++++++ 1 file changed, 84 insertions(+) create mode 100644 zh/roll-back-a-tidb-cluster.md diff --git a/zh/roll-back-a-tidb-cluster.md b/zh/roll-back-a-tidb-cluster.md new file mode 100644 index 000000000..3c95510af --- /dev/null +++ b/zh/roll-back-a-tidb-cluster.md @@ -0,0 +1,84 @@ +--- +title: h Ku回退bernetes 上的 TiDB 集群 +summary: 介绍如何回退 Kubernetes 上的 TiDB 集群。 +--- + +# 回退 Kubernetes 上的 TiDB 集群 + +如果你使用 TiDB Operator 部署管理 Kubernetes 上的 TiDB 集群，可以通过回退 TiDB 集群到指定补丁版本，减少新版本对业务的影响。本文介绍如何回退 Kubernetes 上的 TiDB 集群。 + +在回退 Kubernetes 上的 TiDB 集群的时候，TiDB Operator 会串行地删除各个组件当前版本的 Pod，并创建指定版本的 Pod。当指定版本的 Pod 正常运行后，再处理下一个 Pod。 + +滚动回退时，TiDB Operator 会自动处理 PD 和 TiKV 的 Leader 迁移。因此，在多节点的部署拓扑下（最小环境：PD * 3、TiKV * 3、TiDB * 2），滚动回退 TiKV、PD 不会影响业务正常运行。对于有连接重试功能的客户端，滚动回退 TiDB 同样不会影响业务。 + +## 支持回退的版本 + +本文档适用于以下回退路径： + +- 使用 TiDB 从 v7.5.Y 版本回退至 v7.5.X，其中 Y 和 X 是大于 0 的整数，且 Y>X。 + +其他补丁版本的回退未经验证，如直接回退，可能会产生非预期的问题。 + +## 注意事项 + +回退版本时，请注意以下事项： + +- 对于无法进行连接重试的客户端，版本回退会导致连接到被关闭的 TiDB 节点的数据库的连接失效，造成部分业务请求失败。对于这类业务，推荐在客户端添加重试功能，或者在低峰期进行 TiDB 的滚动更新操作。 +- 在回退 TiDB 集群的过程中，请勿执行 DDL 语句，否则可能会出现行为未定义的问题。 +- 回退的集群内的各组件应该使用相同版本。 +- Changefeed 默认配置值在回退过程中不会被更改，已经修改的值，在回退过程中也不会被修改。 + +## 回退前的准备工作 + +### 查阅兼容性变更 + +- TiDB 目前仅支持有限的补丁版本回退。请参见[支持回退的版本](#支持回退的版本)。 + +- 查看对应版本的 [Release Notes](releases/release-notes.md) 中的兼容性变更。如果有任何变更影响到回退，请采取相应的措施。例如，从 TiDB v7.5.2 回退至 v7.5.1 时，需查阅以下各版本的兼容性变更： + + - [TiDB v7.5.1 Release Notes](https://docs.pingcap.com/zh/tidb/dev/release-7.5.1#兼容性变更) 中的兼容性变更 + - [TiDB v7.5.2 Release Notes](https://docs.pingcap.com/zh/tidb/dev/release-7.5.2#兼容性变更) 中的兼容性变更 + +### 检查当前集群的 DDL + +集群中有 DDL 语句正在被执行时，请勿进行版本回退操作。被执行的 DDL 语句通常为 [`ADD INDEX`](sql-statements/sql-statement-add-index.md) 和列类型变更等耗时较久的 DDL 语句。 + +在回退前，为避免回退过程中出现未定义行为或其他故障，建议执行下列操作： + +1. 使用 [`ADMIN SHOW DDL`](sql-statements/sql-statement-admin-show-ddl.md) 命令查看集群中是否有正在进行的 DDL Job。 + +2. 如需回退，请等待 DDL 执行完成，或使用 [`ADMIN CANCEL DDL`](sql-statements/sql-statement-admin-cancel-ddl.md) 命令取消该 DDL Job。 + +### 检查当前集群的健康状况 + +为避免回退过程中出现未定义行为或其他故障，建议在回退前对使用 `check` 子命令检查集群的 Region 健康状态。 + +```shell +tiup cluster check --cluster +``` + +执行结束后，会输出 `region status` 检查结果。 + +- 如果结果为 `All regions are healthy`，则说明当前集群中所有 Region 均为健康状态，可以继续执行回退。 +- 如果结果为 `Regions are not fully healthy: m miss-peer, n pending-peer`，并提示 `Please fix unhealthy regions before other operations.`，则说明当前集群中有 Region 处在异常状态。此时应先排除相应异常状态，并再次检查结果为 `All regions are healthy` 后再继续回退。 + +## 执行回退操作 + +1. 通过 TiDB Operator，严格按如下顺序执行回退操作： + + ```shell + pd-ctl pd config set cluster-version "v7.5.0" -u \"pd-1-peer:2379\" + use kubectl edit tc/tc ticdc version to v7.5.0 + use kubectl edit tc/tc tidb version to v7.5.0 + use kubectl edit tc/tc tikv version to v7.5.0 + use kubectl edit tc/tc tiflash version to v7.5.0 + use kubectl edit tc/tc pd version to v7.5.0 + ``` + +2 查看回退进度： + + ```shell + watch kubectl -n ${namespace} get pod -o wide + ``` + +3. 当所有 Pod 都重建完毕进入 `Running` 状态后，回退完成。 From 284cc838c3853a3c3cc771ff9102623c8d7261c2 Mon Sep 17 00:00:00 2001 From: houfaxin Date: Tue, 23 Jul 2024 14:28:28 +0800 Subject: [PATCH 02/14] Update roll-back-a-tidb-cluster.md --- zh/roll-back-a-tidb-cluster.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh/roll-back-a-tidb-cluster.md b/zh/roll-back-a-tidb-cluster.md index 3c95510af..e01b509d7 100644 --- a/zh/roll-back-a-tidb-cluster.md +++ b/zh/roll-back-a-tidb-cluster.md @@ -1,5 +1,5 @@ --- -title: h Ku回退bernetes 上的 TiDB 集群 +title: 回退 Kubernetes 上的 TiDB 集群 summary: 介绍如何回退 Kubernetes 上的 TiDB 集群。 --- From 8d0133f0924abe46048c4b74e4875ddfca0ac194 Mon Sep 17 00:00:00 2001 From: houfaxin Date: Tue, 23 Jul 2024 14:29:53 +0800 Subject: [PATCH 03/14] Update TOC.md --- zh/TOC.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/zh/TOC.md b/zh/TOC.md index abdbf852d..a6ffb04ee 100644 --- a/zh/TOC.md +++ b/zh/TOC.md @@ -51,10 +51,11 @@ - [更新和替换 TLS 证书](renew-tls-certificate.md) - [以非 root 用户运行](containers-run-as-non-root-user.md) - [扩缩容](scale-a-tidb-cluster.md) - - 升级 + - 升级与回退 - [升级 TiDB 集群](upgrade-a-tidb-cluster.md) - 升级 TiDB Operator - [常规升级](upgrade-tidb-operator.md) + - [回退 TiDB 集群](roll-back-a-tidb-cluster.md) - [灰度升级](canary-upgrade-tidb-operator.md) - 备份与恢复 - [备份与恢复简介](backup-restore-overview.md) From ddc3b13f482736ebb30fb09c7c2695cf24f4421a Mon Sep 17 00:00:00 2001 From: houfaxin Date: Tue, 23 Jul 2024 14:38:26 +0800 Subject: [PATCH 04/14] Update roll-back-a-tidb-cluster.md --- zh/roll-back-a-tidb-cluster.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/zh/roll-back-a-tidb-cluster.md b/zh/roll-back-a-tidb-cluster.md index e01b509d7..cb63ecebe 100644 --- a/zh/roll-back-a-tidb-cluster.md +++ b/zh/roll-back-a-tidb-cluster.md @@ -34,20 +34,20 @@ summary: 介绍如何回退 Kubernetes 上的 TiDB 集群。 - TiDB 目前仅支持有限的补丁版本回退。请参见[支持回退的版本](#支持回退的版本)。 -- 查看对应版本的 [Release Notes](releases/release-notes.md) 中的兼容性变更。如果有任何变更影响到回退，请采取相应的措施。例如，从 TiDB v7.5.2 回退至 v7.5.1 时，需查阅以下各版本的兼容性变更： +- 查看对应版本的 [Release Notes](https://docs.pingcap.com/zh/tidb/stable/release-notes) 中的兼容性变更。如果有任何变更影响到回退，请采取相应的措施。例如，从 TiDB v7.5.2 回退至 v7.5.1 时，需查阅以下各版本的兼容性变更： - - [TiDB v7.5.1 Release Notes](https://docs.pingcap.com/zh/tidb/dev/release-7.5.1#兼容性变更) 中的兼容性变更 - - [TiDB v7.5.2 Release Notes](https://docs.pingcap.com/zh/tidb/dev/release-7.5.2#兼容性变更) 中的兼容性变更 + - [TiDB v7.5.1 Release Notes](https://docs.pingcap.com/zh/tidb/stable/release-7.5.1#兼容性变更) 中的兼容性变更 + - [TiDB v7.5.2 Release Notes](https://docs.pingcap.com/zh/tidb/stable/release-7.5.2#兼容性变更) 中的兼容性变更 ### 检查当前集群的 DDL -集群中有 DDL 语句正在被执行时，请勿进行版本回退操作。被执行的 DDL 语句通常为 [`ADD INDEX`](sql-statements/sql-statement-add-index.md) 和列类型变更等耗时较久的 DDL 语句。 +集群中有 DDL 语句正在被执行时，请勿进行版本回退操作。被执行的 DDL 语句通常为 [`ADD INDEX`](https://docs.pingcap.com/zh/tidb/stable/sql-statement-add-index) 和列类型变更等耗时较久的 DDL 语句。 在回退前，为避免回退过程中出现未定义行为或其他故障，建议执行下列操作： -1. 使用 [`ADMIN SHOW DDL`](sql-statements/sql-statement-admin-show-ddl.md) 命令查看集群中是否有正在进行的 DDL Job。 +1. 使用 [`ADMIN SHOW DDL`](https://docs.pingcap.com/zh/tidb/stable/sql-statement-admin-show-ddl) 命令查看集群中是否有正在进行的 DDL Job。 -2. 如需回退，请等待 DDL 执行完成，或使用 [`ADMIN CANCEL DDL`](sql-statements/sql-statement-admin-cancel-ddl.md) 命令取消该 DDL Job。 +2. 如需回退，请等待 DDL 执行完成，或使用 [`ADMIN CANCEL DDL`](https://docs.pingcap.com/zh/tidb/stable/sql-statement-admin-cancel-ddl) 命令取消该 DDL Job。 ### 检查当前集群的健康状况 From 47f89169133046ecf6051d599f5f3dac6bd2f5c5 Mon Sep 17 00:00:00 2001 From: houfaxin Date: Tue, 23 Jul 2024 14:45:31 +0800 Subject: [PATCH 05/14] Update roll-back-a-tidb-cluster.md --- zh/roll-back-a-tidb-cluster.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh/roll-back-a-tidb-cluster.md b/zh/roll-back-a-tidb-cluster.md index cb63ecebe..57bf0aae8 100644 --- a/zh/roll-back-a-tidb-cluster.md +++ b/zh/roll-back-a-tidb-cluster.md @@ -9,7 +9,7 @@ summary: 介绍如何回退 Kubernetes 上的 TiDB 集群。 在回退 Kubernetes 上的 TiDB 集群的时候，TiDB Operator 会串行地删除各个组件当前版本的 Pod，并创建指定版本的 Pod。当指定版本的 Pod 正常运行后，再处理下一个 Pod。 -滚动回退时，TiDB Operator 会自动处理 PD 和 TiKV 的 Leader 迁移。因此，在多节点的部署拓扑下（最小环境：PD * 3、TiKV * 3、TiDB * 2），滚动回退 TiKV、PD 不会影响业务正常运行。对于有连接重试功能的客户端，滚动回退 TiDB 同样不会影响业务。 +滚动回退时，TiDB Operator 会自动处理 PD 和 TiKV 的 Leader 迁移。因此，在多节点的部署拓扑下（最小环境要求：3 个 PD、3 个 TiKV、3 个 TiDB），滚动回退 TiKV、PD 不会影响业务正常运行。对于有连接重试功能的客户端，滚动回退 TiDB 同样不会影响业务。 ## 支持回退的版本 @@ -75,7 +75,7 @@ tiup cluster check --cluster use kubectl edit tc/tc pd version to v7.5.0 ``` -2 查看回退进度： +2. 查看回退进度： ```shell watch kubectl -n ${namespace} get pod -o wide From 25a4e718f3402f0089f9487b3d9426e0ec21153a Mon Sep 17 00:00:00 2001 From: houfaxin Date: Tue, 23 Jul 2024 15:32:26 +0800 Subject: [PATCH 06/14] Update roll-back-a-tidb-cluster.md --- zh/roll-back-a-tidb-cluster.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/zh/roll-back-a-tidb-cluster.md b/zh/roll-back-a-tidb-cluster.md index 57bf0aae8..91fb04906 100644 --- a/zh/roll-back-a-tidb-cluster.md +++ b/zh/roll-back-a-tidb-cluster.md @@ -5,9 +5,11 @@ summary: 介绍如何回退 Kubernetes 上的 TiDB 集群。 # 回退 Kubernetes 上的 TiDB 集群 -如果你使用 TiDB Operator 部署管理 Kubernetes 上的 TiDB 集群，可以通过回退 TiDB 集群到指定补丁版本，减少新版本对业务的影响。本文介绍如何回退 Kubernetes 上的 TiDB 集群。 +本文介绍如何回退 Kubernetes 上的 TiDB 集群。 -在回退 Kubernetes 上的 TiDB 集群的时候，TiDB Operator 会串行地删除各个组件当前版本的 Pod，并创建指定版本的 Pod。当指定版本的 Pod 正常运行后，再处理下一个 Pod。 +如果你使用 TiDB Operator 部署管理 Kubernetes 上的 TiDB 集群，可以通过回退 TiDB 集群到指定补丁版本，减少新版本对业务的影响。 + +在回退 Kubernetes 上的 TiDB 集群时，TiDB Operator 会串行地删除各个组件当前版本的 Pod，并创建指定版本的 Pod。当指定版本的 Pod 正常运行后，再处理下一个 Pod。 滚动回退时，TiDB Operator 会自动处理 PD 和 TiKV 的 Leader 迁移。因此，在多节点的部署拓扑下（最小环境要求：3 个 PD、3 个 TiKV、3 个 TiDB），滚动回退 TiKV、PD 不会影响业务正常运行。对于有连接重试功能的客户端，滚动回退 TiDB 同样不会影响业务。 @@ -17,7 +19,9 @@ summary: 介绍如何回退 Kubernetes 上的 TiDB 集群。 - 使用 TiDB 从 v7.5.Y 版本回退至 v7.5.X，其中 Y 和 X 是大于 0 的整数，且 Y>X。 -其他补丁版本的回退未经验证，如直接回退，可能会产生非预期的问题。 +> **警告：** +> +> 其他补丁版本的回退未经验证，如直接回退，可能会产生非预期的问题。 ## 注意事项 From 5bc51f7bac186f40d101b31d58526977f8d9709d Mon Sep 17 00:00:00 2001 From: houfaxin Date: Tue, 23 Jul 2024 15:53:15 +0800 Subject: [PATCH 07/14] Update TOC.md --- zh/TOC.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh/TOC.md b/zh/TOC.md index a6ffb04ee..42dfdee8f 100644 --- a/zh/TOC.md +++ b/zh/TOC.md @@ -53,9 +53,9 @@ - [扩缩容](scale-a-tidb-cluster.md) - 升级与回退 - [升级 TiDB 集群](upgrade-a-tidb-cluster.md) + - [回退 TiDB 集群](roll-back-a-tidb-cluster.md) - 升级 TiDB Operator - [常规升级](upgrade-tidb-operator.md) - - [回退 TiDB 集群](roll-back-a-tidb-cluster.md) - [灰度升级](canary-upgrade-tidb-operator.md) - 备份与恢复 - [备份与恢复简介](backup-restore-overview.md) From 4bd7e80ccde574d21c6f70079f89b68b8c47ad93 Mon Sep 17 00:00:00 2001 From: houfaxin Date: Tue, 23 Jul 2024 16:30:51 +0800 Subject: [PATCH 08/14] =?UTF-8?q?delete=20=E6=A3=80=E6=9F=A5=E5=BD=93?= =?UTF-8?q?=E5=89=8D=E9=9B=86=E7=BE=A4=E7=8A=B6=E5=86=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh/roll-back-a-tidb-cluster.md | 13 ------------- 1 file changed, 13 deletions(-) diff --git a/zh/roll-back-a-tidb-cluster.md b/zh/roll-back-a-tidb-cluster.md index 91fb04906..83cc0e97a 100644 --- a/zh/roll-back-a-tidb-cluster.md +++ b/zh/roll-back-a-tidb-cluster.md @@ -53,19 +53,6 @@ summary: 介绍如何回退 Kubernetes 上的 TiDB 集群。 2. 如需回退，请等待 DDL 执行完成，或使用 [`ADMIN CANCEL DDL`](https://docs.pingcap.com/zh/tidb/stable/sql-statement-admin-cancel-ddl) 命令取消该 DDL Job。 -### 检查当前集群的健康状况 - -为避免回退过程中出现未定义行为或其他故障，建议在回退前对使用 `check` 子命令检查集群的 Region 健康状态。 - -```shell -tiup cluster check --cluster -``` - -执行结束后，会输出 `region status` 检查结果。 - -- 如果结果为 `All regions are healthy`，则说明当前集群中所有 Region 均为健康状态，可以继续执行回退。 -- 如果结果为 `Regions are not fully healthy: m miss-peer, n pending-peer`，并提示 `Please fix unhealthy regions before other operations.`，则说明当前集群中有 Region 处在异常状态。此时应先排除相应异常状态，并再次检查结果为 `All regions are healthy` 后再继续回退。 - ## 执行回退操作 1. 通过 TiDB Operator，严格按如下顺序执行回退操作： From 975ce2f5935f703c275745043cab7eabf307dd69 Mon Sep 17 00:00:00 2001 From: xixirangrang Date: Tue, 23 Jul 2024 16:31:38 +0800 Subject: [PATCH 09/14] Apply suggestions from code review Co-authored-by: Frank945946 <108602632+Frank945946@users.noreply.github.com> --- zh/roll-back-a-tidb-cluster.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh/roll-back-a-tidb-cluster.md b/zh/roll-back-a-tidb-cluster.md index 83cc0e97a..7f9c8bb31 100644 --- a/zh/roll-back-a-tidb-cluster.md +++ b/zh/roll-back-a-tidb-cluster.md @@ -17,7 +17,7 @@ summary: 介绍如何回退 Kubernetes 上的 TiDB 集群。 本文档适用于以下回退路径： -- 使用 TiDB 从 v7.5.Y 版本回退至 v7.5.X，其中 Y 和 X 是大于 0 的整数，且 Y>X。 +- 使用 TiDB 从 v7.5.Y 版本回退至 v7.5.X，其中 Y > 0, X ≥ 0, 且 Y > X。 > **警告：** > @@ -55,7 +55,7 @@ summary: 介绍如何回退 Kubernetes 上的 TiDB 集群。 ## 执行回退操作 -1. 通过 TiDB Operator，严格按如下顺序执行回退操作： +1. 以 v7.5.1 通过 TiDB Operator 回退到 v7.5.0 版本为例，请严格按如下顺序执行回退操作： ```shell pd-ctl pd config set cluster-version "v7.5.0" -u \"pd-1-peer:2379\" From 05fd554081ba8b8d7f9a2170b88737c86502f024 Mon Sep 17 00:00:00 2001 From: xixirangrang Date: Tue, 23 Jul 2024 16:38:56 +0800 Subject: [PATCH 10/14] Apply suggestions from code review --- zh/roll-back-a-tidb-cluster.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh/roll-back-a-tidb-cluster.md b/zh/roll-back-a-tidb-cluster.md index 7f9c8bb31..01cbdac69 100644 --- a/zh/roll-back-a-tidb-cluster.md +++ b/zh/roll-back-a-tidb-cluster.md @@ -55,7 +55,7 @@ summary: 介绍如何回退 Kubernetes 上的 TiDB 集群。 ## 执行回退操作 -1. 以 v7.5.1 通过 TiDB Operator 回退到 v7.5.0 版本为例，请严格按如下顺序执行回退操作： +1. 以使用 TiDB Operator 从 v7.5.1 回退到 v7.5.0 版本为例，请严格按如下顺序执行回退操作： ```shell pd-ctl pd config set cluster-version "v7.5.0" -u \"pd-1-peer:2379\" From 5a534f33928e499bacc55449d4db4f1df729200d Mon Sep 17 00:00:00 2001 From: xixirangrang Date: Tue, 23 Jul 2024 16:55:11 +0800 Subject: [PATCH 11/14] Update zh/roll-back-a-tidb-cluster.md Co-authored-by: Frank945946 <108602632+Frank945946@users.noreply.github.com> --- zh/roll-back-a-tidb-cluster.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh/roll-back-a-tidb-cluster.md b/zh/roll-back-a-tidb-cluster.md index 01cbdac69..2dfebb098 100644 --- a/zh/roll-back-a-tidb-cluster.md +++ b/zh/roll-back-a-tidb-cluster.md @@ -37,7 +37,7 @@ summary: 介绍如何回退 Kubernetes 上的 TiDB 集群。 ### 查阅兼容性变更 - TiDB 目前仅支持有限的补丁版本回退。请参见[支持回退的版本](#支持回退的版本)。 - +- 仅支持 PD、TiDB、TiKV、TiFlash、TiCDC、BR、PITR 这些组件的补丁版本回退。 - 查看对应版本的 [Release Notes](https://docs.pingcap.com/zh/tidb/stable/release-notes) 中的兼容性变更。如果有任何变更影响到回退，请采取相应的措施。例如，从 TiDB v7.5.2 回退至 v7.5.1 时，需查阅以下各版本的兼容性变更： - [TiDB v7.5.1 Release Notes](https://docs.pingcap.com/zh/tidb/stable/release-7.5.1#兼容性变更) 中的兼容性变更 From 0cca279f714be8c3fe9d04b6345e812d6c212b45 Mon Sep 17 00:00:00 2001 From: xixirangrang Date: Tue, 23 Jul 2024 16:55:54 +0800 Subject: [PATCH 12/14] Update zh/roll-back-a-tidb-cluster.md --- zh/roll-back-a-tidb-cluster.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh/roll-back-a-tidb-cluster.md b/zh/roll-back-a-tidb-cluster.md index 2dfebb098..7611e63e9 100644 --- a/zh/roll-back-a-tidb-cluster.md +++ b/zh/roll-back-a-tidb-cluster.md @@ -37,7 +37,7 @@ summary: 介绍如何回退 Kubernetes 上的 TiDB 集群。 ### 查阅兼容性变更 - TiDB 目前仅支持有限的补丁版本回退。请参见[支持回退的版本](#支持回退的版本)。 -- 仅支持 PD、TiDB、TiKV、TiFlash、TiCDC、BR、PITR 这些组件的补丁版本回退。 +- 仅支持 PD、TiDB、TiKV、TiFlash、TiCDC、BR、PITR 组件的补丁版本回退。 - 查看对应版本的 [Release Notes](https://docs.pingcap.com/zh/tidb/stable/release-notes) 中的兼容性变更。如果有任何变更影响到回退，请采取相应的措施。例如，从 TiDB v7.5.2 回退至 v7.5.1 时，需查阅以下各版本的兼容性变更： - [TiDB v7.5.1 Release Notes](https://docs.pingcap.com/zh/tidb/stable/release-7.5.1#兼容性变更) 中的兼容性变更 From 9fef20c321e73ab38ea5212201caca8eb5426376 Mon Sep 17 00:00:00 2001 From: houfaxin Date: Wed, 24 Jul 2024 11:22:40 +0800 Subject: [PATCH 13/14] Update roll-back-a-tidb-cluster.md --- zh/roll-back-a-tidb-cluster.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/zh/roll-back-a-tidb-cluster.md b/zh/roll-back-a-tidb-cluster.md index 7611e63e9..3f8db4ce4 100644 --- a/zh/roll-back-a-tidb-cluster.md +++ b/zh/roll-back-a-tidb-cluster.md @@ -32,7 +32,9 @@ summary: 介绍如何回退 Kubernetes 上的 TiDB 集群。 - 回退的集群内的各组件应该使用相同版本。 - Changefeed 默认配置值在回退过程中不会被更改，已经修改的值，在回退过程中也不会被修改。 -## 回退前的准备工作 +## 准备工作 + +回退版本前需要检查兼容性变更、检查当前集群的 DDL。 ### 查阅兼容性变更 From e2e2b782baccbfe7c5295afaae337536925c42e7 Mon Sep 17 00:00:00 2001 From: xixirangrang Date: Thu, 25 Jul 2024 10:52:07 +0800 Subject: [PATCH 14/14] Update zh/roll-back-a-tidb-cluster.md --- zh/roll-back-a-tidb-cluster.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh/roll-back-a-tidb-cluster.md b/zh/roll-back-a-tidb-cluster.md index 3f8db4ce4..491d4434b 100644 --- a/zh/roll-back-a-tidb-cluster.md +++ b/zh/roll-back-a-tidb-cluster.md @@ -11,7 +11,7 @@ summary: 介绍如何回退 Kubernetes 上的 TiDB 集群。 在回退 Kubernetes 上的 TiDB 集群时，TiDB Operator 会串行地删除各个组件当前版本的 Pod，并创建指定版本的 Pod。当指定版本的 Pod 正常运行后，再处理下一个 Pod。 -滚动回退时，TiDB Operator 会自动处理 PD 和 TiKV 的 Leader 迁移。因此，在多节点的部署拓扑下（最小环境要求：3 个 PD、3 个 TiKV、3 个 TiDB），滚动回退 TiKV、PD 不会影响业务正常运行。对于有连接重试功能的客户端，滚动回退 TiDB 同样不会影响业务。 +滚动回退时，TiDB Operator 会自动处理 PD 和 TiKV 的 Leader 迁移。因此，在多节点的部署拓扑下（最小环境要求：3 个 PD、3 个 TiKV、2 个 TiDB），滚动回退 TiKV、PD 不会影响业务正常运行。对于有连接重试功能的客户端，滚动回退 TiDB 同样不会影响业务。 ## 支持回退的版本