Add the windows graceful node shutdown doc
parent
bbcfe89366
commit
e4bdcbcf5b
|
@ -265,6 +265,28 @@ via the [Non-Graceful Node Shutdown](#non-graceful-node-shutdown) procedure ment
|
|||
{{< /note >}}
|
||||
|
||||
|
||||
## Windows Graceful node shutdown {#windows-graceful-node-shutdown}
|
||||
|
||||
{{< feature-state feature_gate_name="WindowsGracefulNodeShutdown" >}}
|
||||
|
||||
The Windows graceful node shutdown feature depends on kubelet running as a Windows service,
|
||||
it will then have a registered [service control handler](https://learn.microsoft.com/en-us/windows/win32/services/service-control-handler-function)
|
||||
to delay the presshutdown event with a given duration.
|
||||
|
||||
Windows graceful node shutdown is controlled with the `WindowsGracefulNodeShutdown`
|
||||
[feature gate](/docs/reference/command-line-tools-reference/feature-gates/)
|
||||
which is introduced in 1.32 as an alpha feature.
|
||||
|
||||
Windows graceful node shutdown can not be cancelled.
|
||||
|
||||
If Kubelet is not running as a Windows service, it will not be able to set and monitor
|
||||
the [Preshutdown](https://learn.microsoft.com/en-us/windows/win32/api/winsvc/ns-winsvc-service_preshutdown_info) event,
|
||||
the node will have to go through the [Non-Graceful Node Shutdown](#non-graceful-node-shutdown) procedure mentioned above.
|
||||
|
||||
In the case where the Windows graceful node shutdown feature is enabled, but the kubelet is not
|
||||
running as a Windows service, the kubelet will continue running instead of failing. However,
|
||||
it will log an error indicating that it needs to be run as a Windows service.
|
||||
|
||||
## {{% heading "whatsnext" %}}
|
||||
|
||||
Learn more about the following:
|
||||
|
|
|
@ -0,0 +1,18 @@
|
|||
---
|
||||
title: WindowsGracefulNodeShutdown
|
||||
content_type: feature_gate
|
||||
_build:
|
||||
list: never
|
||||
render: false
|
||||
|
||||
stages:
|
||||
- stage: alpha
|
||||
defaultValue: false
|
||||
fromVersion: "1.32"
|
||||
|
||||
---
|
||||
Enables support for windows node graceful shutdown in kubelet.
|
||||
During a system shutdown, kubelet will attempt to detect the shutdown event
|
||||
and gracefully terminate pods running on the node. See
|
||||
[Graceful Node Shutdown](/docs/concepts/architecture/nodes/#graceful-node-shutdown)
|
||||
for more details.
|
Loading…
Reference in New Issue