Merge pull request #50561 from mjpytlak/osdocs-4152

OSDOCS-4152: Installing a private cluster on IBM Cloud VPC

Author: mjpytlak

_topic_maps/_topic_map.yml

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

installing/installing-preparing.adoc

@@ -216,7 +216,7 @@ ifndef::openshift-origin[]
 |
 |
 |
-|
+|xref:../installing/installing_ibm_cloud_public/installing-ibm-cloud-private.adoc#installing-ibm-cloud-private[✓]
 |
 |
 
@@ -375,7 +375,7 @@ ifdef::openshift-origin[]
 |
 |
 |
-|
+|xref:../installing/installing_ibm_cloud_public/installing-ibm-cloud-private.adoc#installing-ibm-cloud-private[✓]
 |
 |
 

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

@@ -15,7 +15,16 @@ Before you can install {product-title}, you must configure an IBM Cloud account.
 
 include::modules/quotas-and-limits-ibm-cloud.adoc[leveloffset=+1]
 
-include::modules/installation-cis-ibm-cloud.adoc[leveloffset=+1]
+[id="configuring-dns-resolution"]
+== Configuring DNS resolution
+
+How you configure DNS resolution depends on the type of {product-title} cluster you are installing:
+
+* If you are installing a public cluster, you use IBM Cloud Internet Services (CIS).
+* If you are installing a private cluster, you use IBM Cloud DNS Services (DNS Services)
+
+include::modules/installation-cis-ibm-cloud.adoc[leveloffset=+2]
+include::modules/installation-dns-ibm-cloud.adoc[leveloffset=+2]
 
 include::modules/installation-ibm-cloud-iam-policies-api-key.adoc[leveloffset=+1]
 include::modules/installation-ibm-cloud-creating-api-key.adoc[leveloffset=+2]

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

@@ -29,6 +29,8 @@ include::modules/installation-initializing.adoc[leveloffset=+1]
 
 include::modules/installation-configuration-parameters.adoc[leveloffset=+2]
 
+include::modules/installation-minimum-resource-requirements.adoc[leveloffset=+2]
+
 include::modules/installation-ibm-cloud-config-yaml.adoc[leveloffset=+2]
 
 //.Additional resources

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

@@ -32,6 +32,8 @@ include::modules/installation-initializing.adoc[leveloffset=+1]
 
 include::modules/installation-configuration-parameters.adoc[leveloffset=+2]
 
+include::modules/installation-minimum-resource-requirements.adoc[leveloffset=+2]
+
 include::modules/installation-ibm-cloud-config-yaml.adoc[leveloffset=+2]
 
 //.Additional resources

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

@@ -0,0 +1,67 @@
+:_content-type: ASSEMBLY
+[id="installing-ibm-cloud-private"]
+= Installing a private cluster on IBM Cloud VPC
+include::_attributes/common-attributes.adoc[]
+:context: installing-ibm-cloud-private
+
+toc::[]
+
+In {product-title} version {product-version}, you can install a private cluster into an existing VPC. The installation program provisions the rest of the required infrastructure, which you can 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-private"]
+== 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/private-clusters-default.adoc[leveloffset=+1]
+
+include::modules/private-clusters-about-ibm-cloud.adoc[leveloffset=+1]
+
+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-manual.adoc[leveloffset=+1]
+
+include::modules/installation-configuration-parameters.adoc[leveloffset=+2]
+
+include::modules/installation-minimum-resource-requirements.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-private-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-private-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-private"]
+== 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].

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

@@ -31,6 +31,8 @@ include::modules/installation-initializing.adoc[leveloffset=+1]
 
 include::modules/installation-configuration-parameters.adoc[leveloffset=+2]
 
+include::modules/installation-minimum-resource-requirements.adoc[leveloffset=+2]
+
 include::modules/installation-ibm-cloud-config-yaml.adoc[leveloffset=+2]
 
 include::modules/installation-configure-proxy.adoc[leveloffset=+2]

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

@@ -40,6 +40,8 @@ You can install a cluster on IBM Cloud VPC infrastructure that is provisioned by
 
 * **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.
 
+* **xref:../../installing/installing_ibm_cloud_public/installing-ibm-cloud-private.adoc#installing-ibm-cloud-private[Installing a private cluster on an existing VPC]**: You can install a private cluster on an existing Virtual Private Cloud (VPC). You can use this method to deploy {product-title} on an internal network that is not visible to the internet.
+
 [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

@@ -30,6 +30,7 @@
 // * 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_ibm_cloud_public/installing-ibm-cloud-private.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

@@ -31,6 +31,7 @@
 // * 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_ibm_cloud_public/installing-ibm-cloud-private.adoc
 // * installing/installing_openstack/installing-openstack-installer-custom.adoc
 // * installing/installing_openstack/installing-openstack-installer-kuryr.adoc
 // * installing/installing_openstack/installing-openstack-installer.adoc