Skip to content

Commit 5525bd9

Browse files
authored
Merge pull request #28223 from Jiawei0227/cc
Deprecate and remove some storage plugins
2 parents c9e0171 + 0b90e84 commit 5525bd9

File tree

2 files changed

+20
-56
lines changed

2 files changed

+20
-56
lines changed

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

Lines changed: 18 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -314,12 +314,9 @@ PersistentVolume types are implemented as plugins. Kubernetes currently supports
314314
* [`azureDisk`](/docs/concepts/storage/volumes/#azuredisk) - Azure Disk
315315
* [`azureFile`](/docs/concepts/storage/volumes/#azurefile) - Azure File
316316
* [`cephfs`](/docs/concepts/storage/volumes/#cephfs) - CephFS volume
317-
* [`cinder`](/docs/concepts/storage/volumes/#cinder) - Cinder (OpenStack block storage)
318-
(**deprecated**)
319317
* [`csi`](/docs/concepts/storage/volumes/#csi) - Container Storage Interface (CSI)
320318
* [`fc`](/docs/concepts/storage/volumes/#fc) - Fibre Channel (FC) storage
321319
* [`flexVolume`](/docs/concepts/storage/volumes/#flexVolume) - FlexVolume
322-
* [`flocker`](/docs/concepts/storage/volumes/#flocker) - Flocker storage
323320
* [`gcePersistentDisk`](/docs/concepts/storage/volumes/#gcepersistentdisk) - GCE Persistent Disk
324321
* [`glusterfs`](/docs/concepts/storage/volumes/#glusterfs) - Glusterfs volume
325322
* [`hostPath`](/docs/concepts/storage/volumes/#hostpath) - HostPath volume
@@ -329,17 +326,28 @@ PersistentVolume types are implemented as plugins. Kubernetes currently supports
329326
* [`local`](/docs/concepts/storage/volumes/#local) - local storage devices
330327
mounted on nodes.
331328
* [`nfs`](/docs/concepts/storage/volumes/#nfs) - Network File System (NFS) storage
332-
* `photonPersistentDisk` - Photon controller persistent disk.
333-
(This volume type no longer works since the removal of the corresponding
334-
cloud provider.)
335329
* [`portworxVolume`](/docs/concepts/storage/volumes/#portworxvolume) - Portworx volume
336-
* [`quobyte`](/docs/concepts/storage/volumes/#quobyte) - Quobyte volume
337330
* [`rbd`](/docs/concepts/storage/volumes/#rbd) - Rados Block Device (RBD) volume
338-
* [`scaleIO`](/docs/concepts/storage/volumes/#scaleio) - ScaleIO volume
339-
(**deprecated**)
340-
* [`storageos`](/docs/concepts/storage/volumes/#storageos) - StorageOS volume
341331
* [`vsphereVolume`](/docs/concepts/storage/volumes/#vspherevolume) - vSphere VMDK volume
342332

333+
The following types of PersistentVolume are deprecated. This means that support is still available but will be removed in a future Kubernetes release.
334+
335+
* [`cinder`](/docs/concepts/storage/volumes/#cinder) - Cinder (OpenStack block storage)
336+
(**deprecated** in v1.18)
337+
* [`flocker`](/docs/concepts/storage/volumes/#flocker) - Flocker storage
338+
(**deprecated** in v1.22)
339+
* [`quobyte`](/docs/concepts/storage/volumes/#quobyte) - Quobyte volume
340+
(**deprecated** in v1.22)
341+
* [`storageos`](/docs/concepts/storage/volumes/#storageos) - StorageOS volume
342+
(**deprecated** in v1.22)
343+
344+
Older versions of Kubernetes also supported the following in-tree PersistentVolume types:
345+
346+
* `photonPersistentDisk` - Photon controller persistent disk.
347+
(**not available** after v1.15)
348+
* [`scaleIO`](/docs/concepts/storage/volumes/#scaleio) - ScaleIO volume
349+
(**not available** after v1.21)
350+
343351
## Persistent Volumes
344352

345353
Each PV contains a spec and status, which is the specification and status of the volume.
@@ -437,7 +445,6 @@ In the CLI, the access modes are abbreviated to:
437445
| RBD | ✓ | ✓ | - |
438446
| VsphereVolume | ✓ | - | - (works when Pods are collocated) |
439447
| PortworxVolume | ✓ | - | ✓ |
440-
| ScaleIO | ✓ | ✓ | - |
441448
| StorageOS | ✓ | - | - |
442449

443450
### Class

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

Lines changed: 2 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -931,7 +931,7 @@ A container using a projected volume source as a [`subPath`](#using-subpath) vol
931931
receive updates for those volume sources.
932932
{{< /note >}}
933933

934-
### quobyte
934+
### quobyte (deprecated) {#quobyte}
935935

936936
A `quobyte` volume allows an existing [Quobyte](https://www.quobyte.com) volume to
937937
be mounted into your Pod.
@@ -967,49 +967,6 @@ Simultaneous writers are not allowed.
967967
See the [RBD example](https://github.com/kubernetes/examples/tree/{{< param "githubbranch" >}}/volumes/rbd)
968968
for more details.
969969

970-
### scaleIO (deprecated) {#scaleio}
971-
972-
ScaleIO is a software-based storage platform that uses existing hardware to
973-
create clusters of scalable shared block networked storage. The `scaleIO` volume
974-
plugin allows deployed pods to access existing ScaleIO
975-
volumes. For information about dynamically provisioning new volumes for
976-
persistent volume claims, see
977-
[ScaleIO persistent volumes](/docs/concepts/storage/persistent-volumes/#scaleio).
978-
979-
{{< note >}}
980-
You must have an existing ScaleIO cluster already setup and
981-
running with the volumes created before you can use them.
982-
{{< /note >}}
983-
984-
The following example is a Pod configuration with ScaleIO:
985-
986-
```yaml
987-
apiVersion: v1
988-
kind: Pod
989-
metadata:
990-
name: pod-0
991-
spec:
992-
containers:
993-
- image: k8s.gcr.io/test-webserver
994-
name: pod-0
995-
volumeMounts:
996-
- mountPath: /test-pd
997-
name: vol-0
998-
volumes:
999-
- name: vol-0
1000-
scaleIO:
1001-
gateway: https://localhost:443/api
1002-
system: scaleio
1003-
protectionDomain: sd0
1004-
storagePool: sp1
1005-
volumeName: vol-0
1006-
secretRef:
1007-
name: sio-secret
1008-
fsType: xfs
1009-
```
1010-
1011-
For further details, see the [ScaleIO](https://github.com/kubernetes/examples/tree/{{< param "githubbranch" >}}/staging/volumes/scaleio) examples.
1012-
1013970
### secret
1014971

1015972
A `secret` volume is used to pass sensitive information, such as passwords, to
@@ -1029,7 +986,7 @@ receive Secret updates.
1029986

1030987
For more details, see [Configuring Secrets](/docs/concepts/configuration/secret/).
1031988

1032-
### storageOS {#storageos}
989+
### storageOS (deprecated) {#storageos}
1033990

1034991
A `storageos` volume allows an existing [StorageOS](https://www.storageos.com)
1035992
volume to mount into your Pod.

0 commit comments

Comments
 (0)