client/v4.2.0

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

Snapshot APIs

• The namespace of the referenced VolumeSnapshot is printed when printing a VolumeSnapshotContent. (#535, @tsmetana)

v4.1.1

Overall Status

Volume snapshotting has been a GA feature since Kubernetes v1.20.

Minimum CSI Spec Version

1.0.0

Maximum CSI Spec Version

1.4.0

Minimum Kubernetes version

1.20

Recommended Kubernetes version

1.20+

Container

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

Bug or Regression

• Cherry-pick #515: Remove kube-system namespace verification during startup and instead list volumesnapshots across all namespaces. (#517, @mauriciopoppe)

Full Changelog

https://github.com/kubernetes-csi/external-snapshotter/blob/v4.1.1/CHANGELOG/CHANGELOG-4.1.md

v4.1.0

Overall Status

Volume snapshotting has been a GA feature since Kubernetes v1.20.

Minimum CSI Spec Version

1.0.0

Maximum CSI Spec Version

1.4.0

Minimum Kubernetes version

1.20

Recommended Kubernetes version

1.20+

Container

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

Deprecations

• VolumeSnapshot v1beta1 is deprecated and will be removed in a future release. It is recommended for users to upgrade to VolumeSnapshot CRD version v1 as soon as possible. Any previously created invalid v1beta1 objects have to be deleted before upgrading to version 4.1.0. (#493, @xing-yang)

API Change

• Changes VolumeSnapshot API storage version from v1beta1 to v1; VolumeSnapshot v1beta1 is deprecated and will be removed in a future release. (#493, @xing-yang)

Bug or Regression

• --http-endpoint will now correctly be used for the metrics server address when --metrics-address is not provided. (#496, @ggriffiths)
• Add check for v1 CRDs to allow for rolling update of the snapshot-controller (#504, @mauriciopoppe)
• VolumeSnapshotContent creation errors can now propagate to the appropriate VolumeSnapshotContent resource. (#502, @huffmanca)
• Retain error from CreateSnapshot call (#470, @timoreimann)

Uncategorized

• External-snapshotter manifests adjusted to reflect more common example. Snapshot-controller is deployed as a Deployment rather than a Statefulset in the example deployment file. (#459, @kvaps)
• Updated runtime (Go 1.16) and dependencies (#483, @pohly)

Full Changelog

https://github.com/kubernetes-csi/external-snapshotter/blob/v4.1.0/CHANGELOG/CHANGELOG-4.1.md

client/v4.1.0

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

Deprecations

• VolumeSnapshot v1beta1 is deprecated and will be removed in a future release. It is recommended for users to upgrade to VolumeSnapshot CRD version v1 as soon as possible. Any previously created invalid v1beta1 objects have to be deleted before upgrading to version 4.1.0. (#493, @xing-yang)

API Change

• Changes VolumeSnapshot API storage version from v1beta1 to v1; VolumeSnapshot v1beta1 is deprecated and will be removed in a future release. (#493, @xing-yang)

v2.1.5

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 k8s.gcr.io/sig-storage/snapshot-controller:v2.1.5
docker pull k8s.gcr.io/sig-storage/csi-snapshotter:v2.1.5

Changes

• Cherry pick of #413:
  Bug fix to allow creation of snapshot content if pvc finalizer exists, even if
  pvc is marked for deletion. (#488,
  @mattcary)
• Cherry pick of #334:
  Call dynamic VS content creation unconditionally.
  (#478,
  @saikat-royc)

Full Changelog

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

v2.1.4

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 k8s.gcr.io/sig-storage/snapshot-controller:v2.1.4
docker pull k8s.gcr.io/sig-storage/csi-snapshotter:v2.1.4

Changes

• Cherry pick of #287: Allows the sidecar to delete volume snapshots if the volume snapshot class is not found. (#466, @ialidzhikov)

Full Changelog

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

v4.0.0

Overall Status

Volume snapshotting has been a GA feature since Kubernetes v1.20.

Supported CSI Spec Versions

1.0.0, 1.1.0, 1.2.0, 1.3.0

Minimum Kubernetes version

1.20

Recommended Kubernetes version

1.20

Container

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

Breaking Changes

• Update to client/v4 (#451, @xing-yang)

• Update snapshot-controller, CSI snapshotter sidecar, and validation webhook based on V1 APIs. This requires V1 snapshot APIs to be installed. (#425, @xing-yang)

Deprecations

CSI Snapshotter Sidecar

• metrics-address flag is deprecated and replaced by http-endpoint, which enables handlers from both metrics manager and leader election health check. (#439, @xing-yang)

Feature

API Changes

• Move Snapshot APIs to V1. (#419, @xing-yang)

CSI Snapshotter Sidecar

• Add process_start_time_seconds metric. (#387, @Jiawei0227)
• The CSI snapshotter has a new --extra-create-metadata flag.
  When set to true, the name and namespace of the source VolumeSnapshot, and the name of the source VolumeSnapshotContent will be passed as parameters to the CSI driver in CreateSnapshotRequest. (#375, @chrishenzie)
• Added leader election health check at the metrics port + path "/healthz/leader-election".
  • metrics-address flag is deprecated and replaced by http-endpoint, which enables handlers from both metrics manager and leader election health check. (#439, @xing-yang)

Snapshot Controller

• The http-endpoint and metrics-path flags have been added to support metrics for the snapshot-controller. (#409, @ggriffiths)

Bug or Regression

Snapshot Controller

• Bug fix to allow creation of snapshot content if pvc finalizer exists, even if pvc is marked for deletion. (#413, @RaunakShah)
• Fixed crash of snapshot-controller when source PVC of a snapshot to take does not exist. (#381, @jsafrane)

Validation Webhook

• The validation-webhook server will now watch for changes to --tls-cert-file and --tls-private-key-file and update the server's TLS config accordingly. (#429, @ggriffiths)

Other (Cleanup or Flake)

• Increased the default re-sync period to 15 minutes for the snapshotter sidecar and snapshot controller. (#447, @ggriffiths)
• klog/v2 is used for logging. (#439, @xing-yang)

Full Changelog

https://github.com/kubernetes-csi/external-snapshotter/blob/v4.0.0/CHANGELOG/CHANGELOG-4.0.md

client/v4.0.0

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

v3.0.3

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.3
docker pull registry.k8s.io/sig-storage/csi-snapshotter:v3.0.3
docker pull registry.k8s.io/sig-storage/snapshot-validation-webhook:v3.0.3

Bug or Regression

Cherry-pick of #429. The validation-webhook server will now watch for changes to --tls-cert-file and --tls-private-key-file and update the server's TLS config accordingly. (#435, @ggriffiths)

Full Changelog

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

v2.1.3

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

Changes

• Backports fix #381 for crashloop when there are errors in the VolumeSnapshot, like a missing VolumeSnapshotClass. (#446, @mattcary)

Full Changelog

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