Merge pull request #55611 from ShaunaDiaz/OSDOCS-5187

OSDOCS-5187: Revise storage section to MicroShift-specific

Author: mburke5678

_topic_maps/_topic_map_ms.yml

@@ -117,25 +117,22 @@ Topics:
   File: index
 - Name: Understanding ephemeral storage for MicroShift
   File: understanding-ephemeral-storage-microshift
-- Name: Understanding persistent storage for MicroShift
-  File: understanding-persistent-storage-microshift
-- Name: Configuring persistent storage for MicroShift
-  Dir:  persistent_storage_microshift
-  Topics:
-  - Name: MicroShift storage plugin overview
-    File: microshift-storage-plugin-overview
-- Name: Using container storage interface (CSI) for MicroShift
-  Dir: container_storage_interface_microshift
-  Distros: microshift
-  Topics:
-  - Name: Configuring CSI volumes for MicroShift
-    File: microshift-persistent-storage-csi
 - Name: Generic ephemeral volumes for MicroShift
   File: generic-ephemeral-volumes-microshift
+- Name: Understanding persistent storage for MicroShift
+  File: understanding-persistent-storage-microshift
 - Name: Expanding persistent volumes for MicroShift
   File: expanding-persistent-volumes-microshift
-- Name: Dynamic provisioning for MicroShift
-  File: dynamic-provisioning-microshift
+- Name: Dynamic storage using the LVMS plugin
+  File: microshift-storage-plugin-overview
+#- Name: Using container storage interface (CSI) for MicroShift
+#  Dir: container_storage_interface_microshift
+#  Distros: microshift
+#  Topics:
+#  - Name: Configuring CSI volumes for MicroShift
+#    File: microshift-persistent-storage-csi
+#- Name: Dynamic provisioning for MicroShift
+#  File: dynamic-provisioning-microshift
 ---
 Name: Running applications
 Dir: microshift_running_apps

microshift_networking/microshift-networking.adoc

@@ -29,6 +29,6 @@ include::modules/microshift-mDNS.adoc[leveloffset=+1]
 [id="additional-resources_microshift-applying-networking-settings"]
 .Additional resources
 
-. xref:../microshift_troubleshooting/microshift-troubleshooting.adoc#microshift-version[Troubleshooting]
-. xref:../microshift_troubleshooting/microshift-troubleshooting.adoc#microshift-troubleshooting-nodeport[Troubleshooting the NodePort service].
-. xref:../microshift_troubleshooting/microshift-troubleshooting.adoc#microshift-nodeport-unreachable-workaround[NodePort unreachable workround].
+* xref:../microshift_troubleshooting/microshift-troubleshooting.adoc#microshift-version[Troubleshooting]
+* xref:../microshift_troubleshooting/microshift-troubleshooting.adoc#microshift-troubleshooting-nodeport[Troubleshooting the NodePort service]
+* xref:../microshift_troubleshooting/microshift-troubleshooting.adoc#microshift-nodeport-unreachable-workaround[NodePort unreachable workround]

microshift_storage/container_storage_interface_microshift/microshift-persistent-storage-csi.adoc

@@ -16,8 +16,10 @@ as persistent storage.
 {product-title} {product-version} supports version 1.5.0 of the link:https://github.com/container-storage-interface/spec[CSI specification].
 ====
 
-include::modules/persistent-storage-csi-architecture.adoc[leveloffset=+1]
-include::modules/persistent-storage-csi-external-controllers.adoc[leveloffset=+2]
-include::modules/persistent-storage-csi-driver-daemonset.adoc[leveloffset=+2]
 include::modules/persistent-storage-csi-dynamic-provisioning.adoc[leveloffset=+1]
 include::modules/persistent-storage-csi-mysql-example.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+
+* link:https://access.redhat.com/documentation/en-us/openshift_container_platform/4.12/html/storage/using-container-storage-interface-csi#persistent-storage-csi[{ocp} CSI Overview]

microshift_storage/expanding-persistent-volumes-microshift.adoc

@@ -1,17 +1,15 @@
 :_content-type: ASSEMBLY
 [id="expanding-persistent-volumes-microshift"]
 = Expanding persistent volumes for {product-title}
-include::_attributes/common-attributes.adoc[]
+include::_attributes/attributes-microshift.adoc[]
 :context: expanding-persistent-volumes-microshift
 
 toc::[]
 
-//include::modules/storage-expanding-add-volume-expansion.adoc[leveloffset=+1]
+Learn how to expand persistent volumes in {product-title}.
 
 include::modules/storage-expanding-csi-volumes.adoc[leveloffset=+1]
 
-//include::modules/storage-expanding-flexvolume.adoc[leveloffset=+1]
-
 include::modules/storage-expanding-local-volumes.adoc[leveloffset=+1]
 
 include::modules/storage-expanding-filesystem-pvc.adoc[leveloffset=+1]

microshift_storage/index.adoc

@@ -16,20 +16,19 @@ toc::[]
 [id="microshift-ephemeral-storage"]
 === Ephemeral storage
 
