From 00a526716ef2c3614a7129cd25c30b95e79ad351 Mon Sep 17 00:00:00 2001 From: Bob Furu Date: Wed, 12 Aug 2020 17:29:36 -0400 Subject: [PATCH] BZ1856186 - Add manual reclaim proc --- ...age-persistent-storage-reclaim-manual.adoc | 26 +++++++++++++++++++ storage/understanding-persistent-storage.adoc | 2 ++ 2 files changed, 28 insertions(+) create mode 100644 modules/storage-persistent-storage-reclaim-manual.adoc diff --git a/modules/storage-persistent-storage-reclaim-manual.adoc b/modules/storage-persistent-storage-reclaim-manual.adoc new file mode 100644 index 0000000000..e6c94a049c --- /dev/null +++ b/modules/storage-persistent-storage-reclaim-manual.adoc @@ -0,0 +1,26 @@ +// Module included in the following assemblies: +// +// * storage/understanding-persistent-storage.adoc + +[id="reclaim-manual_{context}"] += Reclaiming a PersistentVolume manually + +When a PersistentVolumeClaim (PVC) is deleted, the PersistentVolume (PV) still exists and is considered "released". However, the PV is not yet available for another claim because the previous claimant's data remains on the volume. + +.Procedure +To manually reclaim the PV as a cluster administrator: + +. Delete the PV. ++ +[source,terminal] +---- +$ oc delete +---- ++ +The associated storage asset in the external infrastructure, such as an AWS EBS, GCE PD, Azure Disk, or Cinder volume, still exists after the PV is deleted. + +. Clean up the data on the associated storage asset. + +. Delete the associated storage asset. Alternately, to reuse the same storage asset, create a new PV with the storage asset definition. + +The reclaimed PV is now available for use by another PVC. diff --git a/storage/understanding-persistent-storage.adoc b/storage/understanding-persistent-storage.adoc index 963d8e1be4..bd6175e2f6 100644 --- a/storage/understanding-persistent-storage.adoc +++ b/storage/understanding-persistent-storage.adoc @@ -8,6 +8,8 @@ include::modules/storage-persistent-storage-overview.adoc[leveloffset=+1] include::modules/storage-persistent-storage-lifecycle.adoc[leveloffset=+1] +include::modules/storage-persistent-storage-reclaim-manual.adoc[leveloffset=+2] + include::modules/storage-persistent-storage-reclaim.adoc[leveloffset=+2] include::modules/storage-persistent-storage-pv.adoc[leveloffset=+1]