Container Service for Kubernetes:Use a dynamically provisioned disk volume

ACK console

Step 1: Create a StorageClass

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

2. On the Clusters page, find the cluster that you want to manage and click its name. In the left-side pane, choose Volumes > StorageClasses.

3. In the upper-right corner of the StorageClasses page, click Create.

4. In the Create dialog box, configure the parameters.

   The following table describes the parameters.

   Parameter	Description
   Name	The name of the StorageClass. The name must follow the format requirements displayed in the ACK console.
   PV Type	The type of the persistent volume (PV). Select Cloud Disk.
   Parameter	By default, a type parameter is added and set to cloud_essd. The type parameter specifies the disk category. Valid values of the type parameter: cloud_essd: Enterprise SSD (ESSD). cloud_regional_disk_auto: Regional ESSDs elastic_ephemeral_disk_premium: premium elastic ephemeral disk. elastic_ephemeral_disk_standard: standard elastic ephemeral disk. cloud_ssd: standard SSD. cloud_efficiency: ultra disk. You can set the type parameter to any combination of the preceding values. For example, you can specify type: cloud_ssd,cloud_essd. In this case, the system tries to create a disk in the specified order of the categories. The system stops trying once a disk is created. Note Specific ECS instance types do not support ESSDs or elastic ephemeral disks. For more information, see FAQ about Elastic Block Storage. You can add custom parameters. For example, you can add the zoneId parameter to specify the IDs of the zones in which you want to create disks. If your cluster is deployed in a single zone, set the value to the ID of the zone. Example: cn-beijing-a. If your cluster is deployed across zones, you can set the zoneId parameter to multiple zone IDs based on your business requirements. Example: cn-beijing-a, cn-beijing-b.
   Reclaim Policy	The reclaim policy of the disk. Default value: Delete. You can also set the parameter to Retain. Delete mode: When PVCs are deleted, the related PVs and disks are also deleted. Retain mode: When PVCs are deleted, the related PVs and disks are retained. The PVs and disk data can only be manually deleted. If you require higher data security, we recommend that you use the Retain mode to prevent data from being accidentally deleted.
   Binding Mode	The volume binding mode. Default value: Immediate, which specifies that the system creates a disk before it creates a pod.

5. After you configure the parameters, click Create.

   After the StorageClass is created, you can view the StorageClass on the StorageClasses page.

Step 2: Create a PVC

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

2. In the upper-right corner of the Persistent Volume Claims page, click Create.

3. In the Create PVC dialog box, set the following parameters:

   Parameter	Description
   PVC Type	The type of the PVC. You can set the parameter to Cloud Disk or NAS. In this example, this parameter is set to Cloud Disk.
   Name	The name of the PVC. The name must be unique in the namespace.
   Allocation Mode	In this example, Use StorageClass is selected.
   Existing Storage Class	Click Select. In the Select Storage Class dialog box, find the StorageClass that you want to use and click Select in the Actions column.
   Capacity	The capacity claimed by the PVC.
   Access Mode	The access mode of the PV provisioned by using the PVC. Default value: ReadWriteOnce.

4. Click Create.

   After the PVC is created, you can view the PVC on the Persistent Volume Claims page. The PVC is bound to a PV.

Step 3: Create an application

1. In the left-side navigation pane of the details page, choose Workloads > StatefulSets.

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

3. Configure the application parameters.
   This example shows how to configure the volume parameters. For more information about other parameters, see Use a StatefulSet to create a stateful application.

   You can configure local storage volumes and cloud storage volumes for an ACK cluster. In this example, Cloud Storage is selected.

   Mount the disk volume that is created in this example to the /tmp path of the container. After the disk volume is mounted, the container data that is generated in the /tmp path is stored in the disk volume.
4. Configure other parameters and click Create.
   After the application is created, you can use the volume to store application data.

kubectl

Step 1: Create a StorageClass

In a multi-zone cluster, you can create a StorageClass by first creating a cloud disk and then creating a pod.

