How to Set Up RWX Volumes on VKE with Vultr File System

Vultr File System (VFS) introduces the capability to create ReadWriteMany (RWX) persistent volumes within Vultr Kubernetes Engine (VKE) clusters. This functionality allows multiple pods to concurrently access and share the same storage volume, making it ideal for use cases that require shared data, such as content management systems, collaborative applications, and distributed workloads.

Prerequisites

• Vultr Kubernetes Engine (VKE) cluster.
• Vultr Container Storage Interface (CSI) Driver v0.14.0 or higher.
• Kubernetes Config (KUBECONFIG) for cluster management.

Implementation

Vultr File System volumes can be used as Persistent Volumes in Kubernetes using the vultr-vfs-storage storage class.

1. Create a new manifest for PVC resource.

   yaml Copy

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: test-rwx
   spec:
     accessModes:
       - ReadWriteMany
     resources:
       requests:
         storage: 10Gi
     storageClassName: vultr-vfs-storage
   

   In this example, the PVC resource test-rwx is created with a capacity of 10Gi and access mode ReadWriteMany. The storage class vultr-vfs-storage is used to provision the VFS volume.

2. Apply the PVC manifest.

   console Copy

   $ kubectl apply -f pvc.yaml
   

   Output:

   persistentvolumeclaim/test-rwx created

3. List the PVC resource.

   console Copy

   $ kubectl get pvc test-rwx
   

   The PVC resource test-rwx should be listed with the status Bound.

   Output:

   NAME          STATUS   VOLUME                 CAPACITY   ACCESS MODES   STORAGECLASS        VOLUMEATTRIBUTESCLASS   AGE
   test-rwx      Bound    pvc-604cf0c549ad41e3   10Gi       RWX            vultr-vfs-storage   <unset>                 10m

Troubleshooting

If you are unable to reproduce the same behaviour as noted above, you can try troubleshooting to get more information.

• Describe the PVC resource.

  console Copy

  $ kubectl describe pvc test-rwx
  

  You can review the events for any issues related to provisioning of the VFS volume.

• List all storage classes.

  console Copy

  $ kubectl get storageclass
  

  The list must contain vultr-vfs-storage in order to provision a VFS volume.

• Ensure sufficient quota allocation.

• Monitor cluster events for storage issues.

Conclusion

This guide demonstrated how to set up ReadWriteMany (RWX) volumes on Vultr Kubernetes Engine (VKE) using Vultr File System (VFS). This feature allows multiple pods to concurrently access and share the same storage volume, making it ideal for use cases that require shared data.

For more information, refer to the following documentation:

• Vultr Kubernetes Engine (VKE)
• Vultr File System (VFS)