Kubernetes 变更块跟踪 API - Beta 版差异
内容提要
Kubernetes CSI驱动变更块跟踪（CBT）功能于2025年9月发布Alpha版，2026年3月随external-snapshot-metadata v1.0.0进入Beta。主要变化是SnapshotMetadataService CRD从v1alpha1升级至v1beta1，schema不变但不再支持旧版，需手动升级。该功能仅适用于块卷。后续重点是推动更多CSI驱动采用并收集反馈，为GA做准备。
延伸解读
升级注意：v1alpha1 已移除，需手动迁移
Beta 版将 SnapshotMetadataService CRD 从 v1alpha1 升级到 v1beta1，并直接移除了旧版本，而非同时提供两个版本。这意味着从 Alpha 升级时，必须手动将 apiVersion 改为 cbt.storage.k8s.io/v1beta1，且没有自动转换机制。这是一次性变更，但若忽略可能导致现有资源无法被识别，影响依赖该 CRD 的备份或存储操作。
功能范围：仅支持块卷，文件卷暂不覆盖
变更块跟踪（CBT）目前仅适用于块卷，文件卷和网络文件共享的变更列表跟踪不在该功能范围内。因此，如果你的环境主要使用文件存储或 NFS 等共享存储，CBT 无法提供增量备份所需的块级变更信息。在评估采用时，需先确认工作负载的卷类型是否匹配，避免对功能覆盖产生误解。
Beta 阶段重点：推动驱动采用与收集反馈
进入 Beta 后，开发重点转向推动更多 CSI 驱动支持该功能，并收集运维反馈，为后续 GA 做准备。如果你维护 CSI 驱动，现在可以评估加入支持；如果你在构建备份应用，官方特别欢迎对流式客户端和迭代器包的反馈。这表明 API 已相对稳定，但实际生态支持仍在扩展中，采用前需确认所用驱动是否已实现相关接口。
Q&A
Kubernetes CSI 变更块跟踪（CBT）功能在 2026 年 3 月进入 Beta 阶段，主要变化是什么？
主要变化是 SnapshotMetadataService CRD 从 v1alpha1 升级到 v1beta1，API 组变为 cbt.storage.k8s.io/v1beta1。Schema 本身没有变化，但不再支持 v1alpha1，需要手动升级。
从 Alpha 升级到 Beta 时，我需要做什么？
需要手动将 SnapshotMetadataService CRD 的 apiVersion 从 cbt.storage.k8s.io/v1alpha1 更新为 cbt.storage.k8s.io/v1beta1。没有自动转换，这是一次性变更。
CBT 功能支持文件卷或网络文件共享吗？
不支持。CBT 目前仅适用于块卷，文件卷和网络文件共享的变更列表跟踪不在该功能覆盖范围内。
external-snapshot-metadata v1.0.0 中 SnapshotMetadataService CRD 的 API 版本是什么？
API 版本是 cbt.storage.k8s.io/v1beta1。
CBT 功能在 Beta 阶段的后续重点是什么？
后续重点是推动更多 CSI 驱动采用该功能，并收集操作反馈，为功能进入 GA 做准备。
如果我想为 CBT 功能做贡献或提供反馈，应该参与哪些社区？
可以参与 SIG Storage 和 Data Protection Working Group。SIG Storage 是参与 CSI 或 Kubernetes 存储相关工作的起点，Data Protection Working Group 也定期举行会议，欢迎新成员加入。
