This example will only work on a cluster with the VolumeAttributesClass feature enabled. For more information see the installation instructions in the EBS CSI ModifyVolume documentation.

1. Deploy the example Pod, PersistentVolumeClaim, and StorageClass to your cluster

   $ kubectl apply -f manifests/pod-with-volume.yaml
   
   storageclass.storage.k8s.io/ebs-sc created
   persistentvolumeclaim/ebs-claim created
   pod/app created

2. Wait for the PersistentVolumeClaim to bind and the pod to reach the Running state

   $ kubectl get pvc ebs-claim
   NAME        STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS   VOLUMEATTRIBUTESCLASS   AGEebs-claim   Bound    pvc-076b2d14-b643-47d4-a2ce-fbf9cd36572b   100Gi      RWO            ebs-sc         <unset>                 2m51s
   
   $ kubectl get pod app
   NAME   READY   STATUS    RESTARTS   AGE
   app    1/1     Running   0          3m24

3. Watch the logs of the pod

   $ kubectl logs -f app
   Mon Feb 26 22:28:19 UTC 2024
   Mon Feb 26 22:28:24 UTC 2024
   Mon Feb 26 22:28:29 UTC 2024
   Mon Feb 26 22:28:34 UTC 2024
   Mon Feb 26 22:28:39 UTC 2024
   ...

4. Deploy the VolumeAttributesClass

   $ kubectl apply -f manifests/volumeattributesclass.yaml

5. Edit the PersistentVolumeClaim to point to this class

   $ kubectl patch pvc ebs-claim --patch '{"spec": {"volumeAttributesClassName": "io2-class"}}'
   persistentvolumeclaim/ebs-claim patched

6. Wait for the VolumeAttributesClass to apply to the volume

   $ kubectl get pvc ebs-claim
   NAME        STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS   VOLUMEATTRIBUTESCLASS   AGE
   ebs-claim   Bound    pvc-076b2d14-b643-47d4-a2ce-fbf9cd36572b   10Gi      RWO            ebs-sc         io2-class               5m54s

7. (Optional) Delete example resources

   $ kubectl delete -f manifests 
   storageclass.storage.k8s.io "ebs-sc" deleted
   persistentvolumeclaim "ebs-claim" deleted
   pod "app" deleted
   volumeattributesclass.storage.k8s.io "io2-class" deleted