v2.1.0

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.0
docker pull quay.io/k8scsi/csi-snapshotter:v2.1.0

New Features

Snapshot Controller

• The number of worker threads in the snapshot-controller is now configurable via the worker-threads flag. (#282, @huffmanca)

CSI External-Snapshotter Sidecar

• The number of worker threads in the csi-snapshotter is now configurable via the worker-threads flag. (#282, @huffmanca)
• Adds support for ListSnapshots secrets (#252, @bells17)

Bug Fixes

Snapshot Controller

• Fixes a problem of not removing the PVC finalizer when it is no longer used by a snapshot as source. (#283, @xing-yang)
• Fixes a problem deleting VolumeSnapshotContent with Retain policy for pre-provisioned snapshots. (#249, @xing-yang)
• Allows the volume snapshot to be deleted if the volume snapshot class is not found. (#275, @huffmanca)

CSI External-Snapshotter Sidecar

• Fixes a create snapshot timeout issue. (#261, @xing-yang)

Other Notable Changes

API Changes

• Prints additional details when using kubectl get on VolumeSnapshot, VolumeSnapshotContent, and VolumeSnapshotClass API objects. (#260, @huffmanca)

Full Changelog

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

v2.0.2-rc1

Merge pull request #265 from alex1989hu/doc/add-v2-code-generator-readme

doc: add workaround for hack/update-generated-code.sh

v2.0.1

Overall Status

Volume snapshotting is a Beta feature in 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.0.1
docker pull quay.io/k8scsi/csi-snapshotter:v2.0.1

Breaking Changes

• Cherry pick PR #240: Fix go module requirements for semantic versioning. Update package path to v2. Vendoring with dep depends on golang/dep#1963 or the workaround described in v2/README.md. (#243, @alex1989hu)

Full Changelog

https://github.com/kubernetes-csi/external-snapshotter/blob/v2.0.1/CHANGELOG-2.0.md

v2.0.0

Overall Status

Volume snapshotting is a Beta feature in 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.0.0
docker pull quay.io/k8scsi/csi-snapshotter:v2.0.0

New Features

• Split the external-snapshotter sidecar controller into two controllers, a snapshot-controller and an external-snapshotter sidecar. Only the external-snapshotter sidecar should be deployed with the CSI driver. (#182, @xing-yang)

Snapshot Controller

• Add a finalizer on VolumeSnapshot object to protect it from being deleted when it is bound to
  a VolumeSnapshotContent. (#182, @xing-yang)
• Adds deletion secret as annotation to volume snapshot content. (#165, @xing-yang)

CSI External-Snapshotter Sidecar

• Add prometheus metrics to CSI external-snapshotter under the /metrics endpoint. This can be enabled via the "--metrics-address" and "--metrics-path" options. (#227, @saad-ali)
• Adds deletion secret as annotation to volume snapshot content. (#165, @xing-yang)

Breaking Changes

API Changes

• Changes VolumeSnapshot CRD version from v1alpha1 to v1beta1. v1alpha1 is no longer supported. (#139, @xing-yang)

Snapshot Controller

• Removes createSnapshotContentRetryCount and createSnapshotContentInterval
  from command line options. (#211, @xing-yang)

CSI External-Snapshotter Sidecar

• Add a prefix "external-snapshotter-leader" and the driver name to the snapshotter leader election lock name. Rolling update will not work if leader election is enabled because the lock name is changed in v2.0.0. (#129, @zhucan)

Bug Fixes

Snapshot Controller

• Added extra verification of source PersistentVolumeClaim before creating snapshot. (#172, @xing-yang)
• Fixes issue when SelfLink removal is turned on in Kubernetes. (#160, @msau42)

CSI External-Snapshotter Sidecar

• Snapshotter will no longer call ListSnapshots if the CSI Driver does not support this operation. (#138, @ggriffiths)
• Fixes issue when SelfLink removal is turned on in Kubernetes. (#160, @msau42)

Other Notable Changes

Snapshot Controller

• Migrated to Go modules, so the source builds also outside of GOPATH. (#179, @pohly)

CSI External-Snapshotter Sidecar

• Migrated to Go modules, so the source builds also outside of GOPATH. (#179, @pohly)
• We will now exit the external-snapshotter when the connection to a CSI driver is lost, allowing for another leader to takeover. (#171, @ggriffiths)

Full Changelog

https://github.com/kubernetes-csi/external-snapshotter/blob/v2.0.0/CHANGELOG-2.0.md

v2.0.0-rc4

Merge pull request #192 from xing-yang/update_images_v2.0.0-rc2

Update snapshot-controller and csi-snapshotter images to v2.0.0-rc2

v2.0.0-rc3

Merge pull request #182 from xing-yang/new_beta_split_controller

Split snapshot controller using beta APIs

v2.0.0-rc2

Merge pull request #182 from xing-yang/new_beta_split_controller

Split snapshot controller using beta APIs

Release v0.4.2

Overall Status

Volume snapshotting is an Alpha feature in Kubernetes v1.12.

Minimum CSI Spec Version

0.3.0

Minimum Kubernetes version

1.12

Recommended Kubernetes Version

1.12

Container

docker pull quay.io/k8scsi/csi-snapshotter:v0.4.2

Notable Changes

• Cherry picks PR #172: Added extra verification of source PersistentVolumeClaim before creating snapshot.(#180, @xing-yang)

Full Changelog

https://github.com/kubernetes-csi/external-snapshotter/blob/v0.4.2/CHANGELOG-0.4.md

Release v1.0.2

Overall Status

Volume snapshotting is an Alpha feature in Kubernetes v1.13.

Minimum CSI Spec Version

1.0.0

Minimum Kubernetes version

1.13

Recommended Kubernetes Version

1.13

Container

docker pull quay.io/k8scsi/csi-snapshotter:v1.0.2

Notable Changes

• Cherry picks PR #172: Added extra verification of source PersistentVolumeClaim before creating snapshot.(#175, @xing-yang)

Full Changelog

https://github.com/kubernetes-csi/external-snapshotter/blob/v1.0.2/CHANGELOG-1.0.md

v1.2.2

Overall Status

Volume snapshotting is an Alpha feature in Kubernetes v1.15.

Minimum CSI Spec Version

1.0.0

Minimum Kubernetes version

1.13

Recommended Kubernetes version

1.14: For lease-based leader election

Container

docker pull quay.io/k8scsi/csi-snapshotter:v1.2.2

Notable Changes

• Cherry picks PR #172: Added extra verification of source PersistentVolumeClaim before creating snapshot.(#173, @xing-yang)

Full Changelog

https://github.com/kubernetes-csi/external-snapshotter/blob/v1.2.2/CHANGELOG-1.2.md