You can use csi-plugin to mount and unmount volumes. By default, Container Service for Kubernetes (ACK) allows you to mount the following types of volumes by using csi-plugin: disk volumes, File Storage NAS (NAS) volumes, and Object Storage Service (OSS) volumes. This topic describes the overview, usage notes, and release notes for csi-plugin.
Introduction
The csi-plugin component provided by Alibaba Cloud follows the standard specification of Container Storage Interface (CSI) and allows you to mount storage media such as disks, NAS file systems, and OSS buckets. By default, the latest version of csi-plugin is installed when you create ACK clusters of Kubernetes 1.16 or later. You can directly use csi-plugin to mount storage services provided by Alibaba Cloud after your cluster is created. The csi-plugin component supports volume lifecycle management. You can use csi-plugin to create, mount, unmount, delete, and expand volumes.
Usage notes
For more information about how to use csi-plugin, see Manage the csi-plugin and csi-provisioner components.
To use csi-plugin 1.22.8-8d3a569-aliyun and later versions, make sure that the Kubernetes version of your ACK cluster is later than 1.20.
To ensure the stability of clusters that run Kubernetes 1.20 or later, we recommend that you update csi-plugin in the clusters to 1.24.9-74f8490-aliyun or later.
The csi-plugin component in ACK Edge clusters support only NAS volumes.
When you upgrade csi-plugin, make sure that csi-provisioner is upgraded to the same version.
Release notes
December 2024
Version number | Image address | Release date | Description | Impact |
v1.31.4-9819c8b-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.31.4-9819c8b-aliyun | 2024-12-01 |
| No impact on workloads. Important Only ACK clusters that run Kubernetes 1.26 and later support this version. |
November 2024
Version number | Image address | Release date | Description | Impact |
v1.26.11-b093aed-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.26.11-b093aed-aliyun | 2024-11-01 |
| No impact on workloads. Important This version is a Backport version, which supports only ACK clusters that run Kubernetes whose version is in the range of 1.20 to 1.24. |
October 2024
Version number | Image address | Release date | Description | Impact |
v1.31.3-df937b8-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.31.3-df937b8-aliyun | 2024-10-30 |
| No impact on online services when you Install or upgrade components. Faster disk mounting and unmounting in concurrent scenarios may increase cluster resource usage:
Important Only ACK clusters that run Kubernetes 1.26 and later support this version. |
September 2024
Version number | Image address | Release date | Description | Impact |
v1.31.1-e749bf2-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.31.1-e749bf2-aliyun | 2024-09-23 |
| No impact on workloads. Important Only ACK clusters that run Kubernetes 1.26 and later support this version. |
v1.26.10-ca674a3-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.26.10-ca674a3-aliyun | 2024-09-12 |
| No impact on workloads. Important This version is a Backport version, which supports only ACK clusters that run Kubernetes whose version is in the range of 1.20 to 1.24. |
August 2024
Version number | Image address | Release date | Description | Impact |
v1.30.4-fe12624-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.30.4-fe12624-aliyun | 2024-08-29 |
| This upgrade optimizes the OSS mounting process. For more information, see [Product Changes] ossfs version upgrade and mounting process optimization in CSI. Important Only ACK clusters that run Kubernetes 1.26 and later support this version. |
July 2024
Version number | Image address | Release date | Description | Impact |
v1.30.3-921e63a-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.30.3-921e63a-aliyun | 2024-07-01 |
| No impact on workloads. Important Only ACK clusters that run Kubernetes 1.26 and later support this version. |
v1.26.9-9942088-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.26.9-9942088-aliyun | 2024-07-01 | The mounting retry logic of NAS and CPFS-NFS is optimized. | No impact on workloads. Important This version is a Backport version, which supports only ACK clusters that run Kubernetes whose version is in the range of 1.20 to 1.24. |
May 2024
Version number | Image address | Release date | Description | Impact |
v1.30.1-98960d8-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.30.1-98960d8-aliyun | 2024-05-27 | Feature gates can be configured to specify a new ossfs version. | No impact on workloads. Important Only ACK clusters that run Kubernetes 1.26 and later support this version. |
v1.26.8-e724570-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.26.8-e724570-aliyun | 2024-05-07 |
| No impact on workloads. Important This version is a Backport version, which supports only ACK clusters that run Kubernetes whose version is in the range of 1.20 to 1.24. |
April 2024
Version number | Image address | Release date | Description | Impact |
v1.28.6-01f3845-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.28.6-01f3845-aliyun | 2024-04-15 |
| No impact on workloads. Important Only ACK clusters that run Kubernetes 1.26 and later support this version. |
February 2024
Version number | Image address | Release date | Description | Impact |
v1.28.5-7785921-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.28.5-7785921-aliyun | 2024-02-29 |
| No impact on workloads. Important Only ACK clusters that run Kubernetes 1.26 and later support this version. |
January 2024
Version number | Image address | Release date | Description | Impact |
v1.28.3-eb95171-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.28.3-eb95171-aliyun | 2024-01-31 |
| No impact on workloads. Important Only ACK clusters that run Kubernetes 1.26 and later support this version. |
v1.26.7-84a34bb-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.26.7-84a34bb-aliyun | 2024-01-31 |
| No impact on workloads. Important This version is a Backport version, which supports only ACK clusters that run Kubernetes whose version is in the range of 1.20 to 1.24. |
December 2023
Version number | Image address | Release date | Description | Impact |
v1.28.2-52291d4-aliyun | registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/csi-plugin:v1.28.2-52291d4-aliyun | 2023-12-30 |
| No impact on workloads. The issue that the mount target of an OSS volume is occupied by software such as mlocate is fixed. For more information, see [Component notice] The mount targets of OSS volumes are occupied by default OS software such as mlocate during mount path scanning. Important Only ACK clusters that run Kubernetes 1.26 and later support this version. |
v1.28.1-de1a873-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.28.1-de1a873-aliyun | 2023-12-06 |
| No impact on workloads. Important
|
November 2023
Version number | Image address | Release date | Description | Impact |
v1.26.6-26b1327-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.26.6-26b1327-aliyun | 2023-11-17 | ossfs can be run in pods. | No impact on workloads. Important
|
September 2023
Version number | Image address | Release date | Description | Impact |
v1.26.5-56d1e30-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.26.5-56d1e30-aliyun | 2023-09-30 |
| No impact on workloads. |
August 2023
To update the CSI plug-in to 1.26.4, you must update csi-provisioner and csi-plugin to 1.26.4 at the same time.
Version number | Image address | Release date | Description | Impact |
v1.26.4-e3de357-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.26.4-e3de357-aliyun | 2023-08-31 |
| No impact on workloads. |
v1.26.3-796c9dc-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.26.3-796c9dc-aliyun | 2023-08-14 |
|
July 2023
Version number | Image address | Release date | Description | Impact |
v1.26.2-9d15537-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.26.2-9d15537-aliyun | 2023-07-15 |
| No impact on workloads. |
May 2023
Version number | Image address | Release date | Description | Impact |
v1.26.1-e45b407-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.26.1-e45b407-aliyun | 2023-05-29 | The issue that encrypted disks occasionally fail to be mounted is fixed. | No impact on workloads. |
April 2023
Version number | Image address | Release date | Description | Impact |
v1.24.10-7ae4421-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.24.10-7ae4421-aliyun | 2023-04-12 |
| No impact on workloads. |
March 2023
Version number | Image address | Release date | Description | Impact |
v1.24.9-74f8490-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.24.9-74f8490-aliyun | 2023-03-15 |
| No impact on workloads. |
February 2023
If your cluster contains nodes that use CentOS 7.9 images and the xfs file system is used to persist data, do not update csi-plugin to this version or later. The kernel of CentOS 7.9 is outdated and no longer suitable for this csi-plugin version. In this case, if you update csi-plugin to this version or later, errors are reported in the pods to which the xfs file system is mounted. Other file systems are not affected.
Version number | Image address | Release date | Description | Impact |
v1.24.7-48214b0-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.24.7-48214b0-aliyun | 2023-02-20 |
| No impact on workloads. |
January 2023
Version number | Image address | Release date | Description | Impact |
v1.24.5-39a3970-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.24.5-39a3970-aliyun | 2023-01-30 | Some event notifications are optimized to improve user experience. | No impact on workloads. |
December 2022
Version number | Image address | Release date | Description | Impact |
v1.24.4-7371f039-aliyun | registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.24.4-b0a6692-aliyun | 2022-12-02 |
| No impact on workloads. |
October 2022
Version number | Image address | Release date | Description | Impact |
v1.24.3-55228c1-aliyun | registry.cn-{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.24.3-55228c1-aliyun | 2022-10-30 |
| No impact on workloads. |
September 2022
Version number | Image address | Release date | Description | Impact |
v1.24.2-5b34494d-aliyun | registry.cn-{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.24.2-5b34494d-aliyun | 2022-09-28 |
| No impact on workloads. |
v1.24.1-5c38ee7-aliyun | registry.cn-{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.24.1-5c38ee7-aliyun | 2022-09-01 | Kubernetes 1.24 is supported. | No impact on workloads. |
August 2022
Version number | Image address | Release date | Description | Impact |
v1.22.14-820d8870-aliyun | registry.cn-{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.22.14-820d8870-aliyun | 2022-08-25 |
| No impact on workloads. |
July 2022
Version number | Image address | Release date | Description | Impact |
v1.22.12-b797ad9-aliyun | registry.cn-{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.22.12-b797ad9-aliyun | 2022-07-28 |
| No impact on workloads. |
v1.22.11-abbb810e-aliyun | registry.cn-{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.22.11-abbb810e-aliyun | 2022-07-13 |
| No impact on workloads. |
March 2022
To use csi-plugin 1.22.8-8d3a569-aliyun and later, make sure that the Kubernetes version of your cluster is later than 1.20.
Version number | Image address | Release date | Description | Impact |
v1.22.8-8d3a569-aliyun | registry.cn-{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.22.8-8d3a569-aliyun | 2022-03-16 | Note The Kubernetes version of your ACK clusters must be later than 1.20.
| No impact on workloads. |
December 2021
When you update the CSI plug-in, you must update csi-provisioner before you update csi-plugin.
Version number | Image address | Release date | Description | Impact |
v1.20.8-ba07e52-aliyun | registry.cn-{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.20.8-ba07e52-aliyun | 2021-12-22 |
| No impact on workloads. |
November 2021
Version number | Image address | Release date | Description | Impact |
v1.20.7-aafce42-aliyun | registry.cn-{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.20.7-aafce42-aliyun | 2021-11-26 |
| No impact on workloads. |
October 2021
Version number | Image address | Release date | Description | Impact |
v1.20.6-2be29b1-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/csi-plugin:v1.20.6-2be29b1-aliyun | 2021-10-29 | Images based on ContainerOS are supported. | No impact on workloads. |
September 2021
Version number | Image address | Release date | Description | Impact |
v1.20.5-ff6490f-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/csi-plugin:v1.20.5-ff6490f-aliyun | 2021-09-24 |
| No impact on workloads. |
August 2021
Version number | Image address | Release date | Description | Impact |
v1.18.8.51-c504ef45-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/csi-plugin:v1.18.8.51-c504ef45-aliyun | 2021-08-19 |
| No impact on workloads. |
July 2021
Version number | Image address | Release date | Description | Impact |
v1.18.8.47-06405694-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/csi-plugin:v1.18.8.47-06405694-aliyun | 2021-07-06 |
| No impact on workloads. |
June 2021
Version number | Image address | Release date | Description | Impact |
v1.18.8.47-30ba5d25-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/csi-plugin:v1.18.8.47-30ba5d25-aliyun | 2021-06-25 |
| No impact on workloads. |
May 2021
Version number | Image address | Release date | Description | Impact |
v1.18.8.47-906bd535-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/csi-plugin:v1.18.8.47-906bd535-aliyun | 2021-05-20 |
| No impact on workloads. |
April 2021
Version number | Image address | Release date | Description | Impact |
v1.18.8.46-afb19e46-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/csi-plugin:v1.18.8.46-afb19e46-aliyun | 2021-04-08 |
| No impact on workloads. |
January 2021
Version number | Image address | Release date | Description | Impact |
v1.18.8.45-1c5d2cd1-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/csi-plugin:v1.18.8.45-1c5d2cd1-aliyun | 2021-01-13 |
| No impact on workloads. |
November 2020
Version number | Image address | Release date | Description | Impact |
v1.16.9.43-f36bb540-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/csi-plugin:v1.16.9.43-f36bb540-aliyun | 2020-11-02 |
| No impact on workloads. |
August 2020
Version number | Image address | Release date | Description | Impact |
v1.14.8.41-9efe2ede-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/csi-plugin:v1.14.8.41-9efe2ede-aliyun | 2020-08-05 |
| No impact on workloads. |
July 2020
Version number | Image address | Release date | Description | Impact |
v1.14.8.40-146fd1d8-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/csi-plugin:v1.14.8.40-146fd1d8-aliyun | 2020-07-13 |
| No impact on workloads. |
April 2020
Version number | Image address | Release date | Description | Impact |
v1.14.8.38-fe611ad1-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/csi-plugin:v1.14.8.38-fe611ad1-aliyun | 2020-04-20 |
| No impact on workloads. |
March 2020
Version number | Image address | Release date | Description | Impact |
v1.14.8.36-93f2b131-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/csi-plugin:v1.14.8.36-93f2b131-aliyun | 2020-03-14 |
| No impact on workloads. |
February 2020
Version number | Image address | Release date | Description | Impact |
v1.14.8.37-aae7f495-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/csi-plugin:v1.14.8.37-aae7f495-aliyun | 2020-02-18 |
| No impact on workloads. |
December 2019
Version number | Image address | Release date | Description | Impact |
v1.14.8.32-c77e277b-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/csi-plugin:v1.14.8.32-c77e277b-aliyun | 2019-12-20 |
| No impact on workloads. |
v1.14.5.60-5318afe-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/csi-plugin:v1.14.5.60-5318afe-aliyun | 2019-12-20 |
| No impact on workloads. |