Container Service for Kubernetes:Use a statically provisioned disk volume

Step 1: Create a PV

Role: cluster administrator

1. Connect to your cluster. Use kubectl or CloudShell and Workbench to connect.

2. Create a file named disk-pv.yaml with the following content, replacing the placeholders with your disk details.

   Placeholder	Description	Example
   <YOUR-DISK-ID>	ID of your existing disk	d-uf628m33r5rsbi******
   <YOUR-DISK-SIZE>	Disk capacity	20Gi
   <YOUR-DISK-ZONE-ID>	Zone where the disk is located	cn-shanghai-f
   <YOUR-DISK-CATEGORY>	Disk type value (see table below)	cloud_essd

   Disk type values for `<YOUR-DISK-CATEGORY>`:

   Disk type	Value
   ESSD Entry disk	cloud_essd_entry
   ESSD AutoPL disk	cloud_auto
   ESSD	cloud_essd
   Standard SSD	cloud_ssd
   Ultra disk	cloud_efficiency
   Zone-redundant disk	cloud_regional_disk_auto (requires different nodeAffinity — see the parameter table below)

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: "<YOUR-DISK-ID>"
     annotations:
       csi.alibabacloud.com/volume-topology: '{"nodeSelectorTerms":[{"matchExpressions":[{"key":"node.csi.alibabacloud.com/disktype.<YOUR-DISK-CATEGORY>","operator":"In","values":["available"]}]}]}'
   spec:
     capacity:
       storage: "<YOUR-DISK-SIZE>"
     claimRef:
       apiVersion: v1
       kind: PersistentVolumeClaim
       namespace: default
       name: disk-pvc
     accessModes:
       - ReadWriteOnce
     persistentVolumeReclaimPolicy: Retain
     csi:
       driver: diskplugin.csi.alibabacloud.com
       volumeHandle: "<YOUR-DISK-ID>"
     nodeAffinity:
       required:
         nodeSelectorTerms:
         - matchExpressions:
           - key: topology.diskplugin.csi.alibabacloud.com/zone
             operator: In
             values:
             - "<YOUR-DISK-ZONE-ID>"
     storageClassName: alicloud-disk-topology-alltype
     volumeMode: Filesystem

   Key parameters:

   Parameter	Required	Default	Description
   csi.alibabacloud.com/volume-topology	Recommended	None	Constrains pod scheduling to nodes that support the specified disk type. Set <YOUR-DISK-CATEGORY> to avoid scheduling failures caused by disk-instance type incompatibility.
   claimRef	Optional	None	Binds this PV to a specific PVC. Remove this block to allow any compatible PVC to bind to this PV.
   accessModes	Required	—	Must be ReadWriteOnce — the volume can be mounted as read-write by a single pod.
   persistentVolumeReclaimPolicy	Required	Retain	Retain: the PV and disk are kept when the PVC is deleted; you must clean up manually. Delete: the PV and disk are deleted when the PVC is deleted.
   driver	Required	—	Always diskplugin.csi.alibabacloud.com for Alibaba Cloud disk volumes.
   nodeAffinity	Required	—	Restricts pod scheduling to the same zone as the disk. For zone-redundant disks, replace this block with a region-level affinity so the disk can be mounted in any zone within the region: topology.kubernetes.io/region: <YOUR-DISK-REGION-ID> (for example, cn-shanghai).
   storageClassName	Required	—	Must match the storageClassName in the PVC exactly. The value alicloud-disk-topology-alltype is used here — you do not need to create this StorageClass in advance for static provisioning.

   Important

   The storageClassName must be identical in both the PV and PVC. A mismatch causes the PVC to remain unbound or bind to a different PV. If your cluster has a default StorageClass, set storageClassName explicitly on both the PV and PVC to prevent the PVC from binding to a dynamically provisioned volume instead of the intended PV.

3. Create the PV.

   kubectl create -f disk-pv.yaml

4. Verify that the PV is in the Available state.

   kubectl get pv

   Expected output:

   NAME                     CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS      CLAIM              STORAGECLASS   VOLUMEATTRIBUTESCLASS   REASON   AGE
   d-uf628m33r5rsbi******   20Gi       RWO            Retain           Available   default/disk-pvc   disk           <unset>                          1m36s

Step 2: Create a PVC

Role: developer

