Skip to content

Commit 8c9bf99

Browse files
author
Deepak Kinni
committed
Update docs to specify PV deletion protection finalizer support for only dynamically provisioned volumes
Signed-off-by: Deepak Kinni <[email protected]>
1 parent 2d75bfa commit 8c9bf99

File tree

1 file changed

+20
-12
lines changed

1 file changed

+20
-12
lines changed

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

Lines changed: 20 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -181,26 +181,34 @@ However, the particular path specified in the custom recycler Pod template in th
181181
Finalizers can be added on a PersistentVolume to ensure that PersistentVolumes
182182
having `Delete` reclaim policy are deleted only after the backing storage are deleted.
183183

184+
The newly introduced finalizers `kubernetes.io/pv-controller` and `external-provisioner.volume.kubernetes.io/finalizer`
185+
are only added to dynamically provisioned volumes.
186+
184187
The finalizer `kubernetes.io/pv-controller` is added to in-tree plugin volumes. The following is an example
185188

186189
```shell
187-
kubectl describe pv task-pv-volume
188-
Name: task-pv-volume
189-
Labels: type=local
190-
Annotations: <none>
191-
Finalizers: [kubernetes.io/pv-protection, kubernetes.io/pv-controller]
192-
StorageClass: standard
190+
kubectl describe pv pvc-74a498d6-3929-47e8-8c02-078c1ece4d78
191+
Name: pvc-74a498d6-3929-47e8-8c02-078c1ece4d78
192+
Labels: <none>
193+
Annotations: kubernetes.io/createdby: vsphere-volume-dynamic-provisioner
194+
pv.kubernetes.io/bound-by-controller: yes
195+
pv.kubernetes.io/provisioned-by: kubernetes.io/vsphere-volume
196+
Finalizers: [kubernetes.io/pv-protection kubernetes.io/pv-controller]
197+
StorageClass: vcp-sc
193198
Status: Bound
194-
Claim:
199+
Claim: default/vcp-pvc-1
195200
Reclaim Policy: Delete
196201
Access Modes: RWO
202+
VolumeMode: Filesystem
197203
Capacity: 1Gi
198-
Message:
204+
Node Affinity: <none>
205+
Message:
199206
Source:
200-
Type: HostPath (bare host directory volume)
201-
Path: /tmp/data
202-
HostPathType:
203-
Events: <none>
207+
Type: vSphereVolume (a Persistent Disk resource in vSphere)
208+
VolumePath: [vsanDatastore] d49c4a62-166f-ce12-c464-020077ba5d46/kubernetes-dynamic-pvc-74a498d6-3929-47e8-8c02-078c1ece4d78.vmdk
209+
FSType: ext4
210+
StoragePolicyName: vSAN Default Storage Policy
211+
Events: <none>
204212
```
205213

206214
The finalizer `external-provisioner.volume.kubernetes.io/finalizer` is added for CSI volumes.

0 commit comments

Comments
 (0)