.. iqu1616951298602
.. _create-readwritemany-persistent-volume-claims:

=============================================
Create ReadWriteMany Persistent Volume Claims
=============================================

Container images have an ephemeral file system by default. For data to survive
beyond the lifetime of a container, it can read and write files to a persistent
volume obtained with a Persistent Volume Claim (PVC) created to provide
persistent storage.

.. rubric:: |context|

For multiple containers to mount the same |PVC|, create a |PVC| with accessMode
of ReadWriteMany (RWX).

The following steps show an example of creating a 1GB |PVC| with ReadWriteMany
accessMode.

.. rubric:: |proc|

.. _iqu1616951298602-steps-bdr-qnm-tkb:

Create the **rwx-test-claim** Persistent Volume Claim.

#.  Create a yaml file defining the claim and its attributes.

    For example:

    .. code-block:: none

        ~(keystone_admin)]$
        cat <<EOF > rwx-claim.yaml
        kind: PersistentVolumeClaim
        apiVersion: v1
        metadata:
          name: rwx-test-claim
        spec:
          accessModes:
          - ReadWriteMany
          resources:
            requests:
              storage: 1Gi
          storageClassName: cephfs
        EOF

#.  Apply the settings created above.

    .. code-block:: none

       ~(keystone_admin)]$ kubectl apply -f rwx-claim.yaml
       persistentvolumeclaim/rwx-test-claim created


This results in 1GB |PVC| being created. You can view the |PVC| using the
following command.

.. code-block:: none

    ~(keystone_admin)]$ kubectl get persistentvolumeclaims

    NAME              STATUS   VOLUME       CAPACITY   ACCESS MODES   STORAGECLASS
    rwx-test-claim    Bound    pvc-df9f..   1Gi        RWX            cephfs

    ~(keystone_admin)]$ kubectl get persistentvolume
    NAME       CAPACITY ACCESS.. RECLAIM.. STATUS CLAIM                   STORAGECLASS
    pvc-df9f.. 1Gi      RWX       Delete    Bound  default/rwx-test-claim  cephfs