-Pods and containers are ephemeral or transient in nature and designed for stateless applications. Ephemeral storage allows administrators and developers to better manage the local storage for some of their operations. For more information about ephemeral storage overview, types, and management, refer to xref:../microshift_storage/understanding-ephemeral-storage-microshift.adoc#understanding-ephemeral-storage-microshift[Understanding ephemeral storage].
+Pods and containers are ephemeral or transient in nature and designed for stateless applications. Ephemeral storage allows administrators and developers to better manage the local storage for some of their operations. To read details about ephemeral storage, click xref:../microshift_storage/understanding-ephemeral-storage-microshift.adoc#understanding-ephemeral-storage-microshift[Understanding ephemeral storage].
 
 [id="microshift-persistent-storage"]
 === Persistent storage
 
-Stateful applications deployed in containers require persistent storage. {product-title} uses a pre-provisioned storage framework called persistent volumes (PV) to allow cluster administrators to provision persistent storage. The data inside these volumes can exist beyond the lifecycle of an individual pod. Developers can use persistent volume claims (PVCs) to request storage requirements. For more information about persistent storage overview, configuration, and lifecycle, refer to xref:../microshift_storage/understanding-persistent-storage-microshift.adoc#understanding-persistent-storage-microshift[Understanding persistent storage].
-
-[id="microshift-container-storage-interface"]
-== Container Storage Interface (CSI)
-
-CSI is an API specification for the management of container storage across different container orchestration (CO) systems. You can manage the storage volumes within the container native environments, without having specific knowledge of the underlying storage infrastructure. With the CSI, storage works uniformly across different container orchestration systems, regardless of the storage vendors you are using. For more information about CSI, refer to xref:../microshift_storage/container_storage_interface_microshift/microshift-persistent-storage-csi.adoc#persistent-storage-csi-microshift[Using Container Storage Interface (CSI) for MicroShift].
+Stateful applications deployed in containers require persistent storage. {product-title} uses a pre-provisioned storage framework called persistent volumes (PV) to allow cluster administrators to provision persistent storage. The data inside these volumes can exist beyond the lifecycle of an individual pod. Developers can use persistent volume claims (PVCs) to request storage requirements. For persistent storage details, read xref:../microshift_storage/understanding-persistent-storage-microshift.adoc#understanding-persistent-storage-microshift[Understanding persistent storage].
 
 [id="microshift-dynamic-provisioning-overview"]
-== Dynamic Provisioning
+=== Dynamic storage provisioning
+
+Using dynamic provisioning allows you to create storage volumes on-demand, eliminating the need for pre-provisioned storage. For more information about how dynamic provisioning works in {product-title}, read xref:../microshift_storage/microshift-storage-plugin-overview.adoc#microshift-storage-plugin-overview[Dynamic provisioning].
 
-Dynamic Provisioning allows you to create storage volumes on-demand, eliminating the need for cluster administrators to pre-provision storage. For more information about dynamic provisioning, refer to xref:../microshift_storage/dynamic-provisioning-microshift.adoc#dynamic-provisioning-microshift[Dynamic provisioning].
+//[id="microshift-container-storage-interface"]
+//== Container Storage Interface (CSI)
 
+//CSI is an API specification for the management of container storage across different container orchestration (CO) systems. You can manage the storage volumes within the container native environments, without having specific knowledge of the underlying storage infrastructure. With the CSI, storage works uniformly across different container orchestration systems, regardless of the storage vendors you are using. For more information about CSI, read ../microshift_storage/container_storage_interface_microshift/microshift-persistent-storage-csi.adoc#persistent-storage-csi-microshift[Using Container Storage Interface (CSI) for MicroShift].

microshift_storage/persistent_storage_microshift/microshift-storage-plugin-overview.adoc renamed to microshift_storage/microshift-storage-plugin-overview.adoc

@@ -1,7 +1,7 @@
 :_content-type: ASSEMBLY
 [id="microshift-storage-plugin-overview"]
-= {product-title} storage plugin overview
-include::_attributes/common-attributes.adoc[]
+= Dynamic storage using the LVMS plugin
+include::_attributes/attributes-microshift.adoc[]
 :context: microshift-storage-plugin-overview
 
 toc::[]
@@ -10,12 +10,12 @@ toc::[]
 
 LVMS provisions new logical volume management (LVM) logical volumes (LVs) for container workloads with appropriately configured persistent volume claims (PVC). Each PVC references a storage class that represents an LVM Volume Group (VG) on the host node. LVs are only provisioned for scheduled pods.
 
-include::modules/microshift-lvms-deployment.adoc[leveloffset=+1]
+include::modules/microshift-lvms-system-requirements.adoc[leveloffset=+1]
 
-include::modules/microshift-lvms-configuring.adoc[leveloffset=+1]
+include::modules/microshift-lvms-deployment.adoc[leveloffset=+1]
 
-include::modules/microshift-setting-lvms-path.adoc[leveloffset=+2]
+include::modules/microshift-lvms-setting-path.adoc[leveloffset=+2]
 
-include::modules/microshift-lvms-system-requirements.adoc[leveloffset=+1]
+include::modules/microshift-lvms-configuring.adoc[leveloffset=+1]
 
 include::modules/microshift-using-lvms.adoc[leveloffset=+1]