Merge pull request #80041 from brendan-daly-red-hat/OSDOCS-11417

OSDOCS-11417#Reworking ASH topic map/TOC, creating IPI and UPI directories, updating 'Preparing to install a cluster' assembly

Author: jab-rh

_topic_maps/_topic_map.yml

@@ -253,19 +253,31 @@ Topics:
   Dir: installing_azure_stack_hub
   Distros: openshift-origin,openshift-enterprise
   Topics:
-  - Name: Preparing to install on Azure Stack Hub
+  - Name: Installation methods
     File: preparing-to-install-on-azure-stack-hub
   - Name: Configuring an Azure Stack Hub account
     File: installing-azure-stack-hub-account
-  - Name: Installing a cluster on Azure Stack Hub with an installer-provisioned infrastructure
-    File: installing-azure-stack-hub-default
-  - Name: Installing a cluster on Azure Stack Hub with network customizations
-    File: installing-azure-stack-hub-network-customizations
-  - Name: Installing a cluster on Azure Stack Hub using ARM templates
-    File: installing-azure-stack-hub-user-infra
-  - Name: Installation configuration parameters for Azure Stack Hub
+  - Name: Installer-provisioned infrastructure
+    Dir: ipi
+    Distros: openshift-origin,openshift-enterprise
+    Topics:
+    - Name: Preparing to install a cluster
+      File: ipi-ash-preparing-to-install
+    - Name: Installing a cluster
+      File: installing-azure-stack-hub-default
+    - Name: Installing a cluster with network customizations
+      File: installing-azure-stack-hub-network-customizations
+  - Name: User-provisioned infrastructure
+    Dir: upi
+    Distros: openshift-origin,openshift-enterprise
+    Topics:
+    - Name: Preparing to install a cluster
+      File: upi-ash-preparing-to-install
+    - Name: Installing a cluster using ARM templates
+      File: installing-azure-stack-hub-user-infra
+  - Name: Installation configuration parameters
     File: installation-config-parameters-ash
-  - Name: Uninstalling a cluster on Azure Stack Hub
+  - Name: Uninstalling a cluster
     File: uninstalling-cluster-azure-stack-hub
 - Name: Installing on GCP
   Dir: installing_gcp

installing/installing_azure_stack_hub/installing-azure-stack-hub-account.adoc

@@ -18,7 +18,7 @@ include::modules/installation-azure-limits.adoc[leveloffset=+1]
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../../scalability_and_performance/optimization/optimizing-storage.adoc#optimizing-storage[Optimizing storage].
+* xref:../../scalability_and_performance/optimization/optimizing-storage.adoc#optimizing-storage[Optimizing storage]
 
 include::modules/installation-azure-stack-hub-network-config.adoc[leveloffset=+1]
 
@@ -29,11 +29,11 @@ include::modules/installation-azure-service-principal.adoc[leveloffset=+1]
 [role="_additional-resources"]
 .Additional resources
 
-* For more information about CCO modes, see xref:../../authentication/managing_cloud_provider_credentials/about-cloud-credential-operator.adoc#about-cloud-credential-operator-modes[About the Cloud Credential Operator].
+* xref:../../authentication/managing_cloud_provider_credentials/about-cloud-credential-operator.adoc#about-cloud-credential-operator-modes[About the Cloud Credential Operator]
 
 [id="next-steps_installing-azure-stack-hub-account"]
 == Next steps
 
 * Install an {product-title} cluster:
-** xref:../../installing/installing_azure_stack_hub/installing-azure-stack-hub-default.adoc#installing-azure-stack-hub-default[Installing a cluster quickly on Azure Stack Hub].
-** Install an {product-title} cluster on Azure Stack Hub with user-provisioned infrastructure by following xref:../../installing/installing_azure_stack_hub/installing-azure-stack-hub-user-infra.adoc#installing-azure-stack-hub-user-infra[Installing a cluster on Azure Stack Hub using ARM templates].
+** xref:../../installing/installing_azure_stack_hub/ipi/installing-azure-stack-hub-default.adoc#installing-azure-stack-hub-default[Installing a cluster on Azure Stack Hub with customizations]
+** Install an {product-title} cluster on Azure Stack Hub with user-provisioned infrastructure by following xref:../../installing/installing_azure_stack_hub/upi/installing-azure-stack-hub-user-infra.adoc#installing-azure-stack-hub-user-infra[Installing a cluster on Azure Stack Hub using ARM templates].

