Merge pull request #38795 from aireilly/fix-ztp-toc-error

BZ2023789 ZTP toc error

Author: maxwelldb

modules/ztp-acm-preparing-to-install-disconnected-acm.adoc

@@ -11,3 +11,14 @@ Before you can provision distributed units (DU) at scale, you must install {rh-r
 
 You also use a disconnected mirror host to serve the {op-system} ISO and RootFS disk images that provision the DU bare-metal host operating system.
 
+Before you install a cluster on infrastructure that you provision in a restricted network, you must mirror the required container images into that environment. You can also use this procedure in unrestricted networks to ensure your clusters only use container images that have satisfied your organizational controls on external content.
+
+[IMPORTANT]
+====
+You must have access to the internet to obtain the necessary container images.
+In this procedure, you place the mirror registry on a mirror host
+that has access to both your network and the internet. If you do not have access
+to a mirror host, use the disconnected procedure to copy images to a device that you
+can move across network boundaries.
+====
+

modules/ztp-disconnected-environment-prereqs.adoc

@@ -0,0 +1,15 @@
+// Module included in the following assemblies:
+//
+// scalability_and_performance/ztp-deploying-disconnected.adoc
+
+[id="ztp-disconnected-environment-prereqs_{context}"]
+= Disconnected environment prerequisites
+
+You must have a container image registry that supports link:https://docs.docker.com/registry/spec/manifest-v2-2/[Docker v2-2] in the location that will host the {product-title} cluster, such as one of the following registries:
+
+* link:https://www.redhat.com/en/technologies/cloud-computing/quay[Red Hat Quay]
+* link:https://jfrog.com/artifactory/[JFrog Artifactory]
+* link:https://www.sonatype.com/products/repository-oss?topnav=true[Sonatype Nexus Repository]
+* link:https://goharbor.io/[Harbor]
+
+If you have an entitlement to Red Hat Quay, see the documentation on deploying Red Hat Quay link:https://access.redhat.com/documentation/en-us/red_hat_quay/3.5/html/deploy_red_hat_quay_for_proof-of-concept_non-production_purposes/[for proof-of-concept purposes] or link:https://access.redhat.com/documentation/en-us/red_hat_quay/3.5/html/deploy_red_hat_quay_on_openshift_with_the_quay_operator/[by using the Quay Operator]. If you need additional assistance selecting and installing a registry, contact your sales representative or Red Hat support.

modules/ztp-installing-preparing-mirror.adoc

@@ -0,0 +1,8 @@
+// Module included in the following assemblies:
+//
+// scalability_and_performance/ztp-deploying-disconnected.adoc
+
+[id="ztp-installing-preparing-mirror_{context}"]
+= Preparing your mirror host
+
+Before you perform the mirror procedure, you must prepare the host to retrieve content and push it to the remote location.

scalability_and_performance/ztp-deploying-disconnected.adoc

@@ -31,57 +31,30 @@ include::modules/ztp-du-host-networking-requirements.adoc[leveloffset=+1]
 
 include::modules/ztp-acm-preparing-to-install-disconnected-acm.adoc[leveloffset=+1]
 
-Before you install a cluster on infrastructure that you provision in a restricted network, you must mirror the required container images into that environment. You can also use this procedure in unrestricted networks to ensure your clusters only use container images that have satisfied your organizational controls on external content.
-
-[IMPORTANT]
-====
-You must have access to the internet to obtain the necessary container images.
-In this procedure, you place the mirror registry on a mirror host
-that has access to both your network and the internet. If you do not have access
-to a mirror host, use the disconnected procedure to copy images to a device you
-can move across network boundaries with.
-====
-
-[id="prerequisites_installing-mirroring-installation-images_{context}"]
-=== Prerequisites
-
-* You must have a container image registry that supports link:https://docs.docker.com/registry/spec/manifest-v2-2/[Docker v2-2] in the location that will host the {product-title} cluster, such as one of the following registries:
-+
---
-** link:https://www.redhat.com/en/technologies/cloud-computing/quay[Red Hat Quay]
-** link:https://jfrog.com/artifactory/[JFrog Artifactory]
-** link:https://www.sonatype.com/products/repository-oss?topnav=true[Sonatype Nexus Repository]
-** link:https://goharbor.io/[Harbor]
---
-If you have an entitlement to Red Hat Quay, see the documentation on deploying Red Hat Quay link:https://access.redhat.com/documentation/en-us/red_hat_quay/3.5/html/deploy_red_hat_quay_for_proof-of-concept_non-production_purposes/[for proof-of-concept purposes] or link:https://access.redhat.com/documentation/en-us/red_hat_quay/3.5/html/deploy_red_hat_quay_on_openshift_with_the_quay_operator/[by using the Quay Operator]. If you need additional assistance selecting and installing a registry, contact your sales representative or Red Hat support.
+include::modules/ztp-disconnected-environment-prereqs.adoc[leveloffset=+2]
 
 include::modules/installation-about-mirror-registry.adoc[leveloffset=+2]
 
 .Additional resources
 
 For information on viewing the CRI-O logs to view the image source, see xref:../installing/validating-an-installation.html#viewing-the-image-pull-source_validating-an-installation[Viewing the image pull source].
 
-[id="installing-preparing-mirror_{context}"]
-=== Preparing your mirror host
-
-Before you perform the mirror procedure, you must prepare the host to retrieve content
-and push it to the remote location.
+include::modules/ztp-installing-preparing-mirror.adoc[leveloffset=+2]
 
 include::modules/cli-installing-cli.adoc[leveloffset=+3]
 
-include::modules/installation-adding-registry-pull-secret.adoc[leveloffset=+2]
+include::modules/installation-adding-registry-pull-secret.adoc[leveloffset=+3]
 
-include::modules/installation-mirror-repository.adoc[leveloffset=+2]
+include::modules/installation-mirror-repository.adoc[leveloffset=+3]
 
-include::modules/ztp-acm-adding-images-to-mirror-registry.adoc[leveloffset=+2]
+include::modules/ztp-acm-adding-images-to-mirror-registry.adoc[leveloffset=+3]
 
 include::modules/ztp-acm-installing-disconnected-rhacm.adoc[leveloffset=+1]
 
 // AI
 
 include::modules/ztp-ai-install-ocp-clusters-on-bare-metal.adoc[leveloffset=+1]
 
-
 // Custom resources
 
 include::modules/ztp-ztp-custom-resources.adoc[leveloffset=+1]