v3.3.1

What's Changed

v3.3.1 patch release includes three fixes specifically targeted at reducing the vCenter sessions created by the vSphere CSI driver.

1. While creating a new govmomi client, vSpehre CSI Driver will clear idle sessions associated with the existing client. For detail refer to attempt to logout and clear idle sessions before creating new one #2930
2. Change the leader election package used to the one provided by client-go to override OnStoppedLeading callback and cleanup sessions. For detail refer to Use client-go package for leaderelection to add cleanup logic after leader change #2948
3. Removes the listview-tasks feature gate to use a single govmomi client throughout a container. For detail refer to Remove listview-tasks feature gate #2851

Supported Kubernetes Releases

• Minimum: 1.27
• Maximum: 1.30

Deployment files

https://github.com/kubernetes-sigs/vsphere-csi-driver/tree/v3.3.1/manifests/vanilla

Full Changelog: v3.3.0...v3.3.1

v3.3.0

What's New

• Added compatibility for Kubernetes version v1.30
• Added support for ReadWriteOnce (RWO) and ReadWriteMany (RWX) CSI volumes with vSAN Max deployments within same vCenter. This is supported from vCenter 8.0 Update 3 onwards
• Added support for ReadWriteMany (RWX) volumes in HCI Mesh with topology-aware environments within same vCenter. The feature is supported from vCenter 8.0 Update 3 onwards

Enhancements

• Updated Kubernetes cluster distribution map to record EKS & AKS clusters, refer PR #2880 for more details.
• Allow GetDevMounts to resolve symlinks found in the mount table before comparing it to RealDev. This helped in resolving CSI mount issue on RHEL8/RHEL9 when multipathd is enabled, refer PR #2593 for more details.
• Removed x509sha1 support and removed support of overriding tlsmaxrsasize value, more details on PR #2877.
• Leverage nodeAffinity rather than nodeSelector to target Control Plane nodes in CSI driver deployment. Refer to PR #2803 and GitHub issue #2644 for more details.

Bug Fixes

• Changes to fix volume mount issue on Windows worker nodes during node reboots. Refer to PR #2868 for more details on this bug.
• Fixed issues related to mountpoints becoming ReadOnly when one PVC is used by two Pods running on same Node. More details can be found on PR #2861.
• Fixed Thumbprint based authentication for multi vCenter deployment, more details on PR #2858 and GitHub issue #2823.
• Fixed issue related to volume provisioning when same tag is used for different entities in the vCenter, more details on PR #2814 and GitHub issue #2681.
• Use lock per VolumeId during volume mount/unmount operations to avoid conflicts during multiple mount/unmount API calls. More details can be referred from PR #2811.
• Changes to handle expired session for ListView feature, refer to PR #2788 for more details.

Deployment Files

• Deployment files for installation of vSphere CSI Driver v3.3.0 is located at https://github.com/kubernetes-sigs/vsphere-csi-driver/tree/v3.3.0/manifests/vanilla

Release Notes

• https://docs.vmware.com/en/VMware-vSphere-Container-Storage-Plug-in/3.0/rn/vmware-vsphere-container-storage-plugin-30-release-notes/index.html

v3.2.0

What's New

• Added compatibility for Kubernetes version v1.29.1
• vSAN stretched clusters Support for ReadWriteMany volumes, backed by vSAN File Services.
• Added support for ReadWriteMany volumes in topology-aware environments
• Extended support for ReadWriteMany volumes in multi-vCenter environments

Enhancements

• Improved user experience with success and failure reporting for static volume provisioning requests, surfaced as events on PersistentVolumes. Refer to #2725 and #2765 for more details.
• Introduced the ability to collect the absolute number of requests made by the vSphere CSI driver per API. Detailed information available at #2520.
• The internal-feature-states.csi.vsphere.vmware.com configmap now contains alpha or internal features. GA Features cannot be disabled using this internal configmap.

Bug Fixes

• Addressed an issue with extending the validity of the webhook container certificate to 180 days. See more in PR #2739.
• Resolved a limitation of supporting custom vCenter server certificates with key sizes up to 16384. Details available in PR #2777.

Deployment Files

• Deployment files for installation of vSphere CSI Driver v3.2.0 is located at https://github.com/kubernetes-sigs/vsphere-csi-driver/tree/v3.2.0/manifests/vanilla

Release Notes

• https://docs.vmware.com/en/VMware-vSphere-Container-Storage-Plug-in/3.0/rn/vmware-vsphere-container-storage-plugin-30-release-notes/index.html

v3.1.2

What's Changed

