This document explains how to delete persistent storage for container workloads
in your Google Distributed Cloud (GDC) air-gapped sovereign universe. It's important to
remove persistent storage that is no longer in use to maintain the health and
performance of your environment. Persistent storage is managed as a
PersistentVolumeClaim resource (PVC).
This document is for developers within the application operator group who are responsible for managing application workloads for their organization. For more information, see Audiences for GDC air-gapped documentation.
Before you begin
To complete the tasks in this document, you must request the necessary permissions.
Request IAM roles
You must have specific roles to get the permissions you need to delete a persistent volume. The roles you require depend on whether you are working within an organization-scoped shared cluster or project-scoped standard cluster. For more information, see Kubernetes cluster configurations.
Shared cluster roles
To create, delete, edit, or view persistent volumes in a shared cluster, ask
your Project IAM Admin to grant you the Namespace Admin (namespace-admin)
role. This role is bound to your project namespace.
Standard cluster roles
To create, delete, edit, or view persistent volumes in a standard cluster, ask
your Project IAM Admin to grant you the Cluster Developer
(cluster-developer) role. This role is bound to your project namespace.
Delete a persistent volume
To delete a PVC, complete the following:
List the existing PVCs in your project namespace:
kubectl get pvc -n NAMESPACEReplace
NAMESPACEwith the namespace in your Kubernetes cluster. If your PVC is in a shared cluster, use your project namespace.Note the PVC that you want to delete.
Delete the PVC:
kubectl delete pvc PVC_NAME -n NAMESPACEReplace the following:
PVC_NAME: the name of the PVC to delete.NAMESPACE: the namespace in your Kubernetes cluster. If your PVC is in a shared cluster, use your project namespace.
The output is similar to the following:
persistentvolumeclaim "test-pvc" deleted