Use a statically provisioned disk volume

Limits

• Alibaba Cloud disks cannot be shared. A disk can be mounted to only one pod.
• A disk can be mounted to only a node that is deployed in the same zone as the disk.

Use a statically provisioned disk volume in the ACK console

Step 1: Create a PV.

1. Log on to the ACK console.
2. In the left-side navigation pane of the ACK console, click Clusters.
3. On the Clusters page, find the cluster that you want to manage and click the name of the cluster or click Details in the Actions column. The details page of the cluster appears.
4. In the left-side navigation pane of the details page, choose Volumes > Persistent Volumes.
5. In the upper-right corner of the Persistent Volumes page, click Create.
6. In the Create PV dialog box, set the following parameters.

   Parameter	Description
   PV Type	You can select Cloud Disk, NAS, or OSS. In this example, Cloud Disk is selected.
   Volume Plug-in	You can select Flexvolume or CSI. In this example, CSI is selected.
   Access Mode	By default, this parameter is set to ReadWriteOnce.
   Disk ID	Select a mountable disk that is deployed in the same region and zone as your cluster.
   File System Type	Select the file system of the disk. Valid values: ext4, ext3, xfs, and vfat. Default value: ext4.
   Label	Add labels to the PV.

7. Click Create.

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	You can select Cloud Disk, NAS, or OSS. In this example, Cloud Disk is selected.
   Name	The name of the PVC. The name must be unique in the namespace.
   Allocation Mode	In this example, Existing Volumes is selected. Note If no PV is created, you can set Allocation Mode to Create Volume, and set other parameters to create a PV. For more information, see . For more information, see Create a PV.
   Existing Volumes	Click Select PV. In the dialog box that appears, find the PV that you want to use and click Select in the Actions column.
   Capacity	The capacity claimed by the PVC. Note The capacity claimed by the PVC cannot exceed the capacity of the PV.
   Access Mode	By default, this parameter is set to ReadWriteOnce.

4. Click Create.
   After the PVC is created, you can find the PVC in the list of PVCs. The PVC is bound to the specified PV.

Step 3: Create an application

1. In the left-side navigation pane of the details page, choose Workloads > Deployments.
2. In the upper-right corner of the Deployments page, click Create from Image.
3. Set the parameters that are used to create an application.
   This example shows how to set the volume parameters. For more information about other parameters, see Create a stateless application by using a Deployment.

   You can add local volumes and cloud volumes.

   • Add Local Storage: You can select HostPath, ConfigMap, Secret, or EmptyDir from the PV Type drop-down list. Then, set the Mount Source and Container Path parameters to mount the volume to a container path. For more information, see Volumes.
   • Add PVC: You can add cloud volumes.

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

Mount a statically provisioned disk volume by using kubectl

Step 1: Create a PV

1. Create a PV by using the following pv-static.yaml file:

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: csi-pv
     labels:
       alicloud-pvname: static-disk-pv
   spec:
     capacity:
       storage: 25Gi
     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-node-zone-id>"

   Parameter	Description
   name	The name of the PV.
   labels	The labels that are added to the PV.
   storage	The available storage of the disk.
   accessModes	The access mode of the PV.
   persistentVolumeReclaimPolicy	The policy for reclaiming the PV.
   driver	The type of driver. This parameter is set to diskplugin.csi.alibabacloud.com. This value indicates that the Alibaba Cloud CSI plug-in is used.
   volumeHandle	The ID of the disk.
   nodeAffinity	Information about the zone to which the PV and PVC belong. You can set this parameter to specify the zone to which the pod that uses the PV and PVC is scheduled.

2. Run the following command to create a PV:

   kubectl create -f pv-static.yaml

   Log on to the ACK console. In the left-side navigation pane, click Clusters. On the Clusters page, find the cluster that you want to manage and click the name of the cluster, or click Details in the Actions column. The details page of the cluster appears. In the left-side navigation pane of the details page, choose Volumes > Persistent Volumes. You can view the created PV on the Persistent Volumes page.

Step 2: Create a PVC

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

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: csi-pvc
   spec:
     accessModes:
     - ReadWriteOnce
     resources:
       requests:
         storage: 25Gi
     selector:
       matchLabels:
         alicloud-pvname: static-disk-pv

   Parameter	Description
   name	The name of the PVC.
   accessModes	The access mode of the PVC.
   storage	The capacity claimed by the PVC. The claimed capacity cannot exceed the capacity of the PV.
   matchLabels	The labels that are used to select a PV and bind it to the PVC. The labels must be the same as those of the PV.

2. Run the following command to create a PVC:

   kubectl create -f pvc-static.yaml

   In the left-side navigation pane, choose Volumes > Persistent Volume Claims. On the Persistent Volume Claims page, you can view the created PVC.

Step 3: Create an application

Deploy an application named nginx-static and mount the PVC to the application. In this example, an NGINX application is created.

1. Create an nginx-static.yaml file and copy the following content into the file:

   apiVersion: apps/v1
   kind: StatefulSet
   metadata:
     name: web
   spec:
     selector:
       matchLabels:
         app: nginx
     serviceName: "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: csi-pvc

   • mountPath: the path where the disk is mounted in the container.
   • claimName: the name of the PVC that is mounted to the application.
2. Run the following command to create an application and mount a statically provisioned disk volume by using a PVC:

   kubectl apply -f nginx-static.yaml

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

Verify that the statically provisioned disk can be used to persist data

1. View the pod where the nginx-static application is deployed and files in the disk.
   1. Run the following command to query the names of pods that run the nginx-static application:

      kubectl get pod | grep nginx-static

      Expected output:

      nginx-xxxxxx 1/1 Running 0 32s

   2. Run the following command to check whether a new disk is mounted to the /data path:

      kubectl exec nginx-xxxxxx df | grep data

      Expected output:

      /dev/vdf 20511312 45080 20449848 1% /data

   3. Run the following command to query files in the /data path:

      kubectl exec nginx-xxxxxx ls /data

      Expected output:

      lost+found

2. Run the following command to create a file named static in the /data path:

   kubectl exec nginx-xxxxxx touch /data/static

3. Run the following command to query files in the /data path:

    kubectl exec nginx-xxxxxx ls /data

   Expected output:

   staticlost+found

4. Run the following command to delete the nginx-xxxxxx pod:

   kubectl delete pod nginx-xxxxxx

   Expected output:

   pod "nginx-xxxxxx" deleted

5. Verify that the file still exists in the disk after the pod is deleted.
   1. Run the following command to query the name of the recreated pod:

      kubectl get pod

      Expected output:

      NAME READY STATUS RESTARTS AGEnginx-xxxxxx 1/1 Running 0 14s

   2. Run the following command to query files in the /data path:

      kubectl exec nginx-xxxxxx ls /data

      Expected output:

      nginx-staticlost+found

      The static file still exists in the disk. This indicates that data is persisted to the statically provisioned disk.