Skip to content

Commit fd842ff

Browse files
authored
Merge pull request #46304 from carlory/remove-rbd
update rbd volume
2 parents 9dd834a + 292b0bf commit fd842ff

File tree

2 files changed

+8
-58
lines changed

2 files changed

+8
-58
lines changed

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -529,8 +529,6 @@ please install corresponding CSI drivers.
529529
(**migration on by default** starting v1.23)
530530
* [`portworxVolume`](/docs/concepts/storage/volumes/#portworxvolume) - Portworx volume
531531
(**deprecated** starting v1.25)
532-
* [`rbd`](/docs/concepts/storage/volumes/#rbd) - Rados Block Device (RBD) volume
533-
(**deprecated** starting v1.28, no migration plan, support will be removed in a future release)
534532
* [`vsphereVolume`](/docs/concepts/storage/volumes/#vspherevolume) - vSphere VMDK volume
535533
(**migration on by default** starting v1.25)
536534

@@ -546,6 +544,8 @@ Older versions of Kubernetes also supported the following in-tree PersistentVolu
546544
(**not available** starting v1.25)
547545
* `storageos` - StorageOS volume.
548546
(**not available** starting v1.25)
547+
* [`rbd`](/docs/concepts/storage/volumes/#rbd) - Rados Block Device (RBD) volume
548+
(**not available** starting v1.31)
549549

550550
## Persistent Volumes
551551

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

Lines changed: 6 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -745,66 +745,16 @@ To enable the feature, set `CSIMigrationPortworx=true` in kube-controller-manage
745745
A projected volume maps several existing volume sources into the same
746746
directory. For more details, see [projected volumes](/docs/concepts/storage/projected-volumes/).
747747

748-
### rbd
749-
{{< feature-state for_k8s_version="v1.28" state="deprecated" >}}
750-
751-
{{< note >}}
752-
The Kubernetes project suggests that you use the [Ceph CSI](https://github.com/ceph/ceph-csi)
753-
third party storage driver instead, in RBD mode.
754-
{{< /note >}}
755-
756-
An `rbd` volume allows a
757-
[Rados Block Device](https://docs.ceph.com/en/latest/rbd/) (RBD) volume to mount
758-
into your Pod. Unlike `emptyDir`, which is erased when a pod is removed, the
759-
contents of an `rbd` volume are preserved and the volume is unmounted. This
760-
means that a RBD volume can be pre-populated with data, and that data can be
761-
shared between pods.
748+
### rbd (removed) {#rbd}
762749

763-
{{< note >}}
764-
You must have a Ceph installation running before you can use RBD.
765-
{{< /note >}}
766-
767-
A feature of RBD is that it can be mounted as read-only by multiple consumers
768-
simultaneously. This means that you can pre-populate a volume with your dataset
769-
and then serve it in parallel from as many pods as you need. Unfortunately,
770-
RBD volumes can only be mounted by a single consumer in read-write mode.
771-
Simultaneous writers are not allowed.
772-
773-
See the [RBD example](https://github.com/kubernetes/examples/tree/master/volumes/rbd)
774-
for more details.
775-
776-
#### RBD CSI migration {#rbd-csi-migration}
777-
778-
{{< feature-state for_k8s_version="v1.28" state="deprecated" >}}
750+
<!-- maintenance note: OK to remove all mention of rbd once the v1.30 release of
751+
Kubernetes has gone out of support -->
779752

780-
The `CSIMigration` feature for `RBD`, when enabled, redirects all plugin
781-
operations from the existing in-tree plugin to the `rbd.csi.ceph.com` {{<
782-
glossary_tooltip text="CSI" term_id="csi" >}} driver. In order to use this
783-
feature, the
784-
[Ceph CSI driver](https://github.com/ceph/ceph-csi)
785-
must be installed on the cluster and the `CSIMigrationRBD`
786-
[feature gate](/docs/reference/command-line-tools-reference/feature-gates/)
787-
must be enabled. (Note that the `csiMigrationRBD` flag has been removed and
788-
replaced with `CSIMigrationRBD` in release v1.24)
753+
Kubernetes {{< skew currentVersion >}} does not include a `rbd` volume type.
789754

790-
{{< note >}}
755+
The [Rados Block Device](https://docs.ceph.com/en/latest/rbd/) (RBD) in-tree storage driver and its csi migration support were deprecated in the Kubernetes v1.28 release
756+
and then removed entirely in the v1.31 release.
791757

792-
As a Kubernetes cluster operator that administers storage, here are the
793-
prerequisites that you must complete before you attempt migration to the
794-
RBD CSI driver:
795-
796-
* You must install the Ceph CSI driver (`rbd.csi.ceph.com`), v3.5.0 or above,
797-
into your Kubernetes cluster.
798-
* considering the `clusterID` field is a required parameter for CSI driver for
799-
its operations, but in-tree StorageClass has `monitors` field as a required
800-
parameter, a Kubernetes storage admin has to create a clusterID based on the
801-
monitors hash ( ex:`#echo -n
802-
'<monitors_string>' | md5sum`) in the CSI config map and keep the monitors
803-
under this clusterID configuration.
804-
* Also, if the value of `adminId` in the in-tree Storageclass is different from
805-
`admin`, the `adminSecretName` mentioned in the in-tree Storageclass has to be
806-
patched with the base64 value of the `adminId` parameter value, otherwise this
807-
step can be skipped. {{< /note >}}
808758

809759
### secret
810760

0 commit comments

Comments
 (0)