1. Use the following template to create a file named storage-class-csi.yaml:

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: alicloud-disk-ssd-b
   provisioner: diskplugin.csi.alibabacloud.com
   parameters:
     type: cloud_essd,cloud_ssd,cloud_efficiency
     encrypted: "false"
   reclaimPolicy: Retain
   allowVolumeExpansion: true
   volumeBindingMode: Immediate

   Parameter	Description
   provisioner	Set the value to diskplugin.csi.alibabacloud.com. This value specifies that the provisioner plug-in for Alibaba Cloud disks is used to create the StorageClass.
   type	This parameter specifies the disk category. Valid values: cloud_auto: ESSD AutoPL disk. cloud_essd: ESSD. This is the default value. cloud_essd_entry: ESSD Entry disk. cloud_ssd: standard SSD. cloud_efficiency: ultra disk. elastic_ephemeral_disk_standard: standard elastic ephemeral disk. elastic_ephemeral_disk_premium: premium elastic ephemeral disk. cloud_regional_disk_auto: Regional ESSDs. You can set this parameter to any combination of the preceding values. For example, you can set this parameter to type: cloud_ssd,cloud_essd,cloud_auto. In this case, the system tries to create a disk in the specified order of the categories. The system stops trying once a disk is created. Important You can specify disk categories based on the zones and instance types of the nodes in your cluster and your requirements for disk billing and performance. For more information, see the following topics: EBS pricing Block storage performance Overview of instance families
   encrypted	Optional. This parameter specifies whether the disk is encrypted. The default value is false, which indicates that the disk is not encrypted.
   reclaimPolicy	The reclaim policy of the disk. By default, this parameter is set to Delete. You can also set this parameter to Retain. Delete mode: When PVCs are deleted, the related PVs and disks are also deleted. Retain mode: When PVCs are deleted, the related PVs and disks are retained. The PVs and disk data can only be manually deleted. If you require high data security, we recommend that you use the Retain mode to prevent data from being accidentally deleted.
   allowVolumeExpansion	If you set this parameter to true, the disk can be automatically expanded.
   volumeBindingMode	The volume binding mode. Default value: Immediate, which specifies that the system creates a disk before it creates a pod.

2. Run the following command to create a StorageClass:

   kubectl apply -f storage-class-csi.yaml

3. View the created StorageClass.

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

   2. On the Clusters page, find the cluster that you want to manage and click its name. In the left-side pane, choose Volumes > StorageClasses.

   3. After the StorageClass is created, you can view the StorageClass on the StorageClasses page.

Step 2: Create a PVC

1. Use the following template to create a file named pvc-ssd.yaml:

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: disk-pvc
   spec:
     accessModes:
     - ReadWriteOnce
     volumeMode: Filesystem
     resources:
       requests:
         storage: 25Gi
     storageClassName: alicloud-disk-ssd-b

   Parameter	Description
   name	The name of the PVC.
   accessModes	The access mode of the PV provisioned by using the PVC.
   volumeMode	Optional. The format in which the disk is mounted. File systems are supported.
   storageClassName	The name of the StorageClass that you want to associate with the PVC.
   storage	The disk size claimed by the PVC. The minimum capacity is 20 GiB.

2. Run the following command to create a PVC:

   kubectl create -f pvc-ssd.yaml

3. View the created PVC.

   In the left-side navigation pane of the cluster details page, choose Volumes > Persistent Volume Claims. You can view the created PVC on the Persistent Volume Claims page.

Step 3: Create an application

1. Create a file named pvc-dynamic.yaml.

   Use the following template to create an application named nginx-dynamic and mount the PVC to the application:

   apiVersion: apps/v1
   kind: StatefulSet
   metadata:
     name: nginx-dynamic
   spec:
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: nginx
           ports:
           - containerPort: 80
             name: web
           volumeMounts:
           - name: pvc-disk
             mountPath: /data
         volumes:
           - name: pvc-disk
             persistentVolumeClaim:
               claimName: disk-pvc

   Parameter	Description
   mountPath	The path to which the disk is mounted.
   claimName	The name of the PVC mounted to the application.

2. Run the following command to deploy the application and mount the PVC to the application:

   kubectl create -f pvc-dynamic.yaml

3. View the deployed application.

   In the left-side navigation pane of the cluster details page, choose Workloads > StatefulSets. You can view the created application on the StatefulSets page.