From 1bc38165a6c8e04bf34623951ec532872a42ad13 Mon Sep 17 00:00:00 2001 From: hujiatao0 Date: Mon, 8 Dec 2025 11:58:44 +0800 Subject: [PATCH 1/7] add config for graceful shutdown Signed-off-by: hujiatao0 --- tikv-configuration-file.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index 21882da94e5b..a5f1afb5ed5d 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -200,6 +200,12 @@ TiKV 配置文件比命令行参数支持更多的选项。你可以在 [etc/con + 默认值：3s + 最小值：1s +### `graceful-shutdown-timeout` + ++ graceful shutdown的超时时长，达到该时间后未完成转移的leader会跳过转移，节点直接进入停机流程。该值为0s时表示不启用graceful shutdown功能。 ++ 默认值：20s ++ 最小值：0s + ### `concurrent-send-snap-limit` + 同时发送 snapshot 的最大个数。 From 7578892e49f1700bd02873f49554b20c06439223 Mon Sep 17 00:00:00 2001 From: hujiatao0 Date: Wed, 10 Dec 2025 16:23:45 +0800 Subject: [PATCH 2/7] add explain for graceful shutdown Signed-off-by: hujiatao0 --- tikv-configuration-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index a5f1afb5ed5d..e1690751f353 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -202,7 +202,7 @@ TiKV 配置文件比命令行参数支持更多的选项。你可以在 [etc/con ### `graceful-shutdown-timeout` -+ graceful shutdown的超时时长，达到该时间后未完成转移的leader会跳过转移，节点直接进入停机流程。该值为0s时表示不启用graceful shutdown功能。 ++ graceful shutdown的超时时长。当graceful shutdown功能被启用，TIKV节点在收到SIGTERM信号后会先尽可能将leader转移到其他节点再进入停机流程。若达到该超时时间后未完成转移的leader会跳过转移，节点直接进入停机流程。该值为0s时表示不启用graceful shutdown功能。 + 默认值：20s + 最小值：0s From c2f14a0c895e13ac1d0dbab11c8c300f90fd03d0 Mon Sep 17 00:00:00 2001 From: hujiatao <50831728+hujiatao0@users.noreply.github.com> Date: Wed, 10 Dec 2025 16:36:14 +0800 Subject: [PATCH 3/7] Update tikv-configuration-file.md Co-authored-by: Grace Cai --- tikv-configuration-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index e1690751f353..d323eff54f5a 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -200,7 +200,7 @@ TiKV 配置文件比命令行参数支持更多的选项。你可以在 [etc/con + 默认值：3s + 最小值：1s -### `graceful-shutdown-timeout` +### `graceful-shutdown-timeout` 从 v8.5.5 和 v9.0.0 版本开始引入 + graceful shutdown的超时时长。当graceful shutdown功能被启用，TIKV节点在收到SIGTERM信号后会先尽可能将leader转移到其他节点再进入停机流程。若达到该超时时间后未完成转移的leader会跳过转移，节点直接进入停机流程。该值为0s时表示不启用graceful shutdown功能。 + 默认值：20s From 36a4f9fcac599bb5d078466955aaad0c0356a528 Mon Sep 17 00:00:00 2001 From: hujiatao0 Date: Wed, 10 Dec 2025 16:52:50 +0800 Subject: [PATCH 4/7] add space for doc Signed-off-by: hujiatao0 --- tikv-configuration-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index d323eff54f5a..56b6424dab30 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -202,7 +202,7 @@ TiKV 配置文件比命令行参数支持更多的选项。你可以在 [etc/con ### `graceful-shutdown-timeout` 从 v8.5.5 和 v9.0.0 版本开始引入 -+ graceful shutdown的超时时长。当graceful shutdown功能被启用，TIKV节点在收到SIGTERM信号后会先尽可能将leader转移到其他节点再进入停机流程。若达到该超时时间后未完成转移的leader会跳过转移，节点直接进入停机流程。该值为0s时表示不启用graceful shutdown功能。 ++ graceful shutdown 的超时时长。当 graceful shutdown 功能被启用，TIKV 节点在收到 SIGTERM 信号后会先尽可能将 leader 转移到其他节点再进入停机流程。若达到该超时时间后未完成转移的 leader 会跳过转移，节点直接进入停机流程。该值为 0s 时表示不启用 graceful shutdown 功能。 + 默认值：20s + 最小值：0s From 181b7ec7d122db2d006a375c71d61ec6ef7f4127 Mon Sep 17 00:00:00 2001 From: hujiatao <50831728+hujiatao0@users.noreply.github.com> Date: Wed, 10 Dec 2025 18:10:37 +0800 Subject: [PATCH 5/7] Update tikv-configuration-file.md Co-authored-by: Bisheng Huang --- tikv-configuration-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index 56b6424dab30..d1fba3bd243c 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -202,7 +202,7 @@ TiKV 配置文件比命令行参数支持更多的选项。你可以在 [etc/con ### `graceful-shutdown-timeout` 从 v8.5.5 和 v9.0.0 版本开始引入 -+ graceful shutdown 的超时时长。当 graceful shutdown 功能被启用，TIKV 节点在收到 SIGTERM 信号后会先尽可能将 leader 转移到其他节点再进入停机流程。若达到该超时时间后未完成转移的 leader 会跳过转移，节点直接进入停机流程。该值为 0s 时表示不启用 graceful shutdown 功能。 ++ graceful shutdown 的超时时长。当 graceful shutdown 功能被启用，TiKV 节点在收到 SIGTERM 信号后会先尽可能将 leader 转移到其他节点再进入停机流程。若达到该超时时间后未完成转移的 leader 会跳过转移，节点直接进入停机流程。该值为 0s 时表示不启用 graceful shutdown 功能。 + 默认值：20s + 最小值：0s From a5449efb4d8a87d2265fc5ac3599b1cdd37d703e Mon Sep 17 00:00:00 2001 From: hujiatao <50831728+hujiatao0@users.noreply.github.com> Date: Mon, 15 Dec 2025 15:52:26 +0800 Subject: [PATCH 6/7] Update tikv-configuration-file.md Co-authored-by: Grace Cai --- tikv-configuration-file.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index d1fba3bd243c..d92de9c9f1ab 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -202,7 +202,9 @@ TiKV 配置文件比命令行参数支持更多的选项。你可以在 [etc/con ### `graceful-shutdown-timeout` 从 v8.5.5 和 v9.0.0 版本开始引入 -+ graceful shutdown 的超时时长。当 graceful shutdown 功能被启用，TiKV 节点在收到 SIGTERM 信号后会先尽可能将 leader 转移到其他节点再进入停机流程。若达到该超时时间后未完成转移的 leader 会跳过转移，节点直接进入停机流程。该值为 0s 时表示不启用 graceful shutdown 功能。 ++ TiKV 优雅关闭 (graceful shutdown) 的超时时长。 + + 当该值大于 `0s` 时，如果关闭 TiKV 节点，TiKV 在该超时时间内会尽量将其上的 leader 副本转移到其他 TiKV 节点，然后再关闭。若达到该超时时间后仍有 leader 未完成转移，TiKV 将跳过剩余 leader 的转移，直接进入关闭流程。 + +当该值为 `0s` 时，表示不启用 TiKV 的 graceful shutdown 功能。 + 默认值：20s + 最小值：0s From d11d7e69cfd77979de35f7c4a1328b9fb9639136 Mon Sep 17 00:00:00 2001 From: hujiatao0 Date: Mon, 15 Dec 2025 15:54:12 +0800 Subject: [PATCH 7/7] add space Signed-off-by: hujiatao0 --- tikv-configuration-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index d92de9c9f1ab..82a87255b15c 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -204,7 +204,7 @@ TiKV 配置文件比命令行参数支持更多的选项。你可以在 [etc/con + TiKV 优雅关闭 (graceful shutdown) 的超时时长。 + 当该值大于 `0s` 时，如果关闭 TiKV 节点，TiKV 在该超时时间内会尽量将其上的 leader 副本转移到其他 TiKV 节点，然后再关闭。若达到该超时时间后仍有 leader 未完成转移，TiKV 将跳过剩余 leader 的转移，直接进入关闭流程。 - +当该值为 `0s` 时，表示不启用 TiKV 的 graceful shutdown 功能。 + + 当该值为 `0s` 时，表示不启用 TiKV 的 graceful shutdown 功能。 + 默认值：20s + 最小值：0s