Updated on 2024-06-17 GMT+08:00

Creating a PVC

  • After a PVC is created on the UCS console, a PVC with the same name is automatically created in your cluster. Also a PersistentVolume (PV) is created and bound with the PVC. If you are not familiar with the relationship among PVs, PVCs, and StorageClasses in Kubernetes, see Persistent Storage.
  • You can modify or delete the PVCs automatically created by UCS on the cluster details page. However, if the PVC settings on the UCS console are not modified accordingly, the modified or deleted PVCs will be re-created by UCS. Therefore, you are advised to change the settings on the UCS console, not on the cluster details page.
  • When a non-Huawei Cloud cluster uses a PVC to mount cloud storage, the cluster provider must support StorageClasses to dynamically create PVs. Run the following command to query the StorageClass configuration and the interconnected backend storage resources of the cluster. For more information about StorageClass, see Storage Classes.
    kubectl get storageclass

Creating a PVC

  1. Log in to the UCS console. In the navigation pane, choose Fleets.
  2. On the Fleets tab, click the name of the federation-enabled fleet to access its details page.
  3. Choose Storage in the navigation pane. On the PersistentVolumeClaims (PVCs) tab page, click Create PVC in the upper right corner.
  4. Specify basic information.

    • Name: Enter a unique name of a PVC to be added.
    • Namespace: namespace that the PVC will belong to. If this parameter is not specified, the default namespace is used.
    • Cluster: Click to select the cluster where the PVC is to be deployed.
      Figure 1 Adding a cluster
      • For details about the parameters for adding a Huawei Cloud cluster, see Table 1.
      • For details about the parameters for adding a non-Huawei Cloud cluster, see Table 2.
    Table 1 Adding a Huawei Cloud cluster

    Parameter

    Description

    Cluster

    Select a Huawei Cloud cluster.

    Storage Class

    • csi-disk: EVS disk. Specify the AZ and disk type.
      • AZ: Specify the AZ where the EVS disk is located. The supported EVS disk types may vary in different AZs.
      • EVS Disk Type: Available disk types are common I/O, high I/O, and ultra-high I/O, and the storage pools corresponding to the disk types are SATA, SAS, and SSD.
    • csi-nas: indicates SFS.
    • csi-obs: indicates OBS. You need to specify the instance type and object storage type, and add the access key.
      • Instance Type: an object bucket or a parallel file system. Parallel file system is a high-performance file system provided by OBS. It provides high-performance object-based access.
      • OBS Class: Standard and Infrequent access OBS buckets are supported. OBS Infrequent Access is highly reliable and cost-effective for real-time access. It is ideal for storing data that is semi-frequently accessed (less than 12 times a year). The application scenarios include file synchronization or sharing, and enterprise-level backup.

    Access Mode

    • If csi-disk is selected, Access Mode must be set to ReadWriteOnce, that is, the volume can be mounted as read-write by only a single node.
    • If csi-nas or csi-obs is selected, Access Mode must be set to ReadWriteMany, that is, the volume can be mounted as read-write by multiple nodes.

    Capacity (GiB)

    The capacity of the created PVC cannot be less than 10 GiB.

    Set this parameter only when csi-disk or csi-nas is selected. If csi-obs is selected, the capacity is used on demand and does not need to be set.

    Table 2 Adding a non-Huawei Cloud cluster

    Parameter

    Description

    Cluster

    Select a non-Huawei Cloud cluster.

    Storage Class

    The storage classes supported by a cluster depend on the actual environment of the registered cluster. For details, see Storage Classes.

    Access Mode

    • ReadWriteOnce (RWO): The PVC can be mounted as read-write only by a single node.
    • ReadWriteMany (RWX): The PVC can be mounted as read-write by multiple nodes.

    Capacity (GiB)

    The capacity of the created PVC cannot be less than 10 GiB.

    Annotation

    Set key and value and click Confirm. Annotations are attached to PVCs in the form of key-value pairs.

  5. The key and value can be added repeatedly to configure differentiated settings for each cluster.
  6. Click OK. After the PVC is successfully created, you can click the PVC name to view the details.

Related Operations

You can also perform operations described in Table 3.
Table 3 Related operations

Operation

Description

Creating a PVC from a YAML file

Click Create from YAML in the upper right corner to create a PVC from an existing YAML file.

Viewing details

  1. Select the namespace to which the VPC will belong.
  2. (Optional) Search for a PVC by its name.
  3. Click the PVC name to view its details, including the basic information and deployment information of each cluster.
  4. On the PVC Details page, click View YAML in the Cluster area to view or download YAML files of PVCs deployed in each cluster.

Viewing the YAML file

Click View YAML next to the PVC name to view the YAML file of the current PVC.

Update (Expanding a PVC)

  1. Choose More > Update in the row where the target PVC resides.
  2. Modify the cluster deployment parameters based on the PVC parameters, or click Expand to expand the PVC.
  3. Click OK to submit the modified information.

Deleting a PVC

Choose More > Delete in the row where the target PVC resides, and click Yes.

Deleting PVCs in batches

  1. Select PVCs to be deleted.
  2. Click Delete in the upper left corner.
  3. Click Yes.