Latest release for csi-provisioner - Container Service for Kubernetes

csi-provisioner allows you to automatically create volumes. This topic introduces csi-provisioner and describes the usage notes and release notes for csi-provisioner.

Introduction

Alibaba Cloud provides the csi-provisioner component to help you automate volume creation. The component allows you to create volumes from disks and Apsara File Storage NAS (NAS) file systems. The component is supported by clusters that use Kubernetes version 1.14 or later.

Usage notes

For more information about how to use csi-provisioner, see CSI overview.

Important

To use csi-provisioner 1.22.8-8d3a569-aliyun and later, make sure that the Kubernetes version of your cluster is later than 1.20.
In csi-provisioner 1.18.8.47-906bd535-aliyun and later versions, the same image address is provided for installing csi-provisioner and csi-plugin.
In Container Service for Kubernetes (ACK) Edge clusters, csi-provisioner supports 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. 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	The default NAS setting `tcp_slot_table_entries = 128` is supported. For more information, see How do I change the maximum number of concurrent NFS requests from an NFS client? The issue that occurs if you run OSSFS in pods is fixed. No memory cache is allocated to the `external-resizer` pod. This reduces the memory usage of the volume plug-in.	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	ContainerOS images 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. The issue that the component is frequently restarted due to the unstable etcd is fixed. The 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.48-cd524404-aliyun	registry.cn-hangzhou.aliyuncs.com/acs/csi-plugin:v1.18.8.48-cd524404-aliyun	2021-07-06	The issue that NAS file systems cannot be expanded by using CNFS is fixed. Object Storage Service (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	The `volumeCapacity` field is removed from NAS volume configurations. The `allowVolumeExpansion` field is used to specify whether to enable the quota feature. The `selflink` field is removed from NAS volume configurations.	No impact on workloads.

May 2021

Important

In csi-provisioner 1.18.8.47-906bd535-aliyun and later versions, the same image address is provided for installing csi-provisioner and csi-plugin.

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.6.0-e360c7e43-aliyun	registry.cn-hangzhou.aliyuncs.com/acs/csi-provisioner:v1.6.0-e360c7e43-aliyun	2021-04-08	Kubernetes 1.20 is supported. The `metadata.selflink` field is removed. The tag of the cluster ID is automatically added to disks. NAS volumes can be expanded within the quota limit.	No impact on workloads.

January 2021

Version	Image address	Release date	Description	Impact
v1.6.0-b6f763a43-aliyun	registry.cn-hangzhou.aliyuncs.com/acs/csi-provisioner:v1.6.0-b6f763a43-aliyun	2021-01-13	Database File System (DBFS) volumes are supported. By default, volume monitoring is enabled. Local volumes of the QuotaPath type are supported. 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.6.0-b6f763a43-aliyun	registry.cn-hangzhou.aliyuncs.com/acs/csi-provisioner:v1.6.0-b6f763a43-aliyun	2020-11-02	The deployment template is updated to merge drivers into 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.4.0-aliyun	registry.cn-hangzhou.aliyuncs.com/acs/csi-provisioner:v1.4.0-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 check logic of BDF nodes when csi-provisioner is started is fixed. The use of UUID to obtain device paths is no longer supported.	No impact on workloads.

July 2020

Version	Image address	Release date	Description	Impact
v1.4.0-aliyun	registry.cn-hangzhou.aliyuncs.com/acs/csi-provisioner:v1.4.0-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 Cloud Paralleled File System (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.4.0-aliyun	registry.cn-hangzhou.aliyuncs.com/acs/csi-provisioner:v1.4.0-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 managed Kubernetes 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.

February 2020

Version	Image address	Release date	Description	Impact
v1.4.0-aliyun	registry.cn-hangzhou.aliyuncs.com/acs/csi-provisioner:v1.4.0-aliyun	2020-02-18	Kubernetes clusters that use CSI and have no 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.2.2-aliyun	registry.cn-hangzhou.aliyuncs.com/acs/csi-provisioner:v1.2.2-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.