Skip to content

Commit 9ca1bae

Browse files
pospispak82cn
authored andcommitted
Bring StorageObjectInUseProtection feature to GA (kubernetes#8159)
* StorageObjectInUseProtection is GA (kubernetes#8291) * Feature gate: StorageObjectInUseProtection is GA Update feature gate reference for 1.11 * Trivial commit to re-trigger Netlify * Bring StorageObjectInUseProtection feature to GA StorageObjectInUseProtection is Beta in K8s 1.10. It's brought to GA in K8s 1.11. * Fixed typo and added feature state tags.
1 parent d6c76e5 commit 9ca1bae

File tree

4 files changed

+6
-154
lines changed

4 files changed

+6
-154
lines changed

content/en/docs/concepts/storage/persistent-volumes.md

+1-2
Original file line numberDiff line numberDiff line change
@@ -70,14 +70,13 @@ Pods use claims as volumes. The cluster inspects the claim to find the bound vol
7070
Once a user has a claim and that claim is bound, the bound PV belongs to the user for as long as they need it. Users schedule Pods and access their claimed PVs by including a `persistentVolumeClaim` in their Pod's volumes block. [See below for syntax details](#claims-as-volumes).
7171

7272
### Storage Object in Use Protection
73-
{{< feature-state for_k8s_version="v1.10" state="beta" >}}
7473
The purpose of the Storage Object in Use Protection feature is to ensure that Persistent Volume Claims (PVCs) in active use by a pod and Persistent Volume (PVs) that are bound to PVCs are not removed from the system as this may result in data loss.
7574

7675
{{< note >}}
7776
**Note:** PVC is in active use by a pod when the pod status is `Pending` and the pod is assigned to a node or the pod status is `Running`.
7877
{{< /note >}}
7978

80-
When the [Storage Object in Use Protection beta feature](/docs/tasks/administer-cluster/storage-object-in-use-protection/) is enabled, if a user deletes a PVC in active use by a pod, the PVC is not removed immediately. PVC removal is postponed until the PVC is no longer actively used by any pods, and also if admin deletes a PV that is bound to a PVC, the PV is not removed immediately. PV removal is postponed until the PV is not bound to a PVC any more.
79+
When the [Storage Object in Use Protection feature](/docs/tasks/administer-cluster/storage-object-in-use-protection/) is enabled, if a user deletes a PVC in active use by a pod, the PVC is not removed immediately. PVC removal is postponed until the PVC is no longer actively used by any pods, and also if admin deletes a PV that is bound to a PVC, the PV is not removed immediately. PV removal is postponed until the PV is not bound to a PVC any more.
8180

8281
You can see that a PVC is protected when the PVC's status is `Terminating` and the `Finalizers` list includes `kubernetes.io/pvc-protection`:
8382

content/en/docs/reference/access-authn-authz/admission-controllers.md

+1-2
Original file line numberDiff line numberDiff line change
@@ -571,8 +571,7 @@ This admission controller will deny any pod that attempts to set certain escalat
571571
This admission controller implements automation for [serviceAccounts](/docs/tasks/configure-pod-container/configure-service-account/).
572572
We strongly recommend using this admission controller if you intend to make use of Kubernetes `ServiceAccount` objects.
573573

574-
### Storage Object in Use Protection (beta)
575-
{{< feature-state for_k8s_version="v1.10" state="beta" >}}
574+
### Storage Object in Use Protection
576575
The `StorageObjectInUseProtection` plugin adds the `kubernetes.io/pvc-protection` or `kubernetes.io/pv-protection` finalizers to newly created Persistent Volume Claims (PVCs) or Persistent Volumes (PV). In case a user deletes a PVC or PV the PVC or PV is not removed until the finalizer is removed from the PVC or PV by PVC or PV Protection Controller. Refer to the [Storage Object in Use Protection](/docs/concepts/storage/persistent-volumes/#storage-object-in-use-protection) for more detailed information.
577576

578577
### ValidatingAdmissionWebhook (alpha in 1.8; beta in 1.9)

content/en/docs/tasks/administer-cluster/pvc-protection.md

-145
This file was deleted.

content/en/docs/tasks/administer-cluster/storage-object-in-use-protection.md

+4-5
Original file line numberDiff line numberDiff line change
@@ -7,15 +7,16 @@ content_template: templates/task
77
---
88

99
{{% capture overview %}}
10-
{{< feature-state for_k8s_version="v1.10" state="beta" >}}
1110

12-
Persistent volume claims (PVCs) that are in active use by a pod and persistent volumes (PVs) that are bound to PVCs can be protected from pre-mature removal.
11+
Persistent volume claims (PVCs) that are in active use by a pod and persistent volumes (PVs) that are bound to PVCs can be protected from premature removal.
1312

1413
{{% /capture %}}
1514

1615
{{% capture prerequisites %}}
1716

18-
- The Storage Object in Use Protection feature is enabled in a version of Kubernetes in which it is supported.
17+
The Storage Object in Use Protection feature is enabled in one of the below Kubernetes versions:
18+
- {% assign for_k8s_version = "1.10" %} {% include feature-state-beta.md %}
19+
- {% assign for_k8s_version = "1.11" %} {% include feature-state-stable.md %}
1920

2021
{{% /capture %}}
2122

@@ -312,5 +313,3 @@ No resources found.
312313

313314

314315
{{% /capture %}}
315-
316-

0 commit comments

Comments
 (0)