Container Compute Service:Mount a dynamically provisioned disk volume

Connect to your ACS cluster. For more information, see Obtain the kubeconfig file of a cluster and use kubectl to connect to the cluster and Use kubectl on Cloud Shell to manage ACS clusters.

Create a file named disk-sc.yaml and copy the following template content into the file. Modify the parameters in the template based on your business requirements.

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: alicloud-disk-essd
provisioner: diskplugin.csi.alibabacloud.com
parameters:
  type: cloud_essd
  fstype: ext4
  performanceLevel: PL1
reclaimPolicy: Delete
volumeBindingMode: WaitForFirstConsumer
allowVolumeExpansion: true

The following table describes the parameters.

Create a StorageClass.

kubectl create -f disk-sc.yaml

Check the StorageClass.

kubectl get sc

Expected output:

NAME                             PROVISIONER                       RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
alicloud-disk-essd               diskplugin.csi.alibabacloud.com   Delete          WaitForFirstConsumer   true                   78s
alicloud-disk-topology-alltype   diskplugin.csi.alibabacloud.com   Delete          WaitForFirstConsumer   true                   23d
......

Create a file named disk-pvc.yaml and copy the following content to the file:

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: disk-pvc
spec:
  accessModes:
  - ReadWriteOncePod
  volumeMode: Filesystem
  resources:
    requests:
      storage: 20Gi
  storageClassName: alicloud-disk-essd

The following table describes the parameters.

Create a PVC.

kubectl create -f disk-pvc.yaml

Check the PVC.

kubectl get pvc

The following output shows that no PV is bound to the PVC because the volumeBindingMode parameter is set to WaitForFirstConsumer.

NAME       STATUS    VOLUME   CAPACITY   ACCESS MODES   STORAGECLASS         VOLUMEATTRIBUTESCLASS   AGE
disk-pvc   Pending                                      alicloud-disk-essd   <unset>                 7s

Create a file named disk-test.yaml and copy the following content to the file.

The following code block specifies the configuration of a StatefulSet that provisions one pod. The pod applies for storage resources by using the disk-pvc PVC, which is mounted to the /data path of the pod.

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: registry.cn-hangzhou.aliyuncs.com/acs-sample/nginx:latest
        ports:
        - containerPort: 80
        volumeMounts:
        - name: pvc-disk
          mountPath: /data
      volumes:
        - name: pvc-disk
          persistentVolumeClaim:
            claimName: disk-pvc

Create a StatefulSet and mount a disk to the StatefulSet.

kubectl create -f disk-test.yaml

Check whether the pod provisioned by the StatefulSet is deployed.

kubectl get pod | grep disk-test

The following output shows that one pod is deployed for the StatefulSet.

disk-test-0   1/1     Running   0          52s

Check the PVC.

kubectl get pvc

The following output shows that a PV of the disk type is automatically created and bound to the PVC.

NAME       STATUS   VOLUME                   CAPACITY   ACCESS MODES   STORAGECLASS         VOLUMEATTRIBUTESCLASS   AGE
disk-pvc   Bound    d-uf698s3h14isyj6b****   20Gi       RWOP           alicloud-disk-essd   <unset>                 111s

View files in the mount path to check whether the disk is mounted.

kubectl exec disk-test-0 -- df | grep data

Expected output:

/dev/vdb        20466256      24  20449848   1% /data

Log on to the ACS console.

On the Clusters, click the ID of the cluster to go to the cluster management page.

In the left-side navigation pane of the cluster management page, choose Volumes > StorageClasses.

Create a StorageClass.

1. On the StorageClasses page, click Create.

2. In the Create dialog box, configure the parameters and click Create.

   Parameter	Description	Example
   Name	Enter a custom name for the StorageClass. The name must meet the format requirements displayed in the console.	alicloud-disk-essd
   PV Type	Select Cloud Disk.	Cloud Disk
   Parameter	By default, the type parameter is added. This parameter specifies the disk category. Valid values: cloud_essd_entry: ESSD Entry disk. cloud_auto: ESSD AutoPL disk. cloud_essd: Enterprise SSD (ESSD). This is the default value. cloud_ssd: standard SSD. cloud_efficiency: ultra disk. You can set this parameter to any combination of the preceding values. For example, you can set this parameter to type: cloud_efficiency, cloud_ssd, cloud_essd. In this case, the system tries to create a disk of a specified category in sequence. The system stops trying once a disk is created. Note You can select disk categories based on your requirements for billing and performance. For more information, see Prices of block storage devices and Block storage performance. You can add the following parameters: fstype The file system type of the disk. Default value: ext4. Valid values: ext3, ext4, and xfs. performanceLevel The performance level (PL) of the ESSD. Default value: PL1. Valid values: PL0, PL1, PL2, and PL3. For more information, see ESSDs.	type:cloud_essd
   Reclaim Policy	The reclaim policy of the disk. You must set the value to Delete, which indicates that the PV and disk are automatically deleted when the persistent volume claim (PVC) is deleted.	Delete
   Binding Mode	The binding mode of the disk. You must set the value to WaitForFirstConsumer, which indicates that the binding and provisioning of a PV is delayed until a pod that uses the PVC is created. After the pod is scheduled to a node, a disk is created in the zone where the node is deployed and provisioned as the PV.	WaitForFirstConsumer

In the left-side navigation pane of the cluster management page, choose Volumes > Persistent Volume Claims.

On the Persistent Volume Claims page, click Create.

In the Create PVC dialog box, configure the parameters and click Create.

After you create the PVC, you can view the PVC on the Persistent Volume Claims page. The PVC is in the Pending state and no PV is mounted to the PVC because the WaitForFirstConsumer binding mode is specified in the StorageClass associated with the PVC.

In the left-side navigation pane of the cluster management page, choose Workloads > StatefulSets.

In the upper-right corner of the StatefulSets page, click Create from Image.

Configure the parameters of the StatefulSet and click Create.

The following table describes some of the parameters. Use the default values for other parameters. For more information, see Use a StatefulSet to create a stateful application.

Check whether the application is deployed.

1. On the StatefulSets page, click the name of the application you created.

2. On the Pods tab, check whether the pod is in the Running state.

Check the PV and PVC.

• On the Persistent Volumes page, you can view the PV created by the system. The PV is named after the ID of the mounted disk.

• On the Persistent Volume Claims page, you can view that the PVC is in the Bound state and the preceding PV is bound to the PVC.