structure: subdir ibmcloud ipi

_topic_maps/_topic_map.yml

@@ -360,16 +360,20 @@ Topics:
     File: configuring-iam-ibm-cloud
   - Name: User-managed encryption
     File: user-managed-encryption-ibm-cloud
-  - Name: Installing a cluster on IBM Cloud with customizations
-    File: installing-ibm-cloud-customizations
-  - Name: Installing a cluster on IBM Cloud with network customizations
-    File: installing-ibm-cloud-network-customizations
-  - Name: Installing a cluster on IBM Cloud into an existing VPC
-    File: installing-ibm-cloud-vpc
-  - Name: Installing a private cluster on IBM Cloud
-    File: installing-ibm-cloud-private
-  - Name: Installing a cluster on IBM Cloud in a restricted network
-    File: installing-ibm-cloud-restricted
+  - Name: Installer-provisioned infrastructure
+    Dir: ipi
+    Distros: openshift-origin,openshift-enterprise
+    Topics:
+    - Name: Installing a cluster with customizations on IBM Cloud
+      File: installing-ibm-cloud-customizations
+    - Name: Installing a cluster with network customizations on IBM Cloud
+      File: installing-ibm-cloud-network-customizations
+    - Name: Installing a cluster with an existing VPC network on IBM Cloud
+      File: installing-ibm-cloud-vpc
+    - Name: Installing a private cluster with an existing VPC network on IBM Cloud
+      File: installing-ibm-cloud-private
+    - Name: Installing a cluster with a restricted VPC network on IBM Cloud
+      File: installing-ibm-cloud-restricted
   - Name: Installation configuration parameters for IBM Cloud
     File: installation-config-parameters-ibm-cloud-vpc
   - Name: Uninstalling a cluster on IBM Cloud

installing/installing_ibm_cloud/configuring-iam-ibm-cloud.adoc

@@ -24,7 +24,7 @@ include::modules/cco-ccoctl-configuring.adoc[leveloffset=+1]
 
 [id="next-steps_configuring-iam-ibm-cloud"]
 == Next steps
-* xref:../../installing/installing_ibm_cloud/installing-ibm-cloud-customizations.adoc#installing-ibm-cloud-customizations[Installing a cluster on {ibm-cloud-name} with customizations]
+* xref:../../installing/installing_ibm_cloud/ipi/installing-ibm-cloud-customizations.adoc#installing-ibm-cloud-customizations[Installing a cluster on {ibm-cloud-name} with customizations]
 
 [role="_additional-resources"]
 [id="additional-resources_{context}"]

installing/installing_ibm_cloud/ipi/_attributes

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

installing/installing_ibm_cloud/ipi/images

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

installing/installing_ibm_cloud/ipi/installing-ibm-cloud-customizations.adoc

@@ -0,0 +1,78 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/common-attributes.adoc[]
+[id="installing-ibm-cloud-customizations"]
+= Installing a cluster with customizations on {ibm-cloud-title}
+:context: installing-ibm-cloud-customizations
+
+toc::[]
+
+In {product-title} version {product-version}, you can install a
+cluster, with customizations, on infrastructure that the installation program provisions on {ibm-cloud-name}.
+
+To customize the installation, you modify parameters in the `install-config.yaml` file before you install the cluster.
+
+[id="prerequisites_installing-ibm-cloud-customizations"]
+== 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_ibm_cloud/installing-ibm-cloud-account.adoc#installing-ibm-cloud-account[configured an {ibm-cloud-name} 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 configured the `ccoctl` utility before you installed the cluster. For more information, see xref:../../../installing/installing_ibm_cloud/configuring-iam-ibm-cloud.adoc#configuring-iam-ibm-cloud[Configuring IAM for {ibm-cloud-name}].
+
+include::modules/cluster-entitlements.adoc[leveloffset=+1]
+
+include::modules/ssh-agent-using.adoc[leveloffset=+1]
+
+include::modules/installation-obtaining-installer.adoc[leveloffset=+1]
+
+include::modules/installation-ibm-cloud-export-variables.adoc[leveloffset=+1]
+
+include::modules/installation-initializing.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+* xref:../../../installing/installing_ibm_cloud/installation-config-parameters-ibm-cloud-vpc.adoc#installation-config-parameters-ibm-cloud-vpc[Installation configuration parameters for {ibm-cloud-name}]
+
+include::modules/installation-minimum-resource-requirements.adoc[leveloffset=+2]
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../../../scalability_and_performance/optimization/optimizing-storage.adoc#optimizing-storage[Optimizing storage]
+
+include::modules/installation-ibm-cloud-tested-machine-types.adoc[leveloffset=+2]
+
+include::modules/installation-ibm-cloud-config-yaml.adoc[leveloffset=+2]
+
+//.Additional resources
+
+//* ../../machine_management/creating_machinesets/creating-machineset-ibm-cloud.adoc#machineset-enabling-customer-managed-encryption_creating-machineset-ibm-cloud[Enabling customer-managed encryption keys for a compute machine set]
+
+include::modules/installation-configure-proxy.adoc[leveloffset=+2]
+
+include::modules/manually-create-iam-ibm-cloud.adoc[leveloffset=+1]
+
+include::modules/installation-launching-installer.adoc[leveloffset=+1]
+
+include::modules/cli-installing-cli.adoc[leveloffset=+1]
+
+include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+[id="additional-resources_installing-ibm-cloud-customizations-console"]
+.Additional resources
+* xref:../../../web_console/web-console.adoc#web-console[Accessing the web console]
+
+include::modules/cluster-telemetry.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+[id="additional-resources_installing-ibm-cloud-customizations-telemetry"]
+.Additional resources
+* xref:../../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring]
+
+[id="next-steps_installing-ibm-cloud-customizations"]
+== Next steps
+* xref:../../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster].
+* If necessary, you can
+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].