All Products
Search
Document Center

Container Service for Kubernetes:csi-plugin

Last Updated:Mar 19, 2024

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, Apsara File Storage NAS (NAS) volumes, and Object Storage Service (OSS) volumes. This topic describes the 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 CSI overview.

Important
  • 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.

Release notes

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

  • The maximum number of disks that can be mounted to a node can be automatically obtained based on the type of the node.

  • The globalmount corruption umount logic for deploying OSSFS in pods is optimized.

No impact on workloads.

Important

Only ACK clusters that run 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

  • PL-0 Enhanced SSDs (ESSDs) of 1 GiB in size are supported.

  • Metrics related to the root file systems of pods can be exposed.

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

  • PL0 Enhanced SSDs (ESSDs) of 1 GiB in size are supported.

  • Metrics related to the root file systems of pods can be exposed.

  • OSSFS can be deployed in a non-containerized way.

No impact on workloads. The issue that the mount target of an OSS volume is occupied by software such as mlocate is fixed.

Important

This version is a Backport version, which supports only ACK clusters that run Kubernetes versions from 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. The issue that the mount target of an OSS volume is occupied by software such as mlocate is fixed.

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

  • OSS volumes can be mounted to pods deployed on instances that support confidential computing.

  • The StorageClass parameter can be customized on the Add-ons page of the ACK console.

  • The disk rate limiting issue is fixed.

No impact on workloads.

Important
  • Only ACK clusters that run Kubernetes 1.26 and later support this version.

  • In csi-plugin 1.28.1, if you run OSSFS in pods, the /etc/mime.types file generated on the node by using mailcap or mime-support does not take effect. If you are using the file, do not update csi-plugin to 1.28.1.

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 be run in pods.

No impact on workloads.

Important
  • Only ACK clusters that run Kubernetes 1.26 and later support this version.

  • In csi-plugin 1.26.6, if you run OSSFS in pods, the /etc/mime.types file generated on the node by using mailcap or mime-support does not take effect. If you are using the file, do not update csi-plugin to 1.26.6.

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

  • Inventory check can be skipped when you check the disk types supported by a node.

  • lifseaOS is supported by OSS.

  • Persistent volume claim (PVC) and persistent volume (PV) tags are added to disk volumes by default.

  • An annotation is added to specify the maximum number of disks that can be mounted to a node.

  • Rescheduling is supported during disk creation.

No impact on workloads.

August 2023

Important

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

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

  • The maximum number of disks that can be mounted to a node can be automatically obtained under certain limits.

  • The OSS domain name concatenation issue is fixed.

  • The logic for using metric is optimized.

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

  • The method used to obtain credentials is updated.

  • Several NAS issues are fixed.

  • The pprof port can be specified.

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

  • The RPM version of alinas is updated.

  • Several NAS issues are fixed.

  • OSSFS installation can be retried.

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

The issue that encrypted disks occasionally fail to be mounted is fixed.

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

  • Local disks of the Loopdevice type are supported.

  • Mounting issues related to instance types equipped with local NVMe SSDs are fixed.

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

  • The observabilities of Container Network File System (CNFS) can be used to identify issues caused by I/O operations on NAS clients.

  • Cluster stability is improved and known issues are fixed.

No impact on workloads.

February 2023

Important

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 will be reported in the pods to which the xfs file system is mounted. 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

  • The issue that disk resizing fails because sidecar containers are deployed by using custom images is fixed.

  • The issue that ESSD creation fails because multiple performance levels (PLs) are specified is fixed.

  • The base image is upgraded to Alinux3.

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

Some event notifications are optimized 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

  • Deletion protection for disks is supported.

  • Anolis OS is supported.

  • Statically provisioned OSS volumes can be mounted to ACK Lingjun managed clusters.

  • Hot update is supported by the CSI caching client.

  • The performance of continuous integration and continuous delivery (CI/CD) pipelines and data distribution is improved.

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

  • csi-plugin can be deployed on ECS Bare Metal instances that run the Kylin operating system.

  • Multiple PLs are supported.

  • The initialization logic is optimized.

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

  • Kubernetes 1.24 is supported.

  • OSS bucket lifecycle management is supported by CNFS.

  • Observability is supported by the caching feature of CNFS.

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

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

  • I/O operation monitoring is supported when OSS volumes are mounted to pods.

  • OSSFS is optimized for downloads of large files. The default block size for block downloads is changed from 5 MB to 20 MB. The number of concurrent download threads is changed from 5 to 20.

  • The protocol for API calls of all Alibaba Cloud services is changed from HTTP to HTTPS.

  • The ConfigMap used to configure canary release settings is deleted from Cloud Parallel File Storage (CPFS) 2.0 and alinas.

  • Snapshots can be created for ESSDs during disk resizing.

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

  • Snapshots can be created for mountable disks.

  • The status of the node to which a disk is mounted can be checked after the disk is unmounted. You can determine whether to recheck the mounting status of the node based on the status.

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

  • Disks can be mounted to Edge Node Service (ENS) nodes.

  • Dynamically and statically provisioned volumes that use CPFS 2.0 are supported.

  • The caching feature provided by the CNFS client is supported.

  • Statically provisioned alinas volumes are supported and TLS can be used for encrypted transmission.

  • Statically provisioned OSS volumes can be mounted to JindoFS.

  • OSSFS 1.87 is released. The issue that OSS volumes fail to be mounted due to duplicate entries in concurrent processing scenarios is fixed.

