The csi-ebs add-on is an Elastic Block Storage (cloud disk) service add-on that provides the standard CSI interface, enabling container clusters to use block storage services. This topic describes the change history of the csi-ebs add-on.

Usage instructions

For csi-ebs add-on upgrade risks and upgrade verification, refer to Upgrading csi-ebs add-on. For more related introductions and usage methods of add-ons, refer to Add-on management.

Version changes

June 2026

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.3.3	All versions	Maintained	Supported enabling performance bursting on dynamically provisioned FlexPL cloud disks.	None

April 2026

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.3.2	All versions	Maintained	PV and PVC labels are added by default when you create dynamic EBS volumes.	None

March 2026

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.3.1	All versions	Maintained	The WatchList feature is enabled by default to optimize APIServer memory usage. For details, see Streaming List responses.	The client-side processing latency slightly increases.

January 2026

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.3.0	All versions	Maintained	Supported mountOptions. Supported mkfsOptions. Upgraded the csi sidecar version, synchronized to the latest community version, and resolved known CVE issues. Adjusted the default resources.limits to support large-scale online PV scenarios.	Optimization for large-scale PV scenarios leads to increased resource usage of cluster controllers. Adjusted the container limit for csi-provisioner from the default value 300m/900Mi to 600m/2Gi. Adjusted the container limit for csi-attacher from the default value 300m/900Mi to 600m/1.5Gi. Adjusted the container limit for csi-snapshotter from the default value 300m/300Mi to 600m/500Mi. Adjusted the container limit for csi-snapshotter from the default value 100m to 200m. Adjusted the container limit for ebsplugin from the default value 700m/1Gi to 1400m/1.9Gi. Optimization for large-scale PV scenarios leads to increased node resource usage. Adjusted the container limit for ebsplugin from the default value 200m/200Mi to 1C/1Gi.

October 2025

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.2.15	All versions	Maintained	Changed the default port for data collection on nodes to 11815, and console users are allowed to change the settings. Changed the default node health-check port to 9808, which can be customized in the console. Optimized the csi-ebs startup logic so that the add-on does not start until the node has successfully connected to the management center. This feature is disabled by default and can be enabled in the console.	None

September 2025

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.2.14	All versions	Maintained	Supported IPv6only clusters.	None
v1.2.13	All versions	Maintained	Supported the instant snapshot feature.	None

July 2025

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.2.11	All versions	Maintained	ARM clusters are supported. Added anti-affinity feature to EBS clusters.	None

May 2025

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.2.10	All versions	Maintained	Fixed the issue of taint configuration anomaly.	None

April 2025

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.2.9	All versions	Maintained	Fixed the issue where calling the DescribeInstanceTypes API with the parameter InstanceTypes could not query the ecs.ddhr2s.define.c32m64 specification.	None

February 2025

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.2.8	All versions	Maintained	Supports specifying the number of reserved volumes at the node dimension. A new parameter Node reserve volumes Synchronization period is added for the add-on, and the node label key for the number of reserved volumes is ebs.csi.volcengine.com/reserve-volumes. A new parameter Node reserve volumes count is added for the add-on, which is used to configure the number of EBS volumes reserved for each node. This value should include the system volume and data volume used by the node. Supports exposing the metrics of the number of assignable disks per node and the number of assigned disks per node. A new parameter Enable node allocated volumes metric has been added for the add-on. It is disabled by default. By default, add the system Tag created-by-cluster-id for the EBS disk created through CSI.	None

October 2024

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.2.6	All versions	Maintained	Supports configuring the NodeSelector, Tolerations, and Resources of csi-ebs-controller while installing add-ons. Fixed an issue where csi-ebs-node failed to access the metadata server or OpenAPI during startup, causing an inaccurate count of available disks on nodes. Supports specifying the number of node reserved volumes through setting parameters. After csi-ebs-node is ready, the taint with the key ebs.csi.volcengine.com/agent-not-ready on the node will be automatically deleted.	None

