diff --git a/doc/source/storage/kubernetes/about-persistent-volume-support.rst b/doc/source/storage/kubernetes/about-persistent-volume-support.rst index c5f9f850a..cc03c4315 100644 --- a/doc/source/storage/kubernetes/about-persistent-volume-support.rst +++ b/doc/source/storage/kubernetes/about-persistent-volume-support.rst @@ -9,33 +9,39 @@ About Persistent Volume Support Persistent Volume Claims (PVCs) are requests for storage resources in your cluster. By default, container images have an ephemeral file system. In order for containers to persist files beyond the lifetime of the container, a -Persistent Volume Claim can be created to obtain a persistent volume which the -container can mount and read/write files. +|PVC| can be created to obtain a persistent volume which the +container can mount and read/write files. In |prod-long|, |PVCs| are backed by +Ceph. Management and customization tasks for Kubernetes |PVCs| can be accomplished by using StorageClasses set up by two Helm charts; -**rbd-provisioner** and **cephfs-provisioner**. The **rbd-provisioner**, -and **cephfs-provisioner** Helm charts are included in the -**platform-integ-apps** system application, which is automatically loaded and -applied as part of the |prod| installation. +``rbd-provisioner`` and ``cephfs-provisioner``. The ``rbd-provisioner``, +and ``cephfs-provisioner`` Helm charts are included in the +``platform-integ-apps`` system application, which is automatically loaded and +applied when Ceph is configured. -PVCs are supported with the following options: +If ``platform-integ-apps`` is not applied, then enable Ceph. Enabling Ceph +would automatically apply the ``platform-integ-apps`` application. For +information on how to enable Ceph, see :ref:`Ceph Cluster on a Controller Host +`. + +|PVCs| are supported with the following options: - with accessMode of ReadWriteOnce backed by Ceph |RBD| - - only one container can attach to these PVCs + - only one container can attach to these |PVCs| - management and customization tasks related to these PVCs are done - through the **rbd-provisioner** Helm chart provided by - platform-integ-apps + through the ``rbd-provisioner`` Helm chart provided by + ``platform-integ-apps`` - with accessMode of ReadWriteMany backed by CephFS - multiple containers can attach to these PVCs - - management and customization tasks related to these PVCs are done - through the **cephfs-provisioner** Helm chart provided by - platform-integ-apps + - management and customization tasks related to these |PVCs| are done + through the ``cephfs-provisioner`` Helm chart provided by + ``platform-integ-apps`` -After platform-integ-apps is applied the following system configurations are +After ``platform-integ-apps`` is applied the following system configurations are created: - **Ceph Pools**