csi-plugin is the CSI (Container Storage Interface) implementation for ACK clusters. It mounts and unmounts Alibaba Cloud storage — cloud disks, NAS file systems, and OSS buckets — directly into your cluster workloads. This topic describes the overview, usage notes, and release notes for csi-plugin.
Overview
csi-plugin implements the Container Storage Interface (CSI) standard for Alibaba Cloud. It lets you use cloud disks, File Storage NAS (NAS) file systems, and Object Storage Service (OSS) buckets as persistent volumes in ACK clusters.
When you create an ACK cluster running Kubernetes 1.16 or later, the latest version of csi-plugin is installed automatically. No additional setup is required.
csi-plugin supports the full volume lifecycle:
-
Create volumes
-
Mount volumes to pods
-
Unmount volumes from pods
-
Expand volumes
-
Delete volumes
Supported storage types
| Storage type | Typical workloads |
|---|---|
| Cloud disk (block storage) | Databases, stateful applications requiring low-latency block I/O |
| File Storage NAS (NAS) | Shared file access across multiple pods, content management |
| Object Storage Service (OSS) | Large-scale unstructured data, model loading, log archival, media files |
Usage notes
For instructions on installing and upgrading csi-plugin, see Manage the csi-plugin and csi-provisioner components.
-
csi-plugin 1.22.8-8d3a569-aliyun and later require Kubernetes later than 1.20. For ACK clusters running Kubernetes 1.20 or later, upgrade csi-plugin to 1.24.9-74f8490-aliyun or later to maintain cluster stability.
-
ACK Edge clusters support only NAS volumes.
-
When upgrading csi-plugin, upgrade csi-provisioner to the same version at the same time.
Deprecation notice
The zoneId parameter in StorageClass is deprecated as of June 2025 (v1.33.3). Use allowedTopologies instead.
Version compatibility
Most recent csi-plugin versions require ACK clusters running Kubernetes 1.26 or later. Backport versions are released separately for clusters on Kubernetes 1.20–1.24. Check the Impact column in the release notes for each version's compatibility requirement.
Release notes
January 2026
|
Version |
Image address |
Release date |
Description |
Impact |
|
v1.35.1 |
registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.35.1 |
2026-01-19 |
|
No impact on running services. |
November 2025
|
Version |
Image address |
Release date |
Description |
Impact |
|
v1.34.3 |
registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.34.3 |
2025-11-30 |
|
No impact on running services. |
October 2025
|
Version |
Image address |
Release date |
Description |
Impact |
|
v1.26.14-e9322a6-aliyun |
registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.26.14-e9322a6-aliyun |
2025-10-17 |
This version is in canary release. Known issues are fixed. Important
This is a backport version for ACK clusters running Kubernetes 1.20, 1.22, and 1.24. |
No impact on running services. |
September 2025
|
Version |
Image address |
Release date |
Description |
Impact |
|
v1.34.1 |
registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.34.1 |
2025-09-30 |
|
No impact on online services when installing or upgrading components. |
August 2025
|
Version |
Image address |
Release date |
Description |
Impact |
|
v1.33.4-576836c-aliyun |
registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.33.4-576836c-aliyun |
2025-08-15 |
|
No impact on online services when installing or upgrading components. |
June 2025
|
Version |
Image address |
Release date |
Description |
Impact |
|
v1.33.3-884df97-aliyun |
registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.33.3-884df97-aliyun |
2025-06-27 |
|
No impact on online services when installing or upgrading components. |
May 2025
|
Version |
Image address |
Release date |
Description |
Impact |
|
v1.33.1-67e8986-aliyun |
registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.33.1-67e8986-aliyun |
2025-05-20 |
|
No impact on online services when installing or upgrading components. Faster disk mounting and unmounting in concurrent scenarios may increase cluster resource usage:
Important
Only ACK clusters running Kubernetes 1.26 and later support this version. |
March 2025
|
Version |
Image address |
Release date |
Description |
Impact |
|
v1.32.2-757e24b-aliyun |
registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.32.2-757e24b-aliyun |
2025-03-30 |
|
No impact on workloads. Important
Only ACK clusters running Kubernetes 1.26 and later support this version. |
|
v1.26.12-b479bab-aliyun |
registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.26.12-b479bab-aliyun |
2025-03-23 |
|
No impact on workloads. Important
This is a backport version for ACK clusters running Kubernetes 1.20 to 1.24. |
January 2025
|
Version |
Image address |
Release date |
Description |
Impact |
|
v1.32.1-35c87ee-aliyun |
registry-vpc.{{regionID}}.aliyuncs.com/acs/csi-plugin:v1.32.1-35c87ee-aliyun |
2025-01-03 |
|
No impact on online services when installing or upgrading components. Faster disk mounting and unmounting in concurrent scenarios may increase cluster resource usage:
Important
Only ACK clusters running Kubernetes 1.26 and later support this version. |
December 2024
|
Version |
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 running Kubernetes 1.26 and later support this version. |
November 2024
|
Version |
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 is a backport version for ACK clusters running Kubernetes 1.20 to 1.24. |
October 2024
|
Version |
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 installing or upgrading components. Faster disk mounting and unmounting in concurrent scenarios may increase cluster resource usage:
Important
Only ACK clusters running Kubernetes 1.26 and later support this version. |
September 2024
|
Version |
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 running 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 is a backport version for ACK clusters running Kubernetes 1.20 to 1.24. |
August 2024
|
Version |
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 details, see [Product changes] Version upgrade and mounting process optimization of ossfs in CSI. Important
Only ACK clusters running Kubernetes 1.26 and later support this version. |
July 2024
|
Version |
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 running 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 |
Optimized the mount retry logic for NAS and CPFS-NFS. |
No impact on workloads. Important
This is a backport version for ACK clusters running Kubernetes 1.20 to 1.24. |
May 2024
|
Version |
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 running 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 is a backport version for ACK clusters running Kubernetes 1.20 to 1.24. |
April 2024
|
Version |
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 running Kubernetes 1.26 and later support this version. |
February 2024
|
Version |
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 running Kubernetes 1.26 and later support this version. |
January 2024
|
Version |
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 running 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 is a backport version for ACK clusters running Kubernetes 1.20 to 1.24. |
December 2023
|
Version |
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. Fixed an issue where OSS volume mount targets were occupied by software such as mlocate. For details, 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 running 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 |
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 now run in pods. |
No impact on workloads. Important
|
September 2023
|
Version |
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. |
<br />
August 2023
To upgrade to csi-plugin 1.26.4, upgrade both csi-provisioner and csi-plugin to 1.26.4 at the same time.
|
Version |
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 |
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 |
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 |
Fixed an occasional failure to mount encrypted disks. |
No impact on workloads. |
April 2023
|
Version |
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 |
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 has nodes running CentOS 7.9 with the XFS file system, do not upgrade to this version or later. The CentOS 7.9 kernel is no longer compatible with this version of csi-plugin, and pods using XFS volumes will encounter errors. Other file systems are not affected.
|
Version |
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 |
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 |
Optimized event notifications to improve user experience. |
No impact on workloads. |
December 2022
|
Version |
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 |
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 |
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 now supported. |
No impact on workloads. |
August 2022
|
Version |
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 |
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
csi-plugin 1.22.8-8d3a569-aliyun and later require Kubernetes later than 1.20.
|
Version |
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 |
|
No impact on workloads. |
December 2021
When upgrading the CSI plugin, upgrade csi-provisioner before csi-plugin.
|
Version |
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 |
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 |
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 |
ContainerOS-based images are now supported. |
No impact on workloads. |
September 2021
|
Version |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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. |