Merge pull request #50357 from mjpytlak/osdocs-4117

OSDOCS-4117: Installing an IBM Cloud VPC cluster into an existing VPC

Author: mjpytlak

_topic_maps/_topic_map.yml

@@ -260,6 +260,8 @@ Topics:
     File: installing-ibm-cloud-customizations
   - Name: Installing a cluster on IBM Cloud VPC with network customizations
     File: installing-ibm-cloud-network-customizations
+  - Name: Installing a cluster on IBM Cloud VPC into an existing VPC
+    File: installing-ibm-cloud-vpc
   - Name: Uninstalling a cluster on IBM Cloud VPC
     File: uninstalling-cluster-ibm-cloud
 - Name: Installing on Nutanix

installing/installing-preparing.adoc

@@ -6,7 +6,7 @@ include::_attributes/common-attributes.adoc[]
 
 toc::[]
 
-Before you install {product-title}, decide what kind of installation process to follow and make sure you that you have all of the required resources to prepare the cluster for users.
+Before you install {product-title}, decide what kind of installation process to follow and verify that you have all of the required resources to prepare the cluster for users.
 
 [id="installing-preparing-selecting-cluster-type"]
 == Selecting a cluster installation type
@@ -37,7 +37,7 @@ endif::openshift-origin[]
 * Bare metal or other platform agnostic infrastructure
 // might want a note about single node here
 
-You can deploy an {product-title} 4 cluster to both on-premise hardware and to cloud hosting services, but all of the machines in a cluster must be in the same datacenter or cloud hosting service.
+You can deploy an {product-title} 4 cluster to both on-premise hardware and to cloud hosting services, but all of the machines in a cluster must be in the same data center or cloud hosting service.
 
 If you want to use {product-title} but do not want to manage the cluster yourself, you have several managed service options. If you want a cluster that is fully managed by Red Hat, you can use link:https://www.openshift.com/products/dedicated/[OpenShift Dedicated] or link:https://www.openshift.com/products/online/[OpenShift Online]. You can also use OpenShift as a managed service on Azure, AWS, IBM Cloud VPC, or Google Cloud. For more information about managed services, see the link:https://www.openshift.com/products[OpenShift Products] page.
 
@@ -234,7 +234,7 @@ ifndef::openshift-origin[]
 |
 |
 |
-|
+|xref:../installing/installing_ibm_cloud_public/installing-ibm-cloud-vpc.adoc#installing-ibm-cloud-vpc[✓]
 |
 |
 
@@ -391,7 +391,7 @@ ifdef::openshift-origin[]
 |
 |
 |
-|
+|xref:../installing/installing_ibm_cloud_public/installing-ibm-cloud-vpc.adoc#installing-ibm-cloud-vpc[✓]
 |
 |
 

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

@@ -8,9 +8,6 @@ toc::[]
 
 In environments where the cloud identity and access management (IAM) APIs are not reachable, you must put the Cloud Credential Operator (CCO) into manual mode before you install the cluster.
 
-:FeatureName: IBM Cloud VPC using installer-provisioned infrastructure
-include::snippets/technology-preview.adoc[]
-
 include::modules/alternatives-to-storing-admin-secrets-in-kube-system.adoc[leveloffset=+1]
 
 [role="_additional-resources"]

installing/installing_ibm_cloud_public/installing-ibm-cloud-account.adoc

@@ -8,9 +8,6 @@ toc::[]
 
 Before you can install {product-title}, you must configure an IBM Cloud account.
 
-:FeatureName: IBM Cloud VPC using installer-provisioned infrastructure
-include::snippets/technology-preview.adoc[]
-
 [id="prerequisites_installing-ibm-cloud-account"]
 == Prerequisites
 

installing/installing_ibm_cloud_public/installing-ibm-cloud-customizations.adoc

@@ -8,9 +8,6 @@ toc::[]
 
 In {product-title} version {product-version}, you can install a customized cluster on infrastructure that the installation program provisions on IBM Cloud VPC. To customize the installation, you modify parameters in the `install-config.yaml` file before you install the cluster.
 
-:FeatureName: IBM Cloud VPC using installer-provisioned infrastructure
-include::snippets/technology-preview.adoc[]
-
 [id="prerequisites_installing-ibm-cloud-customizations"]
 == Prerequisites
 

installing/installing_ibm_cloud_public/installing-ibm-cloud-network-customizations.adoc

@@ -11,9 +11,6 @@ customized network configuration on infrastructure that the installation program
 
 You must set most of the network configuration parameters during installation, and you can modify only `kubeProxy` configuration parameters in a running cluster.
 
-:FeatureName: IBM Cloud VPC using installer-provisioned infrastructure
-include::snippets/technology-preview.adoc[]
-
 [id="prerequisites_installing-ibm-cloud-network-customizations"]
 == Prerequisites
 

installing/installing_ibm_cloud_public/installing-ibm-cloud-vpc.adoc

