From cbd6921d1a6254bc7d7ba15c2194cd8b319d433c Mon Sep 17 00:00:00 2001 From: Carl Braganza Date: Tue, 24 Feb 2026 10:58:00 -0800 Subject: [PATCH 1/2] Updated the external snapshot metadata sidecar version to Beta. --- book/src/changed-block-tracking.md | 6 ++++-- book/src/external-snapshot-metadata.md | 14 +++++++++++--- 2 files changed, 15 insertions(+), 5 deletions(-) diff --git a/book/src/changed-block-tracking.md b/book/src/changed-block-tracking.md index 59dab34e..dd386fed 100644 --- a/book/src/changed-block-tracking.md +++ b/book/src/changed-block-tracking.md @@ -4,7 +4,7 @@ Status | Min K8s Version | Max K8s Version | Min CSI Version | Max CSI Version | -------|-----------------|-----------------|-----------------|-----------------| -Alpha | 1.33 | - | [v1.10.0](https://github.com/container-storage-interface/spec/releases/tag/v1.10.0) | - +Beta | 1.36 | - | [v1.12.0](https://github.com/container-storage-interface/spec/releases/tag/v1.12.0) | - ## Overview @@ -26,6 +26,9 @@ CSI drivers that implement this feature should deploy the [external-snapshot-metadata](./external-snapshot-metadata.md) sidecar and create the associated [Snapshot Metadata Service CR](https://github.com/kubernetes/enhancements/tree/master/keps/sig-storage/3314-csi-changed-block-tracking#snapshot-metadata-service-custom-resource). +The related [SnapshotMetadataService CRD](https://github.com/kubernetes-csi/external-snapshot-metadata/blob/3a139dd44d4ffa01343a91bed40996b1db56fd38/client/config/crd/cbt.storage.k8s.io_snapshotmetadataservices.yaml) +should be installed by the Kubernetes distribution or the cluster +administrator, and must exist prior to installing the CSI driver. The `external-snapshot-metadata` sidecar implements the server side of the [Kubernetes SnapshotMetadata Service API](https://github.com/kubernetes/enhancements/tree/master/keps/sig-storage/3314-csi-changed-block-tracking#the-kubernetes-snapshotmetadata-service-api). @@ -34,4 +37,3 @@ through this API, bypassing the Kubernetes API server for the most part. Backup application developers should refer to the [Usage](external-snapshot-metadata.md#usage) and [Resources](external-snapshot-metadata.md#resources) sections of the sidecar documentation for details. - diff --git a/book/src/external-snapshot-metadata.md b/book/src/external-snapshot-metadata.md index cefbfe2f..62c9d0d7 100644 --- a/book/src/external-snapshot-metadata.md +++ b/book/src/external-snapshot-metadata.md @@ -8,10 +8,10 @@ Latest stable release | Branch | Min CSI Version | Max CSI Version | Container Image | [Min K8s Version](project-policies.md#minimum-version) | [Max K8s Version](project-policies.md#maximum-version) | [Recommended K8s Version](project-policies.md#recommended-version) | --|--|--|--|--|--|--|-- -v0.1.0 | [v0.1.0](https://github.com/kubernetes-csi/external-snapshot-metadata/releases/tag/v0.1.0) | [v1.10.0](https://github.com/container-storage-interface/spec/releases/tag/v1.10.0) | - | registry.k8s.io/sig-storage/csi-snapshot-metadata:v0.1.0 | v1.33 | - | v1.33 +v0.3.0 | [v0.3.0](https://github.com/kubernetes-csi/external-snapshot-metadata/releases/tag/v0.3.0) | [v1.12.0](https://github.com/container-storage-interface/spec/releases/tag/v1.12.0) | - | registry.k8s.io/sig-storage/csi-snapshot-metadata:v0.3.0 | v1.36 | - | v1.36 -## Alpha +## Beta ### Description This sidecar securely serves snapshot metadata to Kubernetes clients through the @@ -87,13 +87,21 @@ availability of this optional feature to Kubernetes backup application clients. The CR contains the CA certificate and Service endpoint address of the sidecar and the audience string needed for the client authentication token. +The related [SnapshotMetadataService CRD](https://github.com/kubernetes-csi/external-snapshot-metadata/blob/3a139dd44d4ffa01343a91bed40996b1db56fd38/client/config/crd/cbt.storage.k8s.io_snapshotmetadataservices.yaml) +should be installed by the Kubernetes distribution or the cluster administrator, +and must exist prior to installing the CSI driver. +The CSI driver installer must examine the version of the CRD, and should either +fail the installation of the driver or not provide support for this optional feature +if the CRD version is not supported. ### Resources The [external-snapshot-metadata repository](https://github.com/kubernetes-csi/external-snapshot-metadata) contains the [protobuf specification](https://github.com/kubernetes-csi/external-snapshot-metadata/tree/main/proto/schema.proto) of the -[Kubernetes SnapshotMetadata Service API](https://github.com/kubernetes/enhancements/tree/master/keps/sig-storage/3314-csi-changed-block-tracking#the-kubernetes-snapshotmetadata-service-api). +[Kubernetes SnapshotMetadata Service API](https://github.com/kubernetes/enhancements/tree/master/keps/sig-storage/3314-csi-changed-block-tracking#the-kubernetes-snapshotmetadata-service-api) +and the +[SnapshotMetadataService CRD](https://github.com/kubernetes-csi/external-snapshot-metadata/blob/3a139dd44d4ffa01343a91bed40996b1db56fd38/client/config/crd/cbt.storage.k8s.io_snapshotmetadataservices.yaml). In addition, the repository has a number of useful artifacts to support Go language programs: From a96be96e5e775cb4994da45962fd4683ff15e967 Mon Sep 17 00:00:00 2001 From: Carl Braganza Date: Wed, 18 Mar 2026 09:03:34 -0700 Subject: [PATCH 2/2] Update book/src/external-snapshot-metadata.md Co-authored-by: Prasad Ghangal --- book/src/external-snapshot-metadata.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/book/src/external-snapshot-metadata.md b/book/src/external-snapshot-metadata.md index 62c9d0d7..0674b0fc 100644 --- a/book/src/external-snapshot-metadata.md +++ b/book/src/external-snapshot-metadata.md @@ -8,7 +8,7 @@ Latest stable release | Branch | Min CSI Version | Max CSI Version | Container Image | [Min K8s Version](project-policies.md#minimum-version) | [Max K8s Version](project-policies.md#maximum-version) | [Recommended K8s Version](project-policies.md#recommended-version) | --|--|--|--|--|--|--|-- -v0.3.0 | [v0.3.0](https://github.com/kubernetes-csi/external-snapshot-metadata/releases/tag/v0.3.0) | [v1.12.0](https://github.com/container-storage-interface/spec/releases/tag/v1.12.0) | - | registry.k8s.io/sig-storage/csi-snapshot-metadata:v0.3.0 | v1.36 | - | v1.36 +v1.0.0 | [v1.0.0](https://github.com/kubernetes-csi/external-snapshot-metadata/releases/tag/v1.0.0) | [v1.12.0](https://github.com/container-storage-interface/spec/releases/tag/v1.12.0) | - | registry.k8s.io/sig-storage/csi-snapshot-metadata:v1.0.0 | v1.36 | - | v1.36 ## Beta