Skip to main content

Documentation Index

Fetch the complete documentation index at: https://notes.kodekloud.com/llms.txt

Use this file to discover all available pages before exploring further.

Welcome to this comprehensive guide on Persistent Volume Claims (PVCs) in Kubernetes. In this article, you’ll learn how to create PVCs, understand their relationship with Persistent Volumes (PVs), and explore how reclaim policies affect your storage resources. Kubernetes administrators are responsible for creating PVs, while users create PVCs to request and utilize that storage. Once a PVC is defined, Kubernetes automatically binds it to an available PV that meets specific criteria such as capacity, access modes, volume modes, storage class, and additional parameters. Each PVC is exclusively bound to a single PV. If no matching volume exists at the time of creation, the PVC remains in a pending state until a compatible PV becomes available.
When multiple PVs meet the claim criteria, you can leverage labels and selectors to ensure that the correct volume is bound. Even if the claim is smaller than the available PV, any surplus capacity will not be allocated to other claims.
The image illustrates the concept of "Binding" in Kubernetes, showing PV (Persistent Volume) and PVC (Persistent Volume Claim) with conditions like capacity, access, volume modes, and storage class.
When a new volume that satisfies the requirements of a pending PVC becomes available, Kubernetes seamlessly binds the PVC to this volume. This binding process is depicted in the following diagram:
The image illustrates the binding process between Persistent Volumes (PV) and Persistent Volume Claims (PVC) with conditions like capacity, access modes, and storage class.

​
Creating a Persistent Volume Claim

To get started with creating a PVC, you will need to define a YAML configuration. In the example below, the API version is set to v1, the resource kind is PersistentVolumeClaim, and the PVC is named “myclaim”. This claim requests 500Mi of storage with an access mode of ReadWriteOnce. Save the contents below in a file named pvc-definition.yaml: 
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: myclaim
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 500Mi
Once the file is created, deploy the PVC using the following command: 
kubectl create -f pvc-definition.yaml
You can verify the status of your PVC by running: 
kubectl get persistentvolumeclaim
The initial output might resemble: 
NAME      STATUS    VOLUME   CAPACITY   ACCESS MODES
myclaim   Pending
Even if a PVC requests only a portion of the storage available in a PV (e.g., 500Mi out of 1Gi), Kubernetes will bind it to that PV if the access mode and other conditions match.
Here is an example of a PV configuration that could satisfy the above PVC: 
apiVersion: v1
kind: PersistentVolume
metadata:
  name: pv-vol
spec:
  accessModes:
    - ReadWriteOnce
  capacity:
    storage: 1Gi
  awsElasticBlockStore:
    volumeID: <volume-id>
    fsType: ext4
If no matching PV is available when the PVC is created, it will remain in the pending state until a suitable PV is provisioned.

​
Deleting a Persistent Volume Claim and Understanding Reclaim Policies

To delete the PVC, use the following command: 
kubectl delete persistentvolumeclaim myclaim
By default, deleting a PVC does not automatically remove the associated PV. The behavior of the PV is dictated by its reclaim policy. Kubernetes supports three common reclaim policies:
Reclaim PolicyDescriptionYAML Example
RetainThe PV is preserved even after the associated PVC is deleted. Manual cleanup by an administrator is required.persistentVolumeReclaimPolicy: Retain
DeleteThe PV is automatically deleted when the PVC is removed, freeing up the underlying storage.persistentVolumeReclaimPolicy: Delete
RecycleThe PV is cleared of data (scrubbed) and made available for reuse by other PVCs.persistentVolumeReclaimPolicy: Recycle
For instance, executing the deletion command: 
kubectl delete persistentvolumeclaim myclaim
will produce an output similar to: 
persistentvolumeclaim "myclaim" deleted
Choosing the correct reclaim policy is essential for managing your Kubernetes storage lifecycle effectively. It allows you to determine whether the storage resource should persist after the PVC’s deletion or if it should be removed automatically. That concludes our guide on Persistent Volume Claims in Kubernetes. For further insights and detailed documentation on Kubernetes storage practices, please refer to the Kubernetes Documentation.

Watch Video