From e9d2a374a2a68e0ac2c923d794bbc18d3bec1f61 Mon Sep 17 00:00:00 2001 From: Qiming Teng Date: Mon, 15 Jan 2018 10:31:10 +0800 Subject: [PATCH] Document the limitation of preStop hook Closes: #6965 --- .../attach-handler-lifecycle-event.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/tasks/configure-pod-container/attach-handler-lifecycle-event.md b/docs/tasks/configure-pod-container/attach-handler-lifecycle-event.md index dfd495e250..4970fe4b04 100644 --- a/docs/tasks/configure-pod-container/attach-handler-lifecycle-event.md +++ b/docs/tasks/configure-pod-container/attach-handler-lifecycle-event.md @@ -74,6 +74,11 @@ Kubernetes' management of the Container blocks until the preStop handler complet unless the Pod's grace period expires. For more details, see [Termination of Pods](/docs/user-guide/pods/#termination-of-pods). +**Note**: Kubernetes only sends the preStop event when a Pod is *terminated*. +This means that the preStop hook is not invoked when the Pod is *completed*. +This limitation is tracked in [issue #55087](https://github.com/kubernetes/kubernetes/issues/55807). +{: .note} + {% endcapture %}