• Fixes a CLBO issue for CSI Driver in TKGm deployments with thumbprint in vsphere-config-secret. (#2576) Author Credits: @chethanv28
• Validate vCenter username and disallow username without domain name (#2595) Author Credits: @vdkotkar
• Bumping up kubernetes libs to 1.26.8, fix (CVE-2023-3955 and CVE-2023-3676) (#2642) Author Credits: @nikhilbarge

Deployment files

https://github.com/kubernetes-sigs/vsphere-csi-driver/tree/v3.1.2/manifests/vanilla

Full Changelog: v3.1.1...v3.1.2

v2.6.4

What's Changed

• Cross-port telemetry enhancements and the worker node vm cache fix during attach/detach. Author Credits: @chethanv28 (#2616)
• Bug Fix for device is already deleted while unmount volume. Author Credits: @nikhilbarge (#2617)
• Validate vCenter username and crash CSI driver if username is not a fully qualified domain name. Author Credits: @vdkotkar (#2631)

Deployment files

https://github.com/kubernetes-sigs/vsphere-csi-driver/tree/v2.6.4/manifests/vanilla

Full Changelog: v2.6.3...v2.6.4

v3.0.3

This is the patch release to fix issues observed in v3.0.2 v3.0.1 v3.0.0 releases

Notable Changes

• Telemetry enhancements. Determine cluster distribution server version & type using kubernetes API server version. See #2404 for detail.
• Prevent node cache update during attach & detach See #2597 for detail.
• Add guard for uninitialized volumeMigrationService for multi vCenter deployment See #2582 for more detail.
• Return volume path as part of ListVolumes response for in-tree to CSI migrated volumes. See #2558 for more detail.

Deployment files

https://github.com/kubernetes-sigs/vsphere-csi-driver/tree/v3.0.3/manifests/vanilla

v2.7.3

This is the patch release to fix issues observed in the v2.7.2

Notable Changes

• Telemetry enhancements. Determine cluster distribution server version & type using kubernetes API server version. See #2404 for detail.
• Prevent node cache update during attach & detach See #2597 for detail.
• Handle the case of marking unmount of the volume as success when volume is already detached from the node vm. See #2045 for detail.

Deployment files

https://github.com/kubernetes-sigs/vsphere-csi-driver/tree/v2.7.3/manifests/vanilla

v3.1.1

This is the patch release to fix issues observed in the v3.1.0

Notable Changes

• Prevent node cache update during attach & detach See #2597 for detail.
• Add guard for uninitialized volumeMigrationService for multi vCenter deployment See #2582 for more detail.
• Return volume path as part of ListVolumes response for in-tree to CSI migrated volumes. See #2558 for more detail.

Deployment files

https://github.com/kubernetes-sigs/vsphere-csi-driver/tree/v3.1.1/manifests/vanilla

v3.1.0

v3.1.0 release fixes issues observed in the 3.0.2 and includes enhancements mentioned below

Notable Changes

• Support Kubernetes Version 1.28
• vSAN HCI Mesh support for CNS block volumes. Refer to documentation for detail.
• Added resize capability for migrated in-tree vSphere volumes.
• Enhanced vCenter session management to ensure minimum number of sessions are kept open from vSphere Container Storage Plug-in to vCenter server.
• Reduced number of vpxd connection created by vSphere Container Storage Plug-in on vCenter server enhancing vCenter task monitoring workflow.

Deployment files

https://github.com/kubernetes-sigs/vsphere-csi-driver/tree/v3.1.0/manifests/vanilla

Release Notes

https://docs.vmware.com/en/VMware-vSphere-Container-Storage-Plug-in/3.0/rn/vmware-vsphere-container-storage-plugin-30-release-notes/index.html

v3.0.2

This is the patch release to fix issues observed in the v3.0.0 and v3.0.1 releases.

Notable Changes

• Allow disabling useCSINodeID feature. Pod fails to come up when useCSINodeID feature is disabled. See #2373 for detail.
• Fix a segmentation fault observed when enabling the alpha feature pv-to-backingdiskobjectid-mapping. See #2370 for detail.
• Allow NTFS fsType to be uppercase. See #2305 for detail.
• Allow enabling topology if not configured initially while deploying the vSphere CSI Driver. See #2412 for detail.
• Fix the List-volume feature to honor a vCenter server without any nodes in the vSphere Config Secret. See #2393 for detail.
• Fixed authorization service to permit adding new vCenter server without any datastore or nodes while working on extending topology setup to another vCenter server. See #2443 for detail.
• Fixed pushing volume metadata to vCenter for migrated in-tree vSphere volume. See #2454 for detail.

Deployment files

https://github.com/kubernetes-sigs/vsphere-csi-driver/tree/v3.0.2/manifests/vanilla

Release Notes

https://docs.vmware.com/en/VMware-vSphere-Container-Storage-Plug-in/3.0/rn/vmware-vsphere-container-storage-plugin-30-release-notes/index.html