Merge pull request #60556 from lpettyjo/OSDOCS-6116

OSDOCS#6116: Add RWOP access mode

Author: lpettyjo

modules/storage-persistent-storage-pv.adoc

@@ -95,6 +95,19 @@ Direct matches are always attempted first. The volume's modes must match or cont
 
 All volumes with the same modes are grouped, and then sorted by size, smallest to largest. The binder gets the group with matching modes and iterates over each, in size order, until one size matches.
 
+ifndef::microshift[]
+[IMPORTANT]
+====
+Volume access modes describe volume capabilities. They are not enforced constraints. The storage provider is responsible for runtime errors resulting from invalid use of the resource. Errors in the provider show up at runtime as mount errors.
+
+ifndef::openshift-dedicated,openshift-rosa[]
+For example, NFS offers `ReadWriteOnce` access mode. If you want to use the volume's ROX capability, mark the claims as `ReadOnlyMany`.
+
+iSCSI and Fibre Channel volumes do not currently have any fencing mechanisms. You must ensure the volumes are only used by one node at a time. In certain situations, such as draining a node, the volumes can be used simultaneously by two nodes. Before draining the node, delete the pods that use the volumes.
+endif::openshift-dedicated,openshift-rosa[]
+====
+endif::microshift[]
+
 The following table lists the access modes:
 
 .Access modes
@@ -104,6 +117,9 @@ The following table lists the access modes:
 |ReadWriteOnce
 |`RWO`
 |The volume can be mounted as read-write by a single node.
+|ReadWriteOncePod ^[1]^
+|`RWOP`
+|The volume can be mounted as read-write by a single pod on a single node.
 ifdef::openshift-enterprise,openshift-webscale,openshift-origin[]
 |ReadOnlyMany
 |`ROX`
@@ -113,69 +129,58 @@ ifdef::openshift-enterprise,openshift-webscale,openshift-origin[]
 |The volume can be mounted as read-write by many nodes.
 endif::[]
 |===
+--
+1. ReadWriteOncePod access mode for persistent volumes is a Technology Preview feature.
+--
+:FeatureName: ReadWriteOncePod access mode for persistent volumes
+include::snippets/technology-preview.adoc[leveloffset=+1]
 endif::microshift[]
 
 ifndef::microshift[]
-[IMPORTANT]
-====
-Volume access modes are descriptors of volume capabilities. They are not enforced constraints. The storage provider is responsible for runtime errors resulting from invalid use of the resource.
-
-ifndef::openshift-dedicated,openshift-rosa[]
-For example, NFS offers `ReadWriteOnce` access mode. You must
-mark the claims as `read-only` if you want to use the volume's
-ROX capability. Errors in the provider show up at runtime as mount errors.
-
-iSCSI and Fibre Channel volumes do not currently have any fencing
-mechanisms. You must ensure the volumes are only used by one node at a
-time. In certain situations, such as draining a node, the volumes can be
-used simultaneously by two nodes. Before draining the node, first ensure
-the pods that use these volumes are deleted.
-endif::openshift-dedicated,openshift-rosa[]
-====
-endif::microshift[]
-
-ifndef::microshift[]
-.Supported access modes for PVs
-[cols=",^v,^v,^v", width="100%",options="header"]
+.Supported access modes for persistent volumes
+[cols=",^v,^v,^v,^v", width="100%",options="header"]
 |===
-|Volume plugin  |ReadWriteOnce ^[1]^  |ReadOnlyMany  |ReadWriteMany
+|Volume plugin  |ReadWriteOnce ^[1]^ | ReadWriteOncePod ^[2]^ |ReadOnlyMany|ReadWriteMany
 ifdef::openshift-enterprise,openshift-webscale,openshift-origin[]
-|AliCloud Disk | ✅ | - |  -
+|AliCloud Disk | ✅ |✅ | - |  -
 endif::[]
