Skip to content

Commit dd9a3ca

Browse files
committed
Delete removed volume types from feature support list
1 parent 9fb7d10 commit dd9a3ca

File tree

2 files changed

+21
-87
lines changed

2 files changed

+21
-87
lines changed

content/en/docs/concepts/storage/persistent-volumes.md

+6-13
Original file line numberDiff line numberDiff line change
@@ -381,10 +381,9 @@ to `Retain`, including cases where you are reusing an existing PV.
381381
Support for expanding PersistentVolumeClaims (PVCs) is enabled by default. You can expand
382382
the following types of volumes:
383383

384-
* azureFile (deprecated)
385-
* {{< glossary_tooltip text="csi" term_id="csi" >}}
384+
* {{< glossary_tooltip text="csi" term_id="csi" >}} (including some CSI migrated
385+
volme types)
386386
* flexVolume (deprecated)
387-
* rbd (deprecated)
388387
* portworxVolume (deprecated)
389388

390389
You can only expand a PVC if its storage class's `allowVolumeExpansion` field is set to true.
@@ -545,6 +544,8 @@ Older versions of Kubernetes also supported the following in-tree PersistentVolu
545544
(**not available** starting v1.31)
546545
* `flocker` - Flocker storage.
547546
(**not available** starting v1.25)
547+
* `glusterfs` - GlusterFS storage.
548+
(**not available** starting v1.26)
548549
* `photonPersistentDisk` - Photon controller persistent disk.
549550
(**not available** starting v1.15)
550551
* `quobyte` - Quobyte volume.
@@ -727,13 +728,9 @@ Not all Persistent Volume types support mount options.
727728

728729
The following volume types support mount options:
729730

730-
* `azureFile`
731-
* `cephfs` (**deprecated** in v1.28)
732-
* `cinder` (**deprecated** in v1.18)
731+
* `csi` (including CSI migrated volume types)
733732
* `iscsi`
734733
* `nfs`
735-
* `rbd` (**deprecated** in v1.28)
736-
* `vsphereVolume`
737734

738735
Mount options are not validated. If a mount option is invalid, the mount fails.
739736

@@ -966,14 +963,10 @@ network-attached storage. See
966963
The following volume plugins support raw block volumes, including dynamic provisioning where
967964
applicable:
968965

969-
* CSI
966+
* CSI (including some CSI migrated volume types)
970967
* FC (Fibre Channel)
971968
* iSCSI
972969
* Local volume
973-
* OpenStack Cinder
974-
* RBD (deprecated)
975-
* RBD (Ceph Block Device; deprecated)
976-
* VsphereVolume
977970

978971
### PersistentVolume using a Raw Block Volume {#persistent-volume-using-a-raw-block-volume}
979972

content/en/docs/concepts/storage/volumes.md

+15-74
Original file line numberDiff line numberDiff line change
@@ -120,34 +120,17 @@ third party storage driver instead.
120120

121121
### azureFile (deprecated) {#azurefile}
122122

