Skip to content

Commit

Permalink
Update of the docs for Beta
Browse files Browse the repository at this point in the history
  • Loading branch information
mimowo committed Nov 2, 2022
1 parent d09f2c2 commit f693866
Show file tree
Hide file tree
Showing 4 changed files with 8 additions and 9 deletions.
4 changes: 2 additions & 2 deletions content/en/docs/concepts/workloads/controllers/job.md
Original file line number Diff line number Diff line change
Expand Up @@ -697,13 +697,13 @@ mismatch.

### Pod failure policy {#pod-failure-policy}

{{< feature-state for_k8s_version="v1.25" state="alpha" >}}
{{< feature-state for_k8s_version="v1.26" state="beta" >}}

{{< note >}}
You can only configure a Pod failure policy for a Job if you have the
`JobPodFailurePolicy` [feature gate](/docs/reference/command-line-tools-reference/feature-gates/)
enabled in your cluster. Additionally, it is recommended
to enable the `PodDisruptionsCondition` feature gate in order to be able to detect and handle
to enable the `PodDisruptionConditions` feature gate in order to be able to detect and handle
Pod disruption conditions in the Pod failure policy (see also:
[Pod disruption conditions](/docs/concepts/workloads/pods/disruptions#pod-disruption-conditions)). Both feature gates are
available in Kubernetes v1.25.
Expand Down
5 changes: 4 additions & 1 deletion content/en/docs/concepts/workloads/pods/disruptions.md
Original file line number Diff line number Diff line change
Expand Up @@ -232,7 +232,7 @@ can happen, according to:
{{< feature-state for_k8s_version="v1.25" state="alpha" >}}

{{< note >}}
In order to use this behavior, you must enable the `PodDisruptionsCondition`
In order to use this behavior, you must enable the `PodDisruptionConditions`
[feature gate](/docs/reference/command-line-tools-reference/feature-gates/)
in your cluster.
{{< /note >}}
Expand All @@ -254,6 +254,9 @@ indicates one of the following reasons for the Pod termination:
`DeletionByPodGC`
: Pod, that is bound to a no longer existing Node, is due to be deleted by [Pod garbage collection](/docs/concepts/workloads/pods/pod-lifecycle/#pod-garbage-collection).

`TerminationByKubelet`
: Pod is being terminated by Kubelet (either due to {{<glossary_tooltip term_id="node-pressure-eviction" text="Node Pressure Eviction">}} or [Graceful Node Shutdown](/docs/concepts/architecture/nodes/#graceful-node-shutdown)) and is due to be deleted by the controller owning the Pod.

{{< note >}}
A Pod disruption might be interrupted. The control plane might re-attempt to
continue the disruption of the same Pod, but it is not guaranteed. As a result,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -396,6 +396,7 @@ different Kubernetes components.
| `Initializers` | `false` | Alpha | 1.7 | 1.13 |
| `Initializers` | - | Deprecated | 1.14 | - |
| `JobPodFailurePolicy` | `false` | Alpha | 1.25 | - |
| `JobPodFailurePolicy` | `true` | Beta | 1.26 | - |
| `KubeletConfigFile` | `false` | Alpha | 1.8 | 1.9 |
| `KubeletConfigFile` | - | Deprecated | 1.10 | - |
| `KubeletPluginsWatcher` | `false` | Alpha | 1.11 | 1.11 |
Expand Down Expand Up @@ -439,6 +440,7 @@ different Kubernetes components.
| `PodDisruptionBudget` | `true` | Beta | 1.5 | 1.20 |
| `PodDisruptionBudget` | `true` | GA | 1.21 | - |
| `PodDisruptionConditions` | `false` | Alpha | 1.25 | - |
| `PodDisruptionConditions` | `true` | Beta | 1.26 | - |
| `PodOverhead` | `false` | Alpha | 1.16 | 1.17 |
| `PodOverhead` | `true` | Beta | 1.18 | 1.23 |
| `PodOverhead` | `true` | GA | 1.24 | - |
Expand Down
6 changes: 0 additions & 6 deletions content/en/docs/tasks/job/pod-failure-policy.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,12 +30,6 @@ You should already be familiar with the basic use of [Job](/docs/concepts/worklo

<!-- steps -->

{{< note >}}
As the features are in Alpha, prepare the Kubernetes cluster with the two
[feature gates](/docs/reference/command-line-tools-reference/feature-gates/)
enabled: `JobPodFailurePolicy` and `PodDisruptionsCondition`.
{{< /note >}}

## Using Pod failure policy to avoid unnecessary Pod retries

With the following example, you can learn how to use Pod failure policy to
Expand Down

0 comments on commit f693866

Please sign in to comment.