CCE CSI BOS Plugin Description
Component introduction
The CCE CSI BOS Plugin allows Baidu AI Cloud BOS storage to be mounted in Pods using PV/PVC.
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.
Using Baidu AI Cloud's BOS service, users can create PV and PVC resources in the cluster to mount BOS as persistent volumes directly into containers. This streamlines the process of providing persistent storage solutions for container clusters without delving into underlying implementation details.
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 pane.
- 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 BOS 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. |
| maxVolumesPerNode | Required | Set the maximum number of BOS PVs that can be mounted on each node within the cluster. |
- Click the OK button to complete the component installation.
Deployment status
After installing the CCE CSI BOS Plugin component, the following objects will be deployed in the Kubernetes cluster:
| Object name | Belonging to namespace | Resource usage | Types |
|---|---|---|---|
| csi-bos-external-runner | kube-system | - | ServiceAccount |
| csi-bos-external-runner | kube-system | - | ClusterRole |
| csi-bos-role-binding | kube-system | - | ClusterRoleBinding |
| csi-bos-external-runner-cfg | kube-system | - | Role |
| csi-bos-role-cfg | kube-system | - | RoleBinding |
| csi-bosplugin-node-server-* | kube-system | Unrestricted | DaemonSet |
| csi-bosplugin | kube-system | - | CSIDriver |
| cce-csi-bos-plugin-cce-reserved | kube-system | - | ConfigMap |
Version records
| Version No. | Cluster version compatibility | Update time | Update content | Impact |
|---|---|---|---|---|
| 1.4.3 | CCE/v1.22+ | 2024.02.20 | Fix the issue of NodeName being the host name | - |
| 1.4.2 | CCE/v1.22+ | 2024.01.04 | Optimize the bos csi liveness probe script | - |
| 1.4.1 | CCE/v1.22+ | 2023.09.01 | Support containerd container runtime | - |
| 1.4.0 | CCE/v1.22+ | 2023.06.25 | Add support for CCE Kubernetes 1.22 clusters | - |
| 1.3.0 | CCE/v1.18+ | 2023.08.10 | Support arm64 architecture K8S Cluster CCE | - |
| 1.2.0 | CCE/v1.18+ | 2022.03.25 | Intercept authentication failure errors and optimize error messages | - |
| 1.1.2 | CCE/v1.18+ | 2022.02.10 | Modify the default topologyMode to auto to be compatible with DCC usage scenarios | - |
| 1.1.1 | CCE/v1.18+ | 2021.11.17 | Correct the incorrect volume type | - |
| 1.1.0 | CCE/v1.18+ | 2022.07.06 | Deployment supports setting tolerations | - |
| 1.0.0 | CCE/v1.18+ | 2021.04.04 | Deploy the open-source v1.0.0 CSI driver | - |
| 0.2.2 | CCE/v1.18+ | 2021.02.16 | Support custom images and service endpoints | - |
| 0.2.1 | CCE/v1.18+ | 2020.12.10 | Support clusters with heterogeneous kubelet data directories via node affinity | - |
| 0.2.0 | CCE/v1.18+ | 2020.10.20 | Support installing the plugin in CCE Kubernetes 1.18 clusters | - |
| 0.1.0 | CCE/v1.16+ | 2020.09.01 | Initial version, supporting installing the plugin in CCE Kubernetes 1.16 clusters | - |
