From 7f21458e324c5543862372e66e4c5fad320a6a3d Mon Sep 17 00:00:00 2001 From: hujiatao0 Date: Mon, 8 Dec 2025 13:18:24 +0800 Subject: [PATCH 1/3] 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 48c569cdbd4f..42da083ef8cb 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -199,6 +199,12 @@ TiKV 配置文件比命令行参数支持更多的选项。你可以在 [etc/con + 默认值:3s + 最小值:1s +### `graceful-shutdown-timeout` + ++ graceful shutdown的超时时长,达到该时间后未完成转移的leader会跳过转移,节点直接进入停机流程。该值为0s时表示不启用graceful shutdown功能。 ++ 默认值:20s ++ 最小值:0s + ### `concurrent-send-snap-limit` + 同时发送 snapshot 的最大个数。 From 42011f12c607a06e27f5d403b3abc43ca2d2bacc Mon Sep 17 00:00:00 2001 From: hujiatao0 Date: Mon, 15 Dec 2025 17:04:41 +0800 Subject: [PATCH 2/3] some update Signed-off-by: hujiatao0 --- 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 42da083ef8cb..4185eb720878 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -201,7 +201,9 @@ TiKV 配置文件比命令行参数支持更多的选项。你可以在 [etc/con ### `graceful-shutdown-timeout` -+ graceful shutdown的超时时长,达到该时间后未完成转移的leader会跳过转移,节点直接进入停机流程。该值为0s时表示不启用graceful shutdown功能。 ++ TiKV 优雅关闭 (graceful shutdown) 的超时时长。 + + 当该值大于 `0s` 时,如果关闭 TiKV 节点,TiKV 在该超时时间内会尽量将其上的 leader 副本转移到其他 TiKV 节点,然后再关闭。若达到该超时时间后仍有 leader 未完成转移,TiKV 将跳过剩余 leader 的转移,直接进入关闭流程。 + + 当该值为 `0s` 时,表示不启用 TiKV 的 graceful shutdown 功能。 + 默认值:20s + 最小值:0s From 04c2cf0a39f6a86d07c98706582eb3df5a53e488 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Wed, 7 Jan 2026 14:24:15 +0800 Subject: [PATCH 3/3] Update tikv-configuration-file.md --- 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 4185eb720878..18eed1068646 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -199,7 +199,7 @@ TiKV 配置文件比命令行参数支持更多的选项。你可以在 [etc/con + 默认值:3s + 最小值:1s -### `graceful-shutdown-timeout` +### `graceful-shutdown-timeout` 从 v8.5.5 版本开始引入 + TiKV 优雅关闭 (graceful shutdown) 的超时时长。 + 当该值大于 `0s` 时,如果关闭 TiKV 节点,TiKV 在该超时时间内会尽量将其上的 leader 副本转移到其他 TiKV 节点,然后再关闭。若达到该超时时间后仍有 leader 未完成转移,TiKV 将跳过剩余 leader 的转移,直接进入关闭流程。