installing/installing_azure_stack_hub/installing-azure-stack-hub-default.adoc

@@ -0,0 +1 @@
+../../../_attributes

installing/installing_azure_stack_hub/installing-azure-stack-hub-network-customizations.adoc

@@ -0,0 +1 @@
+../../../images

installing/installing_azure_stack_hub/ipi/_attributes

@@ -0,0 +1,61 @@
+:_mod-docs-content-type: ASSEMBLY
+[id="installing-azure-stack-hub-default"]
+= Installing a cluster on Azure Stack Hub with customizations
+include::_attributes/common-attributes.adoc[]
+:context: installing-azure-stack-hub-default
+
+toc::[]
+
+In {product-title} version {product-version}, you can install a cluster on Microsoft Azure Stack Hub with an installer-provisioned infrastructure. However, you must manually configure the `install-config.yaml` file to specify values that are specific to Azure Stack Hub.
+
+[NOTE]
+====
+While you can select `azure` when using the installation program to deploy a cluster using installer-provisioned infrastructure, this option is only supported for the Azure Public Cloud.
+====
+
+[id="prerequisites_installing-azure-stack-hub-default-ipi"]
+== Prerequisites
+
+* You reviewed details about the xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes.
+* You read the documentation on xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users].
+* You xref:../../../installing/installing_azure_stack_hub/installing-azure-stack-hub-account.adoc#installing-azure-stack-hub-account[configured an Azure Stack Hub account] to host the cluster.
+* If you use a firewall, you xref:../../../installing/install_config/configuring-firewall.adoc#configuring-firewall[configured it to allow the sites] that your cluster requires access to.
+* You verified that you have approximately 16 GB of local disk space. Installing the cluster requires that you download the {op-system} virtual hard drive (VHD) cluster image and upload it to your Azure Stack Hub environment so that it is accessible during deployment. Decompressing the VHD files requires this amount of local disk space.
+
+include::modules/installation-azure-user-infra-uploading-rhcos.adoc[leveloffset=+1]
+
+include::modules/installation-initializing-manual.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+* xref:../../../installing/installing_azure_stack_hub/installation-config-parameters-ash.adoc#installation-config-parameters-ash[Installation configuration parameters for Azure Stack Hub]
+
+include::modules/installation-azure-stack-hub-config-yaml.adoc[leveloffset=+2]
+
+include::modules/manually-create-identity-access-management.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+[id="additional-resources_installing-azure-stack-hub-default-cco"]
+.Additional resources
+* xref:../../../updating/preparing_for_updates/preparing-manual-creds-update.adoc#manually-maintained-credentials-upgrade_preparing-manual-creds-update[Updating cloud provider resources with manually maintained credentials]
+
+include::modules/azure-stack-hub-internal-ca.adoc[leveloffset=+1]
+
+include::modules/installation-launching-installer.adoc[leveloffset=+1]
+
+include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1]
+
+include::modules/logging-in-by-using-the-web-console.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+[id="additional-resources_installing-azure-stack-hub-default-console"]
+.Additional resources
+* xref:../../../web_console/web-console.adoc#web-console[Accessing the web console]
+
+[id="next-steps_installing-azure-stack-hub-default-ipi"]
+== Next steps
+
+* xref:../../../installing/validation_and_troubleshooting/validating-an-installation.adoc#validating-an-installation[Validating an installation]
+* xref:../../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster]
+* Optional: xref:../../../support/remote_health_monitoring/opting-out-of-remote-health-reporting.adoc#opting-out-remote-health-reporting_opting-out-remote-health-reporting[Opt out of remote health reporting]
+* Optional: xref:../../../post_installation_configuration/changing-cloud-credentials-configuration.adoc#manually-removing-cloud-creds_changing-cloud-credentials-configuration[Remove cloud provider credentials]