No impact on workloads.

March 2022

Important

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

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.

  • The issue that OSSFS runs with a delay of 1 second on Alibaba Cloud Linux 3 is fixed.

  • New features that are provided by CSI 1.22 are supported for clusters that run Kubernetes 1.22.

  • IOPS limits and throughput limits can be specified in cgroups for Logical Volume Manager (LVM) volumes.

  • NVMe disks can be expanded.

  • Vulnerabilities in the CentOS 7 base image are patched.

No impact on workloads.

December 2021

Important

When you update the CSI plug-in, you must update csi-provisioner before you update 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

  • TLS authentication is supported by LVM.

  • If the quota feature is enabled for a NAS file system and the NAS file system is mounted in subpath mode, you must disable the quota feature before you can delete the PV that is used to mount the NAS file system.

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

  • The issue that OSSFS cannot synchronize data in real time is fixed.

  • The issue that NAS volumes fail to be mounted is fixed.

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

Images based on ContainerOS are 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

  • The sharepath feature of NAS is supported.

  • When the Quota feature is enabled in NAS, automatic expansion and storage monitoring are supported.

  • ARM64 and AMD64 architectures are supported.

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

  • The time parameter for the recycle bin is added to CNFS.

  • The API version of CNFS is changed from v1alpha1 to v1beta1.

  • The issue that OSSFS cannot synchronize data in real time is fixed.

  • By default, the forcefully detach disk option is disabled.

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

  • The issue that NAS file systems cannot be expanded by using CNFS is fixed.

  • OSS buckets can be mounted to nodes that are deployed by using the Alibaba Cloud Linux 3 image.

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

  • PVs can be created by using CNFS.

  • The snapshot.storage.k8s.io/v1 and snapshot.storage.k8s.io/v1beta1 API versions are supported by VolumeSnapshots, VolumeSnapshotClasses, and VolumeSnapshotContents. Upgrade the API version to snapshot.storage.k8s.io/v1 at the earliest opportunity.

  • csi-snapshotter and snapshot-controller are updated to V4.0.0.

  • The occasional issue that the token expires when you perform the List Snapshot operation is fixed.

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

  • Disk partitions can be mounted.

  • Disk partitions can be expanded.

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

  • NAS monitoring is supported.

  • Disks are supported in the China (Qingdao) region.

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

  • By default, volume monitoring is enabled.

  • The VolumeSnapshot List feature is supported.

  • Quota groups are supported by NAS volumes.

  • Custom disk types are supported.

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

  • The deployment template is updated to put drivers in one container.

  • The issue that volumes used to mount subdirectories in Extreme NAS file systems fail to be created is fixed.

  • Kubernetes 1.18 is supported.

  • Labels can be added to NAS volumes when you create NAS volumes.

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

  • The issue that snapshots cannot be created from disks is fixed.

  • The issue that dynamic provisioning of NAS volumes fails due to residual data is fixed.

  • The logic for inspecting BDF nodes when csi-plugin is started is fixed.

  • The use of UUIDs to obtain device paths is no longer supported.

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

  • Elastic Block Storage (EBS) snapshots are supported. You can use EBS snapshots to restore data to a beta version.

  • Extreme NAS volumes can be created and deleted.

  • The Config SysConfig parameter of EBS volumes is supported when you configure PVs.

  • The issue that block volumes are loaded twice in BDF mode is fixed.

  • EBS and NAS volumes are allowed to access APIs by using internal domain names.

  • The CPFS driver is upgraded and the dependency on the kernel is removed.

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

  • EBS volumes can be unmounted before you delete the volumes.

  • The disk creation policy is updated. Standard SSDs are created in preference to ultra disks. Ultra disks are created only when no standard SSD is available.

  • UUID is supported as a high-priority search option to search for devices that use EBS volumes.

  • The authentication management in ACK managed clusters is updated.

  • Security Token Service (STS) is supported to connect to OSS buckets.

  • DuplicateMountPoint errors in EBS are fixed.

  • The BDF protocol is supported to bind EBS volumes after the volumes are connected.

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

  • OSSFS is updated to support Key Management Service (KMS) and Bring Your Own Key (BYOK).

  • Kubernetes 1.16 is supported.

  • EBS volumes can be connected by using the controller server.

  • EBS metric values can be obtained.

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

  • Kubernetes clusters that use CSI and do not have Internet access are supported.

  • The issues related to mount path checks in EBS are fixed.

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

  • The EBS PV name can be used as the disk ID. This feature is also supported by FlexVolume.

  • Mounting parameters can be configured for EBS volumes in the MKFS stage.

  • Mount options can be configured to have a higher priority than the volume attributes of NAS volumes.

  • Mount options of OSS volumes can be validated in OSS connectors.

  • Subpaths of OSS buckets can be mounted as volumes.

  • Volume topology can be used to dynamically configure LVM.

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

  • The mounted subpath and file system type can be configured for a NAS volume.

  • Labels can be added to disk volumes when you configure disk volumes.

  • Multiple regions can be configured in the StorageClass for disk volumes used in multi-region clusters.

  • KMS-based authentication can be configured when you configure disk volumes.

  • Disk volumes can be expanded. This feature is in internal preview.

  • The topology awareness feature is supported when you configure disk volumes.

No impact on workloads.