Skip to main content

​
Persistent Volume Management Operator

CKS features a Persistent Volume Management Operator (PVMO). PVMO is a Kubernetes controller manager that runs periodically to clean up orphaned volumes. PVMO tracks PVC delete events through admission webhooks. If it finds a delete event, it adds the label pv-failsafe.coreweave.cloud/[DELETION-TIMESTAMP] (where [DELETION-TIMESTAMP] is the current time) to the Persistent Volume to which the PVC was attached. PVMO also adds a watcher service that periodically lists all Persistent Volumes in the cluster.
By default, the watcher lists all PVs in the cluster once per hour.
The watcher service checks for any “orphaned” PVs. A PV is considered orphaned if it has been released from its PVC and doesn’t have the soft delete label described earlier. If the watcher finds an orphaned PV, it adds the soft delete label to it. The watcher service also checks Persistent Volumes to see if they’re eligible for deletion. To be eligible, a PV must have the soft delete label and must have exceeded the soft delete window.
The default soft delete window for PVs is 24 hours.
If both conditions are met, PVMO updates the reclaim policy on the PV from Retain to Delete. This update prompts CKS to reclaim the PV and delete all its underlying volumes. For more information about creating a Distributed File Storage volume, see Create Distributed File Storage volumes.
Last modified on May 29, 2026