Issue with k8s.io/docs/tasks/configure-pod-container/configure-liveness-readiness-probes/

[bgauduch]

This is a...

• Feature Request
• Bug Report

Problem:
In the chapter define-readiness-probes, the given example is misleading : people could understand that the readiness is only used when a container start and not for the rest of its life cycle (see issue 11018 for instance, happened to me as well).

Proposed Solution:
It would be nice to improve the explanation by stating more clearly that the readiness probe is effectively used during all the container life cycle.

For instance, something like: "Readiness probe are run on the container during all its life cycle to determine if the parent pod is ready to receive traffic or not."
Before : "A pod with containers reporting that they are not ready does not receive traffic through Kubernetes Services"

Maybe add some more exemple, like an app in a container depending on an external service (DB, Storage, ...) to illustrate the need of the readiness probe in a different scenario than startup.
For example, if the DB goes wild (network temporary issue/latency for instance), the readiness probe could detect that and allow the service to prevent traffic from hitting the related pod until things go back to normal.

Page to Update:
https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-probes/#define-readiness-probes

[bgauduch]

Created PR regarding this issue : PR 11613