Declaring Storage

Updated at: 2025-11-19 10:18:25

When Activate Virtual Kubernetes Services, the system storage size is provisioned based on the customer's request.
By default, the VKS (Virtual Kubernetes Services) divides system storage into two parts: static storage and dynamic storage, where dynamic storage provides 10 GB by default.
The VKS abstracts away the underlying storage implementation. Users simply declare PVCs as needed and mount them into Container directories.
For more Kubernetes storage concepts, refer to Kubernetes Storage.

tip

All authorized accounts share the same static storage, and static storage can be used to share data across different resource manifests. Dynamic storage is limited to 10 GB and cannot be expanded, so static storage is recommended for most workloads.

Declaring Static Storage PVCs

• When a user creates a namespace, static storage PVCs are automatically created—no manual PVC declaration is required.

  pvc-capacity-userdata: Read/Write (directory and files in the current cluster).

  pvc-capacity-share: Read-Only (all directories and files under the enterprise).

  pvc-capacity-app: Read-Only (directories and files under enabled applications such as Inference or LM Lab).

  Retrieve PVCs:

  kubectl get pvc -n test

  

• If additional storage has already been provisioned

You may contact Customer Support to create a PV, and then declare PVCs using the following template:

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: your-pvc-name
spec:
  volumeName: your-pv-name
  accessModes:
  - ReadWriteMany

tip

When declaring the PVC, replace your-pvc-name and your-pv-name with your actual PV and PVC identifiers.

Declaring Dynamic Storage PVCs

Retrieve available StorageClass:

kubectl get storageClass

Example:

# Dynamic storage PVC declaration for `VKS`
kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: your-pvc-name
  namespace: your-namespace
spec:
  storageClassName: your-storage-class  # Storage class retrieved above
  accessModes:
    - ReadWriteMany
  resources:
    requests:
      storage: 1Gi

Using Storage

Mount the declared PVC to a directory inside the Container.
claimName usage rules: Static storage is accessed through the built-in read/write (for VKS usage) PVC pvc-capacity-userdata, whereas dynamic storage (up to 10 GB) must be used with a user-defined PVC name.

Example:

#Using storage inside a Pod
template:
  metadata:
    labels:
      app: your-label
  spec:
    containers:
      - name: your-container-name
        image: your-image   # Replace with your image name
        command: your-command
        ports:
          - containerPort: your-port-num
        volumeMounts:
          - name: data-volume
            mountPath: /mnt/test  # Directory in container where storage is mounted
    volumes:
      - name: data-volume
        persistentVolumeClaim:
          claimName: pvc-capacity-userdata  # For dynamic storage, use your declared PVC name