Skip to content

Commit 7045fc7

Browse files
author
Tim Bannister
committed
Revise explanation for when to use readiness probes
Some cases in the existing text were better served by startup probes. Reword to make the distinction more clear.
1 parent 43f8f63 commit 7045fc7

File tree

1 file changed

+12
-2
lines changed

1 file changed

+12
-2
lines changed

content/en/docs/concepts/workloads/pods/pod-lifecycle.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -304,13 +304,23 @@ specify a readiness probe. In this case, the readiness probe might be the same
304304
as the liveness probe, but the existence of the readiness probe in the spec means
305305
that the Pod will start without receiving any traffic and only start receiving
306306
traffic after the probe starts succeeding.
307-
If your container needs to work on loading large data, configuration files, or
308-
migrations during startup, specify a readiness probe.
309307

310308
If you want your container to be able to take itself down for maintenance, you
311309
can specify a readiness probe that checks an endpoint specific to readiness that
312310
is different from the liveness probe.
313311

312+
If your app has a strict dependency on back-end services, you can implement both
313+
a liveness and a readiness probe. The liveness probe passes when the app itself
314+
is healthy, but the readiness problem additionally checks that each required
315+
back-end service is available. This helps you avoid directing traffic to Pods
316+
that can only respond with error messages.
317+
318+
If your container needs to work on loading large data, configuration files, or
319+
migrations during startup, you can use a
320+
[startup probe](#when-should-you-use-a-startup-probe). However, if you want to
321+
detect the difference between an app that has failed and an app that is still
322+
processing its startup data, you might prefer a readiness probe.
323+
314324
{{< note >}}
315325
If you want to be able to drain requests when the Pod is deleted, you do not
316326
necessarily need a readiness probe; on deletion, the Pod automatically puts itself

0 commit comments

Comments
 (0)