123-
{{< feature-state for_k8s_version="v1.21" state="deprecated" >}}
124-
125-
The `azureFile` volume type mounts a Microsoft Azure File volume (SMB 2.1 and 3.0)
126-
into a pod.
127-
128-
For more details, see the
129-
[`azureFile` volume plugin](https://github.com/kubernetes/examples/tree/master/staging/volumes/azure_file/README.md).
130-
131-
#### azureFile CSI migration
132-
133-
{{< feature-state for_k8s_version="v1.26" state="stable" >}}
134-
135-
The `CSIMigration` feature for `azureFile`, when enabled, redirects all plugin operations
136-
from the existing in-tree plugin to the `file.csi.azure.com` Container
137-
Storage Interface (CSI) Driver. In order to use this feature, the [Azure File CSI
138-
Driver](https://github.com/kubernetes-sigs/azurefile-csi-driver)
139-
must be installed on the cluster and the `CSIMigrationAzureFile`
140-
[feature gates](/docs/reference/command-line-tools-reference/feature-gates/) must be enabled.
141-
142-
Azure File CSI driver does not support using the same volume with different fsgroups. If
143-
`CSIMigrationAzureFile` is enabled, using same volume with different fsgroups won't be supported at all.
123+
<!-- maintenance note: OK to remove all mention of azureFile once the v1.30 release of
124+
Kubernetes has gone out of support -->
144125

145-
#### azureFile CSI migration complete
126+
In Kubernetes {{< skew currentVersion >}}, all operations for the in-tree `azureFile` type
127+
are redirected to the `file.csi.azure.com` {{< glossary_tooltip text="CSI" term_id="csi" >}} driver.
146128

147-
{{< feature-state for_k8s_version="v1.21" state="alpha" >}}
129+
The AzureFile in-tree storage driver was deprecated in the Kubernetes v1.21 release
130+
and then removed entirely in the v1.30 release.
148131

149-
To disable the `azureFile` storage plugin from being loaded by the controller manager
150-
and the kubelet, set the `InTreePluginAzureFileUnregister` flag to `true`.
132+
The Kubernetes project suggests that you use the [Azure File](https://github.com/kubernetes-sigs/azurefile-csi-driver)
133+
third party storage driver instead.
151134

152135
### cephfs (removed) {#cephfs}
153136

@@ -895,56 +878,20 @@ For more details, see [Configuring Secrets](/docs/concepts/configuration/secret/
895878

896879
### vsphereVolume (deprecated) {#vspherevolume}
897880

898-
{{< note >}}
899-
The Kubernetes project recommends using the [vSphere CSI](https://github.com/kubernetes-sigs/vsphere-csi-driver)
900-
out-of-tree storage driver instead.
901-
{{< /note >}}
902-
903-
A `vsphereVolume` is used to mount a vSphere VMDK volume into your Pod. The contents
904-
of a volume are preserved when it is unmounted. It supports both VMFS and VSAN datastore.
905-
906-
For more information, see the
907-
[vSphere volume](https://github.com/kubernetes/examples/tree/master/staging/volumes/vsphere) examples.
908-
909-
#### vSphere CSI migration {#vsphere-csi-migration}
910-
911-
{{< feature-state for_k8s_version="v1.26" state="stable" >}}
881+
<!-- maintenance note: OK to remove all mention of vsphereVolume once the v1.30 release of
882+
Kubernetes has gone out of support -->
912883

913884
In Kubernetes {{< skew currentVersion >}}, all operations for the in-tree `vsphereVolume` type
914885
are redirected to the `csi.vsphere.vmware.com` {{< glossary_tooltip text="CSI" term_id="csi" >}} driver.
915886

916-
[vSphere CSI driver](https://github.com/kubernetes-sigs/vsphere-csi-driver)
917-
must be installed on the cluster. You can find additional advice on how to migrate in-tree `vsphereVolume` in VMware's documentation page
918-
[Migrating In-Tree vSphere Volumes to vSphere Container Storage Plug-in](https://docs.vmware.com/en/VMware-vSphere-Container-Storage-Plug-in/2.0/vmware-vsphere-csp-getting-started/GUID-968D421F-D464-4E22-8127-6CB9FF54423F.html).
919-
If vSphere CSI Driver is not installed volume operations can not be performed on the PV created with the in-tree `vsphereVolume` type.
920-
921-
You must run vSphere 7.0u2 or later in order to migrate to the vSphere CSI driver.
922-
923-
If you are running a version of Kubernetes other than v{{< skew currentVersion >}}, consult
924-
the documentation for that version of Kubernetes.
925-
926-
{{< note >}}
927-
The following StorageClass parameters from the built-in `vsphereVolume` plugin are not supported by the vSphere CSI driver:
928-
929-
* `diskformat`
930-
* `hostfailurestotolerate`
931-
* `forceprovisioning`
932-
* `cachereservation`
933-
* `diskstripes`
934-
* `objectspacereservation`
935-
* `iopslimit`
936-
937-
Existing volumes created using these parameters will be migrated to the vSphere CSI driver,
938-
but new volumes created by the vSphere CSI driver will not be honoring these parameters.
939-
{{< /note >}}
887+
The `vsphereVolume` in-tree storage driver was deprecated in the Kubernetes v1.19 release
888+
and then removed entirely in the v1.30 release.
940889

941-
#### vSphere CSI migration complete {#vsphere-csi-migration-complete}
890+
The Kubernetes project suggests that you use the
891+
[vSphere CSI](https://github.com/kubernetes-sigs/vsphere-csi-driver)
892+
third party storage driver instead.
942893

943-
{{< feature-state for_k8s_version="v1.19" state="beta" >}}
944894

945-
To turn off the `vsphereVolume` plugin from being loaded by the controller manager and the kubelet,
946-
you need to set `InTreePluginvSphereUnregister` feature flag to `true`. You must install a
947-
`csi.vsphere.vmware.com` {{< glossary_tooltip text="CSI" term_id="csi" >}} driver on all worker nodes.
948895

949896
## Using subPath {#using-subpath}
950897

@@ -1222,12 +1169,6 @@ provisioning/delete, attach/detach, mount/unmount and resizing of volumes.
12221169
In-tree plugins that support `CSIMigration` and have a corresponding CSI driver implemented
12231170
are listed in [Types of Volumes](#volume-types).
12241171

1225-
The following in-tree plugins support persistent storage on Windows nodes:
1226-
1227-
* [`azureFile`](#azurefile)
1228-
* [`gcePersistentDisk`](#gcepersistentdisk)
1229-
* [`vsphereVolume`](#vspherevolume)
1230-
12311172
### flexVolume (deprecated) {#flexvolume}
12321173

12331174
{{< feature-state for_k8s_version="v1.23" state="deprecated" >}}

0 commit comments

Comments
 (0)