diff --git a/content/zh-cn/docs/concepts/cluster-administration/node-shutdown.md b/content/zh-cn/docs/concepts/cluster-administration/node-shutdown.md index fc6c769999f86..506dac69e093c 100644 --- a/content/zh-cn/docs/concepts/cluster-administration/node-shutdown.md +++ b/content/zh-cn/docs/concepts/cluster-administration/node-shutdown.md @@ -505,6 +505,52 @@ via the [Non-Graceful Node Shutdown](#non-graceful-node-shutdown) procedure ment - 偏离上述步骤可能会导致数据损坏。 {{< /note >}} + +{{< feature-state feature_gate_name="WindowsGracefulNodeShutdown" >}} +## Windows节点体面关闭说明 + + +Windows节点体面关闭功能依赖于kubelet作为Windows服务运行。 +在这种情况下, +kubelet会注册一个[Service控制处理器](https://learn.microsoft.com/zh-cn/windows/win32/api/winsvc/ns-winsvc-service_preshutdown_info), +以在发生预关闭事件时延迟关闭操作一段指定时间。 + + +此功能由`WindowsGracefulNodeShutdown`[特性门控](/docs/reference/command-line-tools-reference/feature-gates/)控制, +作为Alpha功能在Kubernetes 1.32中引入。 + + +Windows节点体面关闭过程一旦启动,无法取消。 + + +如果kubelet未作为Windows服务运行, +它将无法设置和监控[预关闭事件(Preshutdown)](https://learn.microsoft.com/zh-cn/windows/win32/api/winsvc/ns-winsvc-service_preshutdown_info)。 +此时,节点将执行[非体面节点关闭](#non-graceful-node-shutdown)流程。 + + +即使启用了Windows节点体面关闭功能,但kubelet未作为Windows服务运行时, +kubelet仍会继续运行,而不会立即失败。然而,它会记录一条错误日志,提示需要将kubelet作为Windows服务运行。 + ## {{% heading "whatsnext" %}}