-|AWS EBS ^[2]^ | ✅ | - |  -
-|AWS EFS | ✅ | ✅ | ✅
+|AWS EBS ^[3]^ | ✅ | ✅ | - |  -
+|AWS EFS | ✅ | ✅ | ✅ | ✅
 ifdef::openshift-enterprise,openshift-webscale,openshift-origin[]
-|Azure File | ✅ | ✅ | ✅
-|Azure Disk | ✅ | - | -
-//|Ceph RBD  | ✅ | ✅ |  -
-//|CephFS  | ✅ | ✅ |  ✅
-|Cinder  | ✅ | - |  -
-|Fibre Channel  | ✅ | ✅ |  -
+|Azure File | ✅ |✅ | ✅ | ✅
+|Azure Disk | ✅ | ✅ | - | -
+//|Ceph RBD  | ✅ | ✅ |✅ |  -
+//|CephFS  | ✅ | ✅ | ✅ |  ✅
+|Cinder  | ✅ | ✅ |- |  -
+|Fibre Channel  | ✅ | ✅ |✅ |  -
 endif::[]
 ifndef::openshift-rosa[]
-|GCP Persistent Disk  | ✅ | - |  -
-|GCP Filestore | ✅ | ✅ | ✅
+|GCP Persistent Disk  | ✅ |✅ | - |  -
+|GCP Filestore | ✅ | ✅ |✅ | ✅
 endif::openshift-rosa[]
 ifdef::openshift-enterprise,openshift-webscale,openshift-origin[]
-//|GlusterFS  | ✅ | ✅ | ✅
-|HostPath  | ✅ | - |  -
-|{ibmpowerProductName} Virtual Server Disk | ✅ | ✅ |  ✅
-|IBM VPC Disk | ✅ | - |  -
-|iSCSI  | ✅ | ✅ |  -
-|Local volume | ✅ | - |  -
-|NFS  | ✅ | ✅ | ✅
-|OpenStack Manila  | - | - | ✅
-|{rh-storage-first}  | ✅ | - | ✅
-|VMware vSphere | ✅ | - | ✅ ^[3]^
+//|GlusterFS  | ✅ |✅ | ✅ | ✅
+|HostPath  | ✅ |✅ | - |  -
+|{ibmpowerProductName} Virtual Server Disk | ✅ |✅  | ✅ |  ✅
+|IBM VPC Disk | ✅ |✅ | - |  -
+|iSCSI  | ✅ | ✅ |✅ |  -
+|Local volume | ✅ |✅ | - |  -
+|NFS  | ✅ | ✅ |✅ | ✅
+|OpenStack Manila  | - |✅ | - | ✅
+|{rh-storage-first}  | ✅ |✅ | - | ✅
+|VMware vSphere | ✅ |✅ | - | ✅ ^[4]^
 endif::[]
-
 |===
 [.small]
 --
 1. ReadWriteOnce (RWO) volumes cannot be mounted on multiple nodes. If a node fails, the system does not allow the attached RWO volume to be mounted on a new node because it is already assigned to the failed node. If you encounter a multi-attach error message as a result, force delete the pod on a shutdown or crashed node to avoid data loss in critical workloads, such as when dynamic persistent volumes are attached.
-2. Use a recreate deployment strategy for pods that rely on Amazon EBS.
+
+2. ReadWriteOncePod is a Technology Preview feature.
+
+3. Use a recreate deployment strategy for pods that rely on AWS EBS.
+
 ifndef::openshift-dedicated,openshift-rosa[]
-3. If the underlying vSphere environment supports the vSAN file service, then the vSphere Container Storage Interface (CSI) Driver Operator installed by
+4. If the underlying vSphere environment supports the vSAN file service, then the vSphere Container Storage Interface (CSI) Driver Operator installed by
 {product-title} supports provisioning of ReadWriteMany (RWX) volumes. If you do not have vSAN file service configured, and you request RWX, the volume fails to get created and an error is logged. For more information, see "Using Container Storage Interface" -> "VMware vSphere CSI Driver Operator".
 endif::openshift-dedicated,openshift-rosa[]
 // GCE Persistent Disks, or Openstack Cinder PVs.