Container Service for Kubernetes:Use a statically provisioned disk volume

Step 1: create a PV

1. Connect to your cluster. For instructions, see Obtain the kubeconfig file of a cluster and use kubectl to connect to the cluster or Manage Kubernetes clusters via kubectl in Cloud Shell.

2. Create a file named disk-pv.yaml with the following content, replacing the placeholders with your disk's actual values:

   Placeholder	Description	Example
   <YOUR-DISK-ID>	ID of the existing disk	d-uf628m33r5rsbi******
   <YOUR-DISK-SIZE>	Size of the existing disk	20Gi
   <YOUR-DISK-ZONE-ID>	Zone where the disk is located	cn-shanghai-f
   <YOUR-DISK-CATEGORY>	Disk type	cloud_essd

   Supported values for <YOUR-DISK-CATEGORY>:

   Value	Disk type
   cloud_essd_entry	Enterprise SSD (ESSD) Entry
   cloud_auto	ESSD AutoPL
   cloud_essd	ESSD
   cloud_ssd	Standard SSD
   cloud_efficiency	Ultra disk

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: "<YOUR-DISK-ID>"   # e.g. d-uf628m33r5rsbi******
     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>"   # e.g. 20Gi
     claimRef:
       apiVersion: v1
       kind: PersistentVolumeClaim
       namespace: default
       name: disk-pvc
     accessModes:
       - ReadWriteOnce
     persistentVolumeReclaimPolicy: Retain
     csi:
       driver: diskplugin.csi.alibabacloud.com
       volumeHandle: "<YOUR-DISK-ID>"   # e.g. d-uf628m33r5rsbi******
     nodeAffinity:
       required:
         nodeSelectorTerms:
         - matchExpressions:
           - key: topology.diskplugin.csi.alibabacloud.com/zone
             operator: In
             values:
             - "<YOUR-DISK-ZONE-ID>"   # e.g. cn-shanghai-f
     storageClassName: alicloud-disk-topology-alltype
     volumeMode: Filesystem

   Parameters:

   Parameter	Required	Description
   csi.alibabacloud.com/volume-topology	Recommended	Restricts scheduling to nodes that support the disk type. Specify the disk category to avoid mounting failures caused by incompatible node types.
   claimRef	Optional	Binds this PV to a specific PVC. Set this to prevent another PVC from claiming the PV before yours does. Delete this field to allow any PVC to bind.
   accessModes	Required	Must be ReadWriteOnce — the disk can only be mounted to one pod in read-write mode.
   persistentVolumeReclaimPolicy	Required	Retain keeps the disk when the PVC is deleted. Delete removes the PV and disk automatically.
   driver	Required	diskplugin.csi.alibabacloud.com — identifies the Alibaba Cloud CSI plug-in.
   nodeAffinity	Required	Pins pod scheduling to the zone where the disk is located. Disks cannot be mounted across zones.
   storageClassName	Required	Must match the storageClassName in the PVC exactly (including case). For static provisioning, no StorageClass resource needs to exist — this field is used only as a matching label.

3. Create the PV:

   kubectl create -f disk-pv.yaml

4. Verify the PV is available:

   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

The PVC references the PV by name, and the PV references the PVC via claimRef. Both sides of this binding must match to prevent other workloads from claiming the volume.

1. Create a file named disk-pvc.yaml:

   Parameter	Required	Description
   accessModes	Required	Must be ReadWriteOnce.
   storage	Required	The capacity to allocate. Cannot exceed the actual disk size.
   storageClassName	Required	Must match the storageClassName in the PV exactly.
   volumeName	Optional	Binds the PVC to a specific PV by name. Delete this field to allow the system to bind any available PV.

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: disk-pvc
   spec:
     accessModes:
     - ReadWriteOnce
     resources:
       requests:
         storage: "<YOUR-DISK-SIZE>"   # e.g. 20Gi — must not exceed disk capacity
     storageClassName: alicloud-disk-topology-alltype
     volumeName: "<YOUR-DISK-ID>"      # e.g. d-uf628m33r5rsbi****** — must match the PV name

2. Create the PVC:

   kubectl create -f disk-pvc.yaml

3. Verify the PVC is bound:

   kubectl get pvc

   Expected output — the PVC status should be Bound:

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

Step 3: deploy an application with the disk mounted

1. Create a file named disk-test.yaml. The following configuration defines 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. Deploy the StatefulSet:

   kubectl create -f disk-test.yaml

3. Verify 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-side navigation pane, click Clusters.

2. Click the name of your cluster. In the left-side pane, choose Volumes > Persistent Volumes.

3. On the Persistent Volumes page, click Create.

4. Configure the parameters and click Create:

   Parameter	Description	Example
   PV type	Select Cloud Disk.	Cloud Disk
   Access mode	Only ReadWriteOnce is supported.	ReadWriteOnce
   Disk ID	Click Select Disk and choose a disk in the same zone as your node.	d-uf628m33r5rsbi******
   File system type	Select the file system for the disk. Options: ext4, ext3, xfs, vfat. Default: ext4.	ext4

After the PV is created, it appears on the Persistent Volumes page.

Step 2: create a PVC

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

2. Click Create in the upper-right corner.

3. Configure the parameters and click Create:

   Parameter	Description	Example
   PVC type	Select Cloud Disk.	Cloud Disk
   Name	Enter a name for the PVC.	disk-pvc
   Allocation mode	Select Existing Volumes.	Existing Volumes
   Existing storage class	Select the PV created in Step 1.	d-uf628m33r5rsbi****, 20 GiB
   Capacity	Storage capacity to allocate. Cannot exceed the disk size.	20 GiB

After the PVC is created, it appears on the Persistent Volume Claims page with a Bound status, linked to the PV from Step 1.

Step 3: deploy an application with the disk mounted

1. In the left-side pane, choose Workloads > StatefulSets.

2. Click Create from Image in the upper-right corner.

3. Configure the StatefulSet parameters and click Create. The following table covers the volume-related settings — configure other parameters based on your requirements. For details, see Use a StatefulSet to create a stateful application.

   Page	Parameter	Description	Example
   Basic information	Name	Name of the StatefulSet.	disk-test
   Basic information	Replicas	Number of pod replicas.	1
   Container	Image name	Container image address.	anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
   Container	Required resources	CPU, memory, and ephemeral storage.	CPU: 0.25 vCore; Memory: 512 MiB
   Volume	Add PVC	Click Add PVC, then set Mount source to the PVC from Step 2 and Container path to the mount path.	Mount source: disk-pvc; Container path: /data

4. After the StatefulSet is created, click its name on the StatefulSets page and check the Pods tab to confirm the pod is in the Running state.