July 2024

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.2.5	All versions	Maintained	Authentication via dynamic Secret is now enabled by default.	None
v1.2.4	All versions	Maintained	Deprecates the built-in PTSSD cloud disk type StorageClass. Supports configuring parameters of additional performance package for the Enhanced FlexPL cloud disk type. Supports implementing authentication (turned off by default) through dynamic secret. Upgrade CSI spec version to v1.9.0. Upgraded the sidecar image version. Enable pprof through Unix Domain Socket. Adjust the log level to 2 to avoid printing a large amount of invalid information. Add trace module to increase trace information for critical paths.	Note the following impact related to the deprecation of the built-in PTSSD cloud-disk StorageClass. If PTSSD was allowlisted during the last installation of the csi-ebs add-on: If the add-on is still allowlisted during the upgrade, after the upgrade, the cloud disk type of the stock ebs-ssd StorageClass will be modified to the Enhanced PL0. If allowlisting is canceled during the add-on upgrade, the existing ebs-essd StorageClass will be deleted, and the cloud-disk type of the ebs-ssd StorageClass will be changed to Enhanced PL0. If PTSSD was not allowlisted in the previous csi-ebs installation, it remains not allowlisted during the upgrade and nothing changes; the cloud-disk type of the built-in ebs-ssd StorageClass will be changed to the Enhanced PL0.

May 2024

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.2.3	All versions	Maintained	Supports specifying custom tag for StorageClass. Custom tags can be specified through StorageClass parameters.tags in the format: "key\|value,key\|value". Naming rules for Key: volc: or sys: prefixes are system-reserved tag keys. You cannot create tag keys that start with any case variation of the volc: or sys: prefix. It can only contain characters, digits, spaces, and special characters _.:/=+-@. The length is limited to 1 to 128 characters. Value naming rules: It can only contain characters, digits, spaces, and special characters _.:/=+-@. The length should be between 0 and 256 characters and can be empty.	None

April 2024

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.2.2	All versions	Maintained	Supports XFS file system type. Adapt to Serverless final state (only Serverless supports managed deployment).	None

March 2024

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.2.1	All versions	Maintained	Added a specific tag to disks created or used by csi-ebs.	None
v1.2.0	All versions	Maintained	Supports deployment on Volcengine Container Instance (VCI).	None

January 2024

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.1.9	All versions	Maintained	Avoids scheduling the add-on pods to the DCP registered nodes.	None

December 2023

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.1.8	All versions	Maintained	Fixed the issue where during the upgrade, the csi-ebs plugin did not register to kubelet. Add csi-ebs-controller-metric-server service.	None

November 2023

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.1.7	All versions	Maintained	Fixed the issue where access to the metadata server timed out causing the zone to be empty, preventing the csi node/controller from starting.	None
v1.1.6	All versions	Maintained	Fixed the issue where storageClass did not specify projectName but ebs volume already existed causing projectName check failure. Optimized the problem of rate limiting caused by accessing the metadata server.	None

November 2023

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.1.5	All versions	Maintained	Added support for projectName.	StorageClass adds projectName parameter to specify the project. The default is default if not added.

September 2023

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.1.4	All versions	Maintained	Optimized the verification logic for successful cloud disk scale-out.	None

August 2023

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.1.3	All versions	Maintained	Cancel the dependency on OpenAPI allowlist parameters.	None

June 2023

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.1.2	All versions	Maintained	Supports Elastic Compute Service (ECS) general-purpose g3i, compute-optimized c3i, and memory-optimized r3i specifications. tip The above specifications are beta specifications on the ECS side.	None

May 2023

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.1.1	All versions	Maintained	Supports self-adaptation of the maximum number of mounting Persistent Volumes (PV) per single node according to node specifications.	None
v1.1.0	All versions	Maintained	Optimize verification logic before mounting cloud disk. Optimize mounting method for Block type volumes.	None

March 2023

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.0.4	All versions	No longer maintained	Supports cloud disk snapshot.	None
v1.0.3	All versions	No longer maintained	Supports Volcengine Container Instance (VCI) deployment mode.	None

December 2022

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.0.2	All versions	No longer maintained	Adapted to the Addon (add-on) refactoring.	None
v1.0.1	All versions	No longer maintained	Supports topology spread configuration.	None

November 2022

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v1.0.0	All versions	No longer maintained	Kubernetes v1.24 is supported.	None

September 2022

Version	Compatibility with Kubernetes version	Version status	Description	Impact
v0.1.13	All versions	No longer maintained	Supports deleting persistent volumes through concurrent Detach.	None

Volcengine Kubernetes Engine