Skip to content

Commit 9282372

Browse files
sbernauerJimvin
andauthored
Add a high level description of graceful shutdown (#473)
Co-authored-by: Jim Halfpenny <jim@source321.com>
1 parent e7be753 commit 9282372

File tree

1 file changed

+8
-2
lines changed

1 file changed

+8
-2
lines changed

modules/concepts/pages/operations/graceful_shutdown.adoc

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,16 @@
11
= Graceful shutdown
22

3-
The article https://cloud.google.com/blog/products/containers-kubernetes/kubernetes-best-practices-terminating-with-grace[Kubernetes best practices: terminating with grace] describes how a graceful shutdown works in Kubernetes.
3+
Graceful shutdown refers to the managed, controlled shutdown of service instances in the manner intended by the software authors.
4+
Typically, an instance will receive a signal indicating the intent for the server to shut down, and it will initiate a controlled shutdown.
5+
This could include closing open file handles, updating the instance state in the cluster and emitting a message that the server is closing down.
6+
This contrasts with an uncontrolled shutdown where a process is terminated immediately and is unable to perform any of its normal shutdown activities.
47

5-
Our operators add the needed shutdown mechanism for their products that support graceful shutdown.
8+
In the event that a service instance is unable to shut down in a reasonable amount of time, a timeout is set after which the process will be forcibly terminated to prevent a stuck server from remaining in the shutting down state indefinitely.
9+
The article https://cloud.google.com/blog/products/containers-kubernetes/kubernetes-best-practices-terminating-with-grace[Kubernetes best practices: terminating with grace] describes how a graceful shutdown on Kubernetes works in detail.
610

11+
Our operators add the needed shutdown mechanism for their products that support graceful shutdown.
712
They also configure a sensible amount of time Pods are granted to properly shut down without disrupting the availability of the product.
13+
814
If you are not satisfied with the default values, you can set the graceful shutdown timeout as follows:
915

1016
[source,yaml]

0 commit comments

Comments
 (0)