@@ -0,0 +1,61 @@
+:_content-type: ASSEMBLY
+[id="installing-ibm-cloud-vpc"]
+= Installing a cluster on IBM Cloud VPC into an existing VPC
+include::_attributes/common-attributes.adoc[]
+:context: installing-ibm-cloud-vpc
+
+toc::[]
+
+In {product-title} version {product-version}, you can install a cluster into an existing Virtual Private Cloud (VPC) on IBM Cloud VPC. The installation program provisions the rest of the required infrastructure, which you can then further customize. To customize the installation, you modify parameters in the `install-config.yaml` file before you install the cluster.
+
+[id="prerequisites_installing-ibm-cloud-vpc"]
+== 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/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users].
+* You xref:../../installing/installing_ibm_cloud_public/installing-ibm-cloud-account.adoc#installing-ibm-cloud-account[configured an IBM Cloud 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_public/configuring-iam-ibm-cloud.adoc#configuring-iam-ibm-cloud[Configuring IAM for IBM Cloud VPC].
+
+include::modules/installation-custom-ibm-cloud-vpc.adoc[leveloffset=+1]
+
+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]
+
+include::modules/installation-configuration-parameters.adoc[leveloffset=+2]
+
+include::modules/installation-ibm-cloud-config-yaml.adoc[leveloffset=+2]
+
+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-vpc-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-vpc-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-vpc"]
+== Next steps
+* 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].

installing/installing_ibm_cloud_public/preparing-to-install-on-ibm-cloud.adoc

@@ -6,7 +6,7 @@ include::_attributes/common-attributes.adoc[]
 
 toc::[]
 
-The installation workflows documented in this section are for IBM Cloud VPC infrastructure environments. IBM Cloud Classic is not supported at this time. For more information on the difference between Classic and VPC infrastructures, see IBM's link:https://cloud.ibm.com/docs/cloud-infrastructure?topic=cloud-infrastructure-compare-infrastructure[documentation].
+The installation workflows documented in this section are for IBM Cloud VPC infrastructure environments. IBM Cloud Classic is not supported at this time. For more information about the difference between Classic and VPC infrastructures, see the IBM link:https://cloud.ibm.com/docs/cloud-infrastructure?topic=cloud-infrastructure-compare-infrastructure[documentation].
 
 [id="prerequisites_preparing-to-install-on-ibm-cloud"]
 == Prerequisites
@@ -15,9 +15,6 @@ The installation workflows documented in this section are for IBM Cloud VPC infr
 
 * You read the documentation on xref:../../installing/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users].
 
-:FeatureName: IBM Cloud using installer-provisioned infrastructure
-include::snippets/technology-preview.adoc[]
-
 [id="requirements-for-installing-ocp-on-ibm-cloud"]
 == Requirements for installing {product-title} on IBM Cloud VPC
 
@@ -41,6 +38,8 @@ You can install a cluster on IBM Cloud VPC infrastructure that is provisioned by
 
 * **xref:../../installing/installing_ibm_cloud_public/installing-ibm-cloud-network-customizations.adoc#installing-ibm-cloud-network-customizations[Installing a cluster on IBM Cloud VPC with network customizations]**: You can customize your {product-title} network configuration during installation, so that your cluster can coexist with your existing IP address allocations and adhere to your network requirements.
 
+* **xref:../../installing/installing_ibm_cloud_public/installing-ibm-cloud-vpc.adoc#installing-ibm-cloud-vpc[Installing a cluster on IBM Cloud VPC into an existing VPC]**: You can install {product-title} on an existing IBM  Virtual Private Cloud (VPC). You can use this installation method if you have constraints set by the guidelines of your company, such as limits when creating new accounts or infrastructure.
+
 [id="next-steps_preparing-to-install-on-ibm-cloud"]
 == Next steps
 * xref:../../installing/installing_ibm_cloud_public/installing-ibm-cloud-account.adoc#installing-ibm-cloud-account[Configuring an IBM Cloud account]

modules/cli-installing-cli.adoc

@@ -29,6 +29,7 @@
 // * installing/installing_gcp/installing-restricted-networks-gcp-installer-provisioned.adoc
 // * installing/installing_ibm_cloud_public/installing-ibm-cloud-customizations.adoc
 // * installing/installing_ibm_cloud_public/installing-ibm-cloud-network-customizations.adoc
+// * installing/installing_ibm_cloud_public/installing-ibm-cloud-vpc.adoc
 // * installing/install_config/installing-restricted-networks-preparations.adoc
 // * installing/installing_vmc/installing-vmc-user-infra.adoc
 // * installing/installing_vmc/installing-vmc.adoc

modules/cli-logging-in-kubeadmin.adoc

@@ -30,6 +30,7 @@
 // * installing/installing_gcp/installing-restricted-networks-gcp-installer-provisioned.adoc
 // * installing/installing_ibm_cloud_public/installing-ibm-cloud-customizations.adoc
 // * installing/installing_ibm_cloud_public/installing-ibm-cloud-network-customizations.adoc
+// * installing/installing_ibm_cloud_public/installing-ibm-cloud-vpc.adoc
 // * installing/installing_openstack/installing-openstack-installer-custom.adoc
 // * installing/installing_openstack/installing-openstack-installer-kuryr.adoc
 // * installing/installing_openstack/installing-openstack-installer.adoc