1. Create a file named disk-pvc.yaml with the following content.

   Parameter	Required	Default	Description
   accessModes	Required	—	Must match the PV's accessModes. Only ReadWriteOnce is supported.
   storage	Required	—	Storage capacity to request. Cannot exceed the disk's actual capacity.
   storageClassName	Required	—	Must match the PV's storageClassName exactly — alicloud-disk-topology-alltype in this example.
   volumeName	Recommended	None	Binds this PVC to a specific PV by name. Remove this field to allow the PVC to bind to any compatible PV.

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: disk-pvc
   spec:
     accessModes:
     - ReadWriteOnce
     resources:
       requests:
         storage: "<YOUR-DISK-SIZE>"
     storageClassName: alicloud-disk-topology-alltype
     volumeName: "<YOUR-DISK-ID>"

2. Create the PVC.

   kubectl create -f disk-pvc.yaml

3. Verify that the PVC is bound to the PV.

   kubectl get pvc

   Expected output showing Bound status:

   NAME       STATUS   VOLUME                   CAPACITY   ACCESS MODES   STORAGECLASS   VOLUMEATTRIBUTESCLASS   AGE
   disk-pvc   Bound    d-uf628m33r5rsbi******   20Gi       RWO            disk           <unset>                 64s

Step 3: Deploy a StatefulSet and mount the disk

Role: developer

1. Create a file named disk-test.yaml with the following content. This creates a StatefulSet with one pod that mounts the disk-pvc PVC at /data.

   apiVersion: apps/v1
   kind: StatefulSet
   metadata:
     name: disk-test
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
           ports:
           - containerPort: 80
           volumeMounts:
           - name: pvc-disk
             mountPath: /data
         volumes:
           - name: pvc-disk
             persistentVolumeClaim:
               claimName: disk-pvc

2. Create the StatefulSet.

   kubectl create -f disk-test.yaml

3. Confirm the pod is running.

   kubectl get pod -l app=nginx

   Expected output:

   NAME          READY   STATUS    RESTARTS   AGE
   disk-test-0   1/1     Running   0          14s

4. Verify the disk is mounted at /data.

   kubectl exec disk-test-0 -- df -h /data

   Expected output:

   Filesystem      Size  Used Avail Use% Mounted on
   /dev/vdb         20G   24K   20G   1% /data

Step 1: Create a PV

1. Log on to the ACK console. In the left navigation pane, click Clusters.

2. On the Clusters page, click the cluster name. In the left navigation pane, choose Volumes > Persistent Volumes.

3. On the Persistent Volumes page, click Create.

4. Set the parameters and click Create. After creation, the PV appears on the Persistent Volumes page.

   Parameter	Required	Description	Example
   PV type	Required	Select Cloud Disk.	Cloud Disk
   Access mode	Required	Only ReadWriteOnce is supported.	ReadWriteOnce
   Disk ID	Required	Click Select Disk and select the disk to mount. The disk must be in the same region and zone as the node.	d-uf628m33r5rsbi******
   File system type	Optional	File system used to format the disk. Supported: ext4, ext3, xfs, vfat.	ext4 (default)

Step 2: Create a PVC

1. In the left navigation pane, choose Volumes > Persistent Volume Claims.

2. On the Persistent Volume Claims page, click Create.

3. Set the parameters and click OK. After creation, the PVC appears on the Persistent Volume Claims page with Bound status.

   Parameter	Required	Description	Example
   PVC type	Required	Select Cloud Disk.	Cloud Disk
   Name	Required	Name for the PVC. Follow the format requirements shown in the console.	disk-pvc
   Allocation mode	Required	Select Existing Volumes.	Existing Volumes
   Existing volumes	Required	Select the PV created in step 1.	d-uf690053kttkprgx****, 20Gi
   Capacity	Required	Storage to allocate. Cannot exceed the disk's capacity.	20Gi

Step 3: Deploy a StatefulSet and mount the disk

1. In the left navigation pane, choose Workloads > StatefulSets.

2. In the upper-right corner, click Create from Image.

3. Set the key parameters listed below, then click Create from Image. For all other parameters, see Create a StatefulSet.

   Configuration page	Parameter	Required	Description	Example
   Basic information	Name	Required	Name for the StatefulSet. Follow the format requirements shown in the console.	disk-test
   Basic information	Replicas	Required	Number of pods. Set to 1 for disk volumes without multi-attach.	1
   Container	Image name	Required	Container image address.	anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
   Container	Required resources	Optional	vCPU, memory, and ephemeral storage for the container.	CPU: 0.25 Core; Memory: 512 MiB
   Volume	Add PVC	Required	Click Add PVC, then set Mount Source to the PVC from step 2 and set Container Path to the mount directory.	Mount Source: disk-pvc; Container Path: /data

4. After deployment, click the StatefulSet name and go to the Pods tab to confirm the pod is in the Running state.