Skip to content

Add note for setting TiDB configuration parameter during cluster upgr… #2431

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Benjamin2037 wants to merge 3 commits into
base: master
Choose a base branch
from
+2 −0
Open

Add note for setting TiDB configuration parameter during cluster upgr… #2431

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
f7b998f
Add note for setting TiDB configuration parameter during cluster upgr…
Benjamin2037 Jul 31, 2023
74aaca0
Update zh/upgrade-tidb-operator.md
Benjamin2037 Aug 2, 2023
2331a3a
Merge remote-tracking branch 'upstream/master' into pr/2431
qiancai Apr 17, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions zh/upgrade-tidb-operator.md
View file
Open in desktop
Copy link
Copy Markdown
Contributor

@ran-huang ran-huang Jul 31, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

请确认下适用哪些版本

Copy link
Copy Markdown
Author

@Benjamin2037 Benjamin2037 Aug 2, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这个版本对应 tidb 的版本不太清楚所以没填写，应该是一个怎样的对应关系呢？

Copy link
Copy Markdown
Contributor

@ran-huang ran-huang Aug 2, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@csuzhangxc 可以帮忙看下吗

Copy link
Copy Markdown
Member

@csuzhangxc csuzhangxc Aug 2, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

在 Operator 这边这个参数没有特别，不用关心 Operator 的版本。 在哪些 TiDB 版本下需要关心这个参数？

Copy link
Copy Markdown
Author

@Benjamin2037 Benjamin2037 Aug 8, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这个影响的 TiDB 版本在 v3.10.0

Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,8 @@ aliases: ['/docs-cn/tidb-in-kubernetes/dev/upgrade-tidb-operator/']

2. 弃用 Pod `ValidatingWebhook` 和 `MutatingWebhook`。如果使用 v1.2 及更早版本的 TiDB Operator 在集群部署了 Webhook，并启用了 Pod `ValidatingWebhook` 和 `MutatingWebhook`，升级 TiDB Operator 到 v1.3.0-beta.1 及之后版本，Pod `ValidatingWebhook` 和 `MutatingWebhook` 被删除，但这不会对 TiDB 集群管理产生影响，也不会影响正在运行的 TiDB 集群。

3. TiDB 节点的配置参数 [`server-version`](https://docs.pingcap.com/zh/tidb/stable/tidb-configuration-file#server-version) 会被 TiDB 节点用于验证当前 TiDB 的版本。因此在进行 TiDB 集群升级前，请将 `server-version` 的值设置为空或者当前 TiDB 真实的版本值，避免出现非预期行为。
Copy link
Copy Markdown

@github-actions github-actions Bot Apr 17, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

该说明过于简略，建议补充说明为何需要设置 server-version 以及不设置可能导致的具体问题，使读者更清楚其重要性。

Suggested change
3. TiDB 节点的配置参数 [`server-version`](https://docs.pingcap.com/zh/tidb/stable/tidb-configuration-file#server-version) 会被 TiDB 节点用于验证当前 TiDB 的版本。因此在进行 TiDB 集群升级前，请将 `server-version` 的值设置为空或者当前 TiDB 真实的版本值，避免出现非预期行为。
3. TiDB 节点的配置参数 [`server-version`](https://docs.pingcap.com/zh/tidb/stable/tidb-configuration-file#server-version) 会被 TiDB 节点用于验证当前 TiDB 的版本。在进行 TiDB 集群升级前，请将 `server-version` 的值设置为空或者当前 TiDB 真实的版本值。如果该参数值与实际版本不符，可能导致升级过程中出现版本校验失败等非预期行为。


## 在线升级

如果服务器可以访问外网，你可以按照以下步骤在线升级 TiDB Operator：
Expand Down