Storage

Aether clusters come with high-performance block storage ready to use. You don’t pre-provision disks — just create a PersistentVolumeClaim and a volume is provisioned on demand.

StorageClasses

Every cluster ships with two StorageClasses:

• Default — dynamically-provisioned block storage. This is the default StorageClass, so a PVC with no storageClassName uses it. Volumes are deleted when their PVC is deleted (Delete reclaim policy).
• Retain variant — the same block storage, but the underlying volume survives PVC deletion (Retain reclaim policy), so your data outlives the claim.

List them on your cluster with:

kubectl get storageclass

Create a PersistentVolumeClaim

To get a volume, create a PVC. With no storageClassName, it uses the default StorageClass:

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: data
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 10Gi

A volume is provisioned automatically and bound to the claim. Mount it in a pod like any other PVC.

To use the retain variant instead, set storageClassName to the retain StorageClass’s name (visible in kubectl get storageclass).

Reclaim behavior

• With the default StorageClass, deleting the PVC deletes the volume and its data. Use this for caches and other ephemeral or reproducible data.
• With the retain StorageClass, deleting the PVC leaves the volume in place. Use this for data you can’t afford to lose to an accidental claim deletion.

Caution

Volumes are ReadWriteOnce block devices — a volume can be attached to one node at a time. Design your workloads accordingly, or use object storage for shared-access data.

Next steps

• Container registry — push and pull your container images.