v3.0.2

Overall Status

Volume snapshotting has been a Beta feature since Kubernetes v1.17.

Supported CSI Spec Versions

1.0.0, 1.1.0, 1.2.0

Minimum Kubernetes version

1.17

Recommended Kubernetes version

1.17

Container

docker pull registry.k8s.io/sig-storage/snapshot-controller:v3.0.2
docker pull registry.k8s.io/sig-storage/csi-snapshotter:v3.0.2
docker pull registry.k8s.io/sig-storage/snapshot-validation-webhook:v3.0.2

Bug or Regression

• Cherry-pick from #413. Bug fix to allow creation of snapshot content if pvc finalizer exists, even if pvc is marked for deletion. (#414, @RaunakShah)

• Cherry-pick PR (#381, @jsafrane). Fix crash of snapshot-controller when source PVC of a snapshot to take does not exist. (#416, @xing-yang).

Full Changelog

https://github.com/kubernetes-csi/external-snapshotter/blob/v3.0.2/CHANGELOG/CHANGELOG-3.0.md

v3.0.1

Overall Status

Volume snapshotting has been a Beta feature since Kubernetes v1.17.

Supported CSI Spec Versions

1.0.0, 1.1.0, 1.2.0

Minimum Kubernetes version

1.17

Recommended Kubernetes version

1.17

Container

docker pull registry.k8s.io/sig-storage/snapshot-controller:v3.0.1
docker pull registry.k8s.io/sig-storage/csi-snapshotter:v3.0.1
docker pull registry.k8s.io/sig-storage/snapshot-validation-webhook:v3.0.1

Bug or Regression

Cherry-pick from #387. Add process_start_time_seconds metric so that we can properly extrapolate the beginning part of the histogram data. (#388, @Jiawei0227)

Full Changelog

https://github.com/kubernetes-csi/external-snapshotter/blob/v3.0.1/CHANGELOG/CHANGELOG-3.0.md

v2.1.2

Overall Status

Volume snapshotting has been a Beta feature since Kubernetes v1.17.

Minimum CSI Spec Version

1.0.0

Minimum Kubernetes version

1.17

Maximum Kubernetes version

1.21 which is scheduled to be released on April 8, 2021.

Note: The v1beta1 version of CustomResourceDefinition is being removed in 1.22 after six releases of deprecation. In 1.22, the kube-apiserver will no longer serve the v1beta1 version of these resources and the only way to access them will be through the v1 APIs, available since 1.16.

Recommended Kubernetes version

1.17: For Beta

Container

docker pull quay.io/k8scsi/snapshot-controller:v2.1.2
docker pull quay.io/k8scsi/csi-snapshotter:v2.1.2

Changes

• release-2.1: update release-tools (#392, @Jiawei0227)
  • Build with Go 1.15

Dependencies

Changed

• github.com/kubernetes-csi/csi-lib-utils: v0.7.0 → v0.7.1

Full Changelog

https://github.com/kubernetes-csi/external-snapshotter/blob/v2.1.2/CHANGELOG-2.1.md

v3.0.0

Overall Status

Volume snapshotting has been a Beta feature since Kubernetes v1.17.

Supported CSI Spec Versions

1.0.0, 1.1.0, 1.2.0

Minimum Kubernetes version

1.17

Recommended Kubernetes version

1.17

Container

docker pull registry.k8s.io/sig-storage/snapshot-controller:v3.0.0
docker pull registry.k8s.io/sig-storage/csi-snapshotter:v3.0.0
docker pull registry.k8s.io/sig-storage/snapshot-validation-webhook:v3.0.0

Breaking Changes

• Update volume snapshot APIs and client library to v3. Volume snapshot APIs and client library are in a separate sub-module: github.com/kubernetes-csi/external-snapshotter/client/v3. (#373, @xing-yang)

• Added Go Module for APIs and Client. Volume snapshot APIs and client library are now in a separate sub-module. (#307, @Kartik494)

• With kubernetes 1.18 release of client-go, signatures on methods in generated clientsets, dynamic, metadata, and scale clients have been modified to accept context.Context as a first argument. Signatures of Create, Update, and Patch methods have been updated to accept CreateOptions, UpdateOptions and PatchOptions respectively. Signatures of Delete and DeleteCollection methods now accept DeleteOptions by value instead of by reference. These changes are now accommodated with this PR and client-go and dependencies are updated to v1.18.0 (#286, @humblec)

New Features

• The validation for volume snapshot objects (VolumeSnapshot and VolumeSnapshotContent) is getting more strict. Due to backwards compatibility this change will occur over multiple releases. The following key changes are highlighted.

  1. As part of the first phase of the multi-phased release process, a validating
     webhook server has been added. This server will perform additional validation (strict) which was not done during the beta release of volume snapshots. It will prevent the cluster from gaining (via create or update) invalid objects.
  2. The controller will label objects which fail the additional validation. The label "snapshot.storage.kubernetes.io/invalid-snapshot-content-resource" will be added to invalid VolumeSnapshotContent objects. The label "snapshot.storage.kubernetes.io/invalid-snapshot-resource" will be added to invalide VolumeSnapshot objects.

  The combination of 1 and 2 will allow cluster admins to stop the increase of invalid objects, and provide a way to easily list all objects which currently fail the strict validation. It is the kubernets distribution and cluster admin's responsibility to install the webhook and to ensure all the invalid objects in the cluster have been deleted or fixed. See the KEP at https://github.com/kubernetes/enhancements/blob/master/keps/sig-storage/177-volume-snapshot/tighten-validation-webhook-crd.md (#353, @AndiLi99)

Snapshot Controller

• With the addition of the validating webhook server, the snapshot controller is modified to label objects which fail the additional validation. The label "snapshot.storage.kubernetes.io/invalid-snapshot-content-resource" will be added to invalid VolumeSnapshotContent objects. The label "snapshot.storage.kubernetes.io/invalid-snapshot-resource" will be added to invalide VolumeSnapshot objects. (#353, @AndiLi99)
• Snapshot APIs and Client are now in a separate go package. The snapshot controller is modified to use the new package. (#307, @Kartik494)

CSI External-Snapshotter Sidecar

• Snapshot APIs and Client are now in a separate go package. The CSI external-snapshotter sidecar is modified to use the new package. (#307, @Kartik494)

Full Changelog

https://github.com/kubernetes-csi/external-snapshotter/blob/v3.0.0/CHANGELOG/CHANGELOG-3.0.md

client/v3.0.0

The release tag client/v3.0.0 is for VolumeSnapshot APIs and client library which are in a separate go package.

• Update volume snapshot APIs and client library to v3. Volume snapshot APIs and client library are in a separate sub-module: github.com/kubernetes-csi/external-snapshotter/client/v3. (#373, @xing-yang)

• Added Go Module for APIs and Client. Volume snapshot APIs and client library are now in a separate sub-module. (#307, @Kartik494)

v2.2.0-rc.3

Merge pull request #365 from Madhu-1/update-doc

update readme for new crd directory

client/v2.2.0-rc3

Merge pull request #365 from Madhu-1/update-doc

update readme for new crd directory

v2.2.0-rc2

Merge pull request #344 from RaunakShah/leclient

Use separate client for leader election

v2.2.0-rc1

Merge pull request #331 from pohly/prow-update-master

master: update release-tools

v2.1.1

Overall Status

Volume snapshotting has been a Beta feature since Kubernetes v1.17.

Minimum CSI Spec Version

1.0.0

Minimum Kubernetes version

1.17

Maximum Kubernetes version

1.21 which is scheduled to be released on April 8, 2021.

Note: The v1beta1 version of CustomResourceDefinition is being removed in 1.22 after six releases of deprecation. In 1.22, the kube-apiserver will no longer serve the v1beta1 version of these resources and the only way to access them will be through the v1 APIs, available since 1.16.

Recommended Kubernetes version

1.17: For Beta

Container

docker pull quay.io/k8scsi/snapshot-controller:v2.1.1
docker pull quay.io/k8scsi/csi-snapshotter:v2.1.1

Bug Fixes

Snapshot Controller

• Cherry pick PR #293: Fixes issue #290. Disallow a pre-provisioned VolumeSnapshot pointing to a dynamically created VolumeSnapshotContent. (#303, @yuxiangqian)
• Cherry pick PR #293: Fixes issue #291. Verify VolumeSnapshot and VolumeSnapshotContent are bi-directional bound before initializing a deletion on a VolumeSnapshotContent which the to-be-deleted VolumeSnapshot points to. (#303, @yuxiangqian)
• Cherry pick PR #293: Fixes issue #292. Allow deletion of a VolumeSnapshot when the VolumeSnapshotContent's DeletionPolicy has been updated from Delete to Retain. (#303, @yuxiangqian)

Full Changelog

https://github.com/kubernetes-csi/external-snapshotter/blob/v2.1.0/CHANGELOG-2.1.md