Last modified June 28, 2017

Using Persistent Volumes on AWS

If your cluster is running in the cloud on Amazon Web Services (AWS), it comes with a dynamic storage provisioner for Elastic Block Storage (EBS). This enables you to store data beyond the lifetime of a Pod.

Storage Classes

Your Kubernetes cluster will have a default Storage Class gp2 deployed, which will automatically get selected if you do not specify the Storage Class in your Persistent Volumes.

As a Cluster Admin you can create additional Storage Classes or edit the default class to use different types of EBS or for example add encryption.

For this you just need to create (or edit) Storage Class objects.

Creating Persistent Volumes

The most straight forward way to create a Persistent Volume is to create a Persistent Volume Claim object, which will automatically create a corresponding Persistent Volume (PV) for you.

Alternatively, to be able to set more specific parameters on your PV you can first create a Persistent Volume objectand then claim that PV using a Persistent Volume Claim (PVC).

Under the hood, the Dynamic Storage Provisioner will take care that a corresponding EBS Volume with the correct parameters is created.

The EBS Volume and its data will persist as long as the corresponding PV resource exists. Deleting the resource will also delete the corresponding EBS volume, which means that all stored data will be lost at that point.

Using Persistent Volumes in a Pod

Once you have a Persistent Volume Claim you can claim it as a Volume in your Pods.

Note that an EBS Volume can only be used by a single Pod at the same time. Thus, the access mode of your PVC can only be ReadWriteOnce.

Under the hood the EBS Volume stays detached from your nodes as long as it is not claimed by a Pod. As soon as a Pod claims it, it gets attached to the node that holds the Pod.


First we create a PVC:

kind: PersistentVolumeClaim
apiVersion: v1
  name: myclaim
    - ReadWriteOnce
      storage: 6Gi

Note that the Access Mode while being fixed with EBS still needs to be defined as ReadWriteOnce in the manifest.

Further, as we are not defining a Storage Class the Kubernetes cluster will just take the default storage class (here gp2).

Now we can create a Pod that uses our PVC:

kind: Pod
apiVersion: v1
  name: mypod
    - name: myfrontend
      image: nginx
      - mountPath: "/var/www/html"
        name: mypd
    - name: mypd
        claimName: myclaim

Now we have an NGINX Pod which serves the contents of our EBS Volume.

Further Reading