csi-ebs 组件是弹性块存储（云盘）服务组件，支持容器集群使用块存储服务的标准 CSI 接口实现。本文主要介绍 csi-ebs 组件的变更记录。

使用说明

csi-ebs 组件升级风险和升级验证参见升级组件，组件相关更多介绍和使用方法参见 csi-ebs 组件。

版本变更

2026.07

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.4.0	全版本	维护中	支持mkfsAutoTune参数，优化动态卷的挂载耗时。调整默认保留盘逻辑，新增挂载失败告警指标。	无

2026.06

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.3.3	全版本	维护中	支持动态卷 FlexPL 类型云盘开启性能突发。	无

2026.04

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.3.2	全版本	维护中	创建云盘动态存储卷时，默认添加 PV 和 PVC 标签。	无

2026.03

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.3.1	全版本	维护中	默认开启 WatchList Feature，优化 APIServer 内存占用，详情参考 Streaming List responses。	略微增加客户端处理耗时。

2026.01

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.3.0	全版本	维护中	支持mountOptions挂载参数。支持mkfsOptions格式化参数。升级 csi sidecar 版本，同步至社区最新版本，解决已知的 CVE 问题。调整默认resources.limits，支持大规模 PV 在线场景。	优化大规模 PV 场景中，会导致集群控制器资源使用量增加：调整 csi-provisioner 容器限额（由默认 300m900Mi 调整为 600m2Gi）。调整 csi-attacher 容器限额（由默认 300m900Mi 调整为 600m1.5Gi）。调整 csi-snapshotter 容器限额（由默认 300m300Mi 调整为 600m500Mi）。调整 csi-snapshotter 容器限额（由默认 100m 调整为 200m）。调整 ebsplugin 容器限额（由默认 700m1Gi 调整为 1400m1.9Gi）。优化大规模 PV 场景中，会导致节点资源使用量增加：调整 ebsplugin 容器限额（由默认 200m200Mi 调整为 1C1Gi）。

2025.10

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.2.15	全版本	维护中	修改默认节点监控采集端口为 11815，支持控制台用户自定义配置。修改节点健康检查端口为 9808，支持控制台用户自定义配置。支持节点连通中心后启动，优化 csi-ebs 启动逻辑，默认关闭，支持用户通过控制台开启。	无

2025.09

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.2.14	全版本	维护中	支持 IPv6only 集群。	无
v1.2.13	全版本	维护中	支持极速快照能力。	无

2025.07

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.2.11	全版本	维护中	支持 ARM 集群。支持 EBS 集群反亲和特性。	无

2025.05

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.2.10	全版本	维护中	修复污点配置异常的问题。	无

2025.04

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.2.9	全版本	维护中	修复调用 DescribeInstanceTypes API 传入参数 InstanceTypes 后无法查询到ecs.ddhr2s.define.c32m64规格的问题。	无

2025.02

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.2.8	全版本	维护中	支持指定节点维度的预留盘数量。组件新增配置项节点保留盘数量同步周期，保留盘数量的节点标签 key 为 ebs.csi.volcengine.com/reserve-volumes。组件新增配置项节点保留盘数量，用于配置每个节点预留的 EBS 盘数量。该值应该包括节点使用的系统盘和数据盘。支持暴露节点可分配盘数量和节点已分配盘数量指标。新增组件配置项开启已分配盘数量指标，默认关闭。默认为通过 CSI 创建的 EBS 盘添加 created-by-cluster-id 系统 Tag。	无

2024.10

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.2.6	全版本	维护中	安装组件时支持配置 csi-ebs-controller 的 NodeSelector、Tolerations 和 Resources。修复 csi-ebs-node 启动期间访问 medatada server 或 OpenAPI 失败导致节点可使用盘数量不准确的问题。支持通过参数指定节点保留盘数量。 csi-ebs-node 就绪后，将自动删除节点上 key 为 ebs.csi.volcengine.com/agent-not-ready 的污点。	无

