CCE CSI PFS Plugin Description
Component introduction
The CCE CSI PFS Plugin enables mounting Baidu AI Cloud PFS storage in Pods using PV/PVC and supports dynamic PV creation.
Component function
Containers, being inherently non-persistent, lose their data when deleted. Persistent volumes (volumes) resolve issues of data sharing and storage persistence for containers. Kubernetes provides PV (PersistentVolume) and PVC (PersistentVolumeClaim) API resources to abstract storage management details.
By utilizing Baidu AI Cloud’s PFS service to create PV and PVC resources within the cluster, users can mount PFS directly as persistent volumes into containers, simplifying the process and providing a more convenient persistent storage solution for container clusters.
Usage restrictions
- Please refer to Usage Limit (Standard, Enhanced and Extreme PFS) for the list of OS and kernel versions supported by PFS.
Install component
- Sign in to the Baidu AI Cloud official website and enter the management console.
- Select Product Tour - Containers - Baidu Container Engine and click to enter the CCE management console.
- Click Cluster Management > Cluster List in the left navigation bar.
- Click on the target cluster name in the Cluster List page to navigate to the cluster management page.
- On the Cluster Management page, click O&M & Management > Component Management.
- In the component management list, select the CCE CSI PFS Plugin component and click Install, then complete the relevant configurations in the pop-up box.
| ConfigMap | Required/Optional | Configuration |
|---|---|---|
| KubeletRootPath | Required | Configure the kubelet data directory on the node to enable the component to register with the node’s kubelet. It is essential to input the correct kubelet data directory, and multiple entries can be specified for matching. |
- Click the OK button to complete the component installation.
Deployment status
Once the CCE CSI PFS Plugin component is installed, the following objects will be deployed in the Kubernetes cluster. Some resource objects may vary based on deployment parameters, but the default component configuration is shown here.
| Object name | Belonging to namespace | Resource usage | Types |
|---|---|---|---|
| csi-clusterfileplugin | kube-system | - | CSIDriver |
| cce-csi-pfs-plugin-account | kube-system | - | ServiceAccount |
| cce-csi-pfs-plugin-runner | kube-system | - | ClusterRoleBinding |
| cce-csi-pfs-plugin-runner | kube-system | - | ClusterRole |
| cce-csi-pfs-plugin-resizer | kube-system | Unrestricted | StatefulSet |
| cce-csi-pfs-plugin-resizer | kube-system | - | Service |
| cce-csi-pfs-plugin-provisioner | kube-system | Unrestricted | StatefulSet |
| cce-csi-pfs-plugin-provisioner | kube-system | - | Service |
| cce-csi-pfs-plugin-nodeplugin-* | kube-system | Unrestricted | DaemonSet |
| cce-csi-pfs-plugin-nodeplugin | kube-system | - | Service |
| cce-csi-pfs-plugin-attacher | kube-system | Unrestricted | StatefulSet |
| cce-csi-pfs-plugin-attacher | kube-system | - | Service |
| cce-csi-pfs-plugin-clean-cce-reserved | kube-system | - | ConfigMap |
Version records
| Version No. | Cluster version compatibility | Update time | Update content | Impact |
|---|---|---|---|---|
| 1.2.7 | CCE/1.18+ | 2024.10.12 | Optimize the csi node plugin | - |
| 1.2.6 | CCE/1.18+ | 2023.11.22 | Optimize permission issues with mounting scripts | - |
| 1.2.5 | CCE/1.18+ | 2023.08.10 | Remove storageClass; K8S clusters support multiple pfs instances | - |
| 1.2.4 | CCE/1.18+ | 2023.07.11 | Upgrade the PFS client version to 7.0.0 and remove the cluster parameter | - |
| 1.2.3 | CCE/1.18+ | 2022.04.14 | Upgrade the PFS client version to 6.8.1 | - |
| 1.2.2 | CCE/1.18+ | 2022.06.28 | Be compatible with the new version of the PFS kernel module | - |
| 1.2.1 | CCE/1.18+ | 2023.01.04 | Support upgrading the cluster Kubernetes version from 1.20 to 1.22 | - |
| 1.2.0 | CCE/1.18+ | 2022.12.13 | Optimize the format of the pfs.configEndpoint parameter to adapt to higher-version clusters |
- |
| 1.1.0 | CCE/1.18+ | 2022.03.08 | Upgrade the PFS client version | - |
| 1.0.0 | CCE/1.18+ | 2022.01.13 | Release version | - |
