spec.storage field of the SunkCluster resource. You define a home directory and any additional mounts by path and size, and the operator creates the underlying storage and mounts it on every login and compute node. This page shows how to size the home directory, add extra mounts, and change storage after the cluster is running.
This is the SUNK-managed storage path. To mount PVCs that you manage yourself, see Share storage across Slurm nodes on SUNK Standard. For the full storage configuration reference, including field definitions, see the SunkCluster reference.
How managed storage works
Each entry inspec.storage becomes one shared volume that the operator provisions as a ReadWriteMany PVC and mounts at the path you specify. Because the volumes are ReadWriteMany, every login and compute node in the cluster mounts the same storage at the same path, so a file written from one node is visible on all of them.
Data persists across pod restarts and node replacement. The operator never deletes a managed volume: the PVCs remain in the namespace after you delete the SunkCluster or remove a mount from spec.storage, so you can recover or share the data afterward. For how to find and delete retained volumes, see Delete retained volumes.
Size the home directory
Thespec.storage.homeDir field sets the shared home directory. If you omit it, the cluster provisions a 2Ti volume mounted at /mnt/home. To use a different size or path, set the field explicitly:
homeDir, both path and size are required. The size is a Kubernetes quantity, such as 2Ti or 500Gi.
Add additional mounts
Usespec.storage.additionalMounts to provision shared storage beyond the home directory, such as a volume for datasets or job output. Each entry is a path and a size:
ReadWriteMany volume available at its path on every node. Mount paths must be unique within the cluster.
Change storage after creation
To change storage on a running cluster, editspec.storage and reapply the SunkCluster. The operator reconciles the difference. The following table summarizes what each kind of change does.
Because the operator names each volume after the cluster and the path, adding a removed path back to
spec.storage mounts the retained volume again. The same applies when you create a new SunkCluster with the same name in the same namespace.
Delete retained volumes
A retained volume still counts against the CKS cluster’s Distributed File Storage quota until you delete it. The operator doesn’t delete it for you. To list the managed volumes for a cluster, including retained ones, replace[CLUSTER-NAME] with the name of the SunkCluster. These commands use tenant-slurm, the namespace the Cloud Console uses; replace it if your SunkCluster is in a different namespace:
spec.storage. Kubernetes keeps it in Terminating while the nodes mount it. Once they release it, the operator creates a new, empty volume at the same path.
Next steps
SunkClusterreference for theStorageConfigandVolumeSpecfield definitions.- Share storage across Slurm nodes on SUNK Standard to mount PVCs you provision yourself.
- Create a SUNK Self-Service cluster for the full cluster creation flow.