Merge pull request #63271 from ShaunaDiaz/OCPBUGS-16043

OCPBUGS#16043: Clarify mountOptions for MicroShift

Author: abhatt-rh

microshift_storage/understanding-persistent-storage-microshift.adoc

@@ -23,6 +23,12 @@ include::modules/storage-persistent-storage-reclaim.adoc[leveloffset=+2]
 
 include::modules/storage-persistent-storage-pv.adoc[leveloffset=+1]
 
+ifdef::microshift[]
+[role="_additional-resources"]
+.Additional resources
+* link:https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/managing_file_systems/mounting-file-systems_managing-file-systems#common-mount-options_mounting-file-systems[Common mount options]
+endif::microshift[]
+
 include::modules/storage-persistent-storage-pvc.adoc[leveloffset=+1]
 
 include::modules/storage-persistent-storage-fsGroup.adoc[leveloffset=+1]

modules/storage-persistent-storage-pv.adoc

@@ -252,6 +252,7 @@ You can specify mount options while mounting a PV by using the attribute `mountO
 
 For example:
 
+ifndef::microshift[]
 .Mount options example
 [source,yaml]
 ----
@@ -301,3 +302,31 @@ ifndef::openshift-dedicated,openshift-rosa[]
 Fibre Channel and HostPath PVs do not support mount options.
 ====
 endif::openshift-dedicated,openshift-rosa[]
+endif::microshift[]
+
+ifdef::microshift[]
+.Mount options example
+[source,yaml]
+----
+apiVersion: storage.k8s.io/v1
+kind: StorageClass
+metadata:
+  annotations:
+    storageclass.kubernetes.io/is-default-class: "true"
+  name: topolvm-provisioner
+mountOptions:
+  - uid=1500
+  - gid=1500
+parameters:
+  csi.storage.k8s.io/fstype: xfs
+provisioner: topolvm.io
+reclaimPolicy: Delete
+volumeBindingMode: WaitForFirstConsumer
+allowVolumeExpansion: true
+----
+
+[NOTE]
+====
+`mountOptions` are not validated. Incorrect values will cause the mount to fail and an event to be logged to the PVC.
+====
+endif::microshift[]

modules/storage-persistent-storage-pvc.adoc

@@ -27,10 +27,10 @@ spec:
 status:
   ...
 ----
-<1> Name of the PVC
-<2> The access mode, defining the read-write and mount permissions
-<3> The amount of storage available to the PVC
-<4> Name of the `StorageClass` required by the claim
+<1> Name of the PVC.
+<2> The access mode, defining the read-write and mount permissions.
+<3> The amount of storage available to the PVC.
+<4> Name of the `StorageClass` required by the claim.
 
 [id="pvc-storage-class_{context}"]
 == Storage classes