2024.07

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.2.5	全版本	维护中	默认开启通过动态 secret 进行鉴权。	无
v1.2.4	全版本	维护中	下线预置的 PTSSD 云盘类型存储类。支持为极速型 FlexPL 类型云盘配置额外性能包参数。支持通过动态 secret 进行鉴权（默认关闭）。升级 CSI spec 版本到 v1.9.0。升级 sidecar 镜像版本。通过 Unix Domain Socket 开启 pprof。调整日志等级为 2，避免打印大量无效信息。添加 trace 模块，为关键路径增加 trace 信息。	针对下线预置的 PTSSD 云盘类型存储类，需要注意以下影响。当上次安装 csi-ebs 组件时已经加白 PTSSD：若组件升级时仍然加白，组件升级后，存量 ebs-ssd 存储类的云盘类型将被修改为极速型 PL0。若组件升级时取消加白，组件升级后，存量 ebs-essd 将被删除；ebs-ssd 存储类的云盘类型将被修改为极速型 PL0。当上次安装 csi-ebs 组件时未加白 PTSSD：升级时依然保持未加白，升级前后无变化，预置 ebs-ssd 存储类的云盘类型将被修改为极速型 PL0。

2024.05

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.2.3	全版本	维护中	支持为 StorageClass 指定自定义 tag。可通过 StorageClass 的 parameters.tags 指定自定义 tag，格式："key\|value,key\|value"。 Key 的命名规则： volc:或sys:开头为系统预留标签键，禁止以任何大小写形式的volc:或sys:开头。只能包含语言字符、数字、空格和特殊符号_.:/=+-@。长度限制在 1～128 个字符之间。 Value 的命名规则：只能包含语言字符、数字、空格和特殊符号_.:/=+-@。长度限制在 0～256 个字符之间，允许为空。	无

2024.04

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.2.2	全版本	维护中	支持 XFS 文件系统类型。适配 Serverless 最终态（仅 Serverless 支持托管方式部署）。	无

2024.03

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.2.1	全版本	维护中	为 CSI-EBS 创建/使用的盘添加特定 Tag。	无
v1.2.0	全版本	维护中	支持部署在弹性容器实例 VCI 上。	无

2024.01

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.1.9	全版本	维护中	避免调度组件 Pod 到 DCP 注册节点。	无

2023.12

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.1.8	全版本	维护中	修复升级过程中可能导致 csi-ebs 插件未向 kubelet 注册的问题。添加 csi-ebs-controller-metric-server service。	无

2023.11

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.1.7	全版本	维护中	修复访问 metadata server 超时导致 zone 为空，无法启动 csi node/controller 的问题。	无
v1.1.6	全版本	维护中	修复 storageClass 没有指定 projectName 但 ebs volume 已经存在情况检查 projectName 失败的问题。优化访问 metadata server 导致限流的问题。	无

2023.11

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.1.5	全版本	维护中	添加 projectName 支持。	StorageClass 添加 projectName 参数，用于指定 project，不添加时默认为 default。

2023.09

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.1.4	全版本	维护中	优化云盘扩容成功的校验逻辑。	无

2023.08

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.1.3	全版本	维护中	取消对 OpenAPI 白名单参数的依赖。	无

2023.06

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.1.2	全版本	维护中	支持云服务器（ECS）的通用型 g3i、计算型 c3i、内存型 r3i 规格。说明上述规格在 ECS 侧是邀测规格。	无

2023.05

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.1.1	全版本	维护中	支持根据节点规格，自适配单节点最大可挂载存储卷（PV）数量。	无
v1.1.0	全版本	维护中	优化挂载云盘前的校验逻辑。优化 Block 类型卷挂载方式。	无

2023.03

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.0.4	全版本	停止维护	支持云盘快照。	无
v1.0.3	全版本	停止维护	支持弹性容器实例（VCI）部署方式。	无

2022.12

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.0.2	全版本	停止维护	适配 Addon（组件）重构。	无
v1.0.1	全版本	停止维护	支持拓扑打散配置。	无

2022.11

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.0.0	全版本	停止维护	支持 Kubernetes v1.24。	无

2022.09

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v0.1.13	全版本	停止维护	支持通过并发 Detach 删除存储卷。	无

容器服务