1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00

Installing a cluster on VMC

This commit is contained in:
Cody Hoag
2021-02-19 16:45:06 -05:00
parent c2d94adbf4
commit 0d625be4a9
56 changed files with 1056 additions and 40 deletions

View File

@@ -312,6 +312,23 @@ Topics:
File: uninstalling-cluster-vsphere-installer-provisioned
- Name: Using the vSphere Problem Detector Operator
File: using-vsphere-problem-detector-operator
- Name: Installing on VMC
Dir: installing_vmc
Topics:
- Name: Installing a cluster on VMC
File: installing-vmc
- Name: Installing a cluster on VMC with customizations
File: installing-vmc-customizations
- Name: Installing a cluster on VMC with network customizations
File: installing-vmc-network-customizations
- Name: Installing a cluster on VMC with user-provisioned infrastructure
File: installing-vmc-user-infra
- Name: Installing a cluster on VMC with user-provisioned infrastructure and network customizations
File: installing-vmc-network-customizations-user-infra
- Name: Installing a cluster on VMC in a restricted network with user-provisioned infrastructure
File: installing-restricted-networks-vmc-user-infra
- Name: Uninstalling a cluster on VMC
File: uninstalling-cluster-vmc
- Name: Installing on any platform
Dir: installing_platform_agnostic
Topics:

File diff suppressed because one or more lines are too long

After

Width:  |  Height:  |  Size: 9.0 KiB

View File

@@ -24,6 +24,7 @@ If you want to install and manage {product-title} yourself, you can install it o
* IBM Z and LinuxONE
* IBM Power
* VMware vSphere
* VMware Cloud (VMC) on AWS
* Bare metal or other platform agnostic infrastructure
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.
@@ -99,10 +100,10 @@ Not all installation options are supported for all platforms, as shown in the fo
.Installer-provisioned infrastructure options
|===
ifndef::openshift-origin[]
||AWS |Azure |GCP |OpenStack |RHV |Bare metal |vSphere |IBM Z |IBM Power
||AWS |Azure |GCP |OpenStack |RHV |Bare metal |vSphere |VMC |IBM Z |IBM Power
endif::openshift-origin[]
ifdef::openshift-origin[]
||AWS |Azure |GCP |OpenStack |oVirt |Bare metal |vSphere |IBM Z |IBM Power
||AWS |Azure |GCP |OpenStack |oVirt |Bare metal |vSphere |VMC |IBM Z |IBM Power
endif::openshift-origin[]
|Default
@@ -113,6 +114,7 @@ endif::openshift-origin[]
|xref:../installing/installing_rhv/installing-rhv-default.adoc#installing-rhv-default[X]
|xref:../installing/installing_bare_metal_ipi/ipi-install-overview.adoc#ipi-install-overview[X]
|xref:../installing/installing_vsphere/installing-vsphere-installer-provisioned.adoc#installing-vsphere-installer-provisioned[X]
|xref:../installing/installing_vmc/installing-vmc.adoc#installing-vmc[X]
|
|
@@ -124,6 +126,7 @@ endif::openshift-origin[]
|xref:../installing/installing_rhv/installing-rhv-customizations.adoc#installing-rhv-customizations[X]
|
|xref:../installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc#installing-vsphere-installer-provisioned-customizations[X]
|xref:../installing/installing_vmc/installing-vmc-customizations.adoc#installing-vmc-customizations[X]
|
|
@@ -135,6 +138,7 @@ endif::openshift-origin[]
|
|
|xref:../installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc#installing-vsphere-installer-provisioned-network-customizations[X]
|xref:../installing/installing_vmc/installing-vmc-network-customizations.adoc#installing-vmc-network-customizations[X]
|
|
@@ -148,6 +152,7 @@ endif::openshift-origin[]
|
|
|
|
|Private clusters
|xref:../installing/installing_aws/installing-aws-private.adoc#installing-aws-private[X]
@@ -159,6 +164,7 @@ endif::openshift-origin[]
|
|
|
|
|Existing virtual private networks
|xref:../installing/installing_aws/installing-aws-vpc.adoc#installing-aws-vpc[X]
@@ -170,6 +176,7 @@ endif::openshift-origin[]
|
|
|
|
|Government regions
|xref:../installing/installing_aws/installing-aws-government-region.adoc#installing-aws-government-region[X]
@@ -181,16 +188,17 @@ endif::openshift-origin[]
|
|
|
|
|===
.User-provisioned infrastructure options
|===
ifndef::openshift-origin[]
||AWS |Azure |GCP |OpenStack |RHV |Bare metal |vSphere |IBM Z |IBM Power
||AWS |Azure |GCP |OpenStack |RHV |Bare metal |vSphere |VMC |IBM Z |IBM Power
endif::openshift-origin[]
ifdef::openshift-origin[]
||AWS |Azure |GCP |OpenStack |oVirt |Bare metal |vSphere |IBM Z |IBM Power
||AWS |Azure |GCP |OpenStack |oVirt |Bare metal |vSphere |VMC |IBM Z |IBM Power
endif::openshift-origin[]
|Custom
@@ -201,6 +209,7 @@ endif::openshift-origin[]
|xref:../installing/installing_rhv/installing-rhv-user-infra.adoc#installing-rhv-user-infra[X]
|xref:../installing/installing_bare_metal/installing-bare-metal.adoc#installing-bare-metal[X]
|xref:../installing/installing_vsphere/installing-vsphere.adoc#installing-vsphere[X]
|xref:../installing/installing_vmc/installing-vmc-user-infra.adoc#installing-vmc-user-infra[X]
|xref:../installing/installing_ibm_z/installing-ibm-z.adoc#installing-ibm-z[X]
|xref:../installing/installing_ibm_power/installing-ibm-power.adoc#installing-ibm-power[X]
@@ -214,6 +223,7 @@ endif::openshift-origin[]
|
|xref:../installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc#installing-bare-metal-network-customizations[X]
|xref:../installing/installing_vsphere/installing-vsphere-network-customizations.adoc#installing-vsphere-network-customizations[X]
|xref:../installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc#installing-vmc-network-customizations-user-infra[X]
|
|
@@ -225,6 +235,7 @@ endif::openshift-origin[]
|
|xref:../installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc#installing-restricted-networks-bare-metal[X]
|xref:../installing/installing_vsphere/installing-restricted-networks-vsphere.adoc#installing-restricted-networks-vsphere[X]
|xref:../installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc#installing-restricted-networks-vmc-user-infra[X]
|xref:../installing/installing_ibm_z/installing-restricted-networks-ibm-z.adoc#installing-restricted-networks-ibm-z[X]
|xref:../installing/installing_ibm_power/installing-restricted-networks-ibm-power.adoc#installing-restricted-networks-ibm-power[X]

View File

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

View File

@@ -0,0 +1,103 @@
[id="installing-restricted-networks-vmc-user-infra"]
= Installing a cluster on VMC in a restricted network with user-provisioned infrastructure
include::modules/common-attributes.adoc[]
:context: installing-restricted-networks-vmc-user-infra
toc::[]
In {product-title} version {product-version}, you can install a cluster on VMware vSphere infrastructure that you provision in a restricted network by deploying it to link:https://cloud.vmware.com/vmc-aws[VMware Cloud (VMC) on AWS].
Once you configure your VMC environment for {product-title} deployment, you use the {product-title} installation program from the bastion management host, co-located in the VMC environment. The installation program and control plane automates the process of deploying and managing the resources needed for the {product-title} cluster.
include::modules/setting-up-vmc-for-vsphere.adoc[leveloffset=+1]
include::modules/vmc-sizer-tool.adoc[leveloffset=+2]
== vSphere prerequisites
* xref:../../installing/install_config/installing-restricted-networks-preparations.adoc#installing-restricted-networks-preparations[Create a registry on your mirror host] and obtain the `imageContentSources` data for your version of {product-title}.
+
[IMPORTANT]
====
Because the installation media is on the mirror host, you can use that computer
to complete all installation steps.
====
* Provision xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#installation-registry-storage-block-recreate-rollout_configuring-registry-storage-vsphere[block registry storage]. For more information on persistent storage, see xref:../../storage/understanding-persistent-storage.adoc#understanding-persistent-storage[Understanding persistent storage].
* Review details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes.
* If you use a firewall and plan to use telemetry, you must xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall[configure the firewall to allow the sites] that your cluster requires access to.
+
[NOTE]
====
Be sure to also review this site list if you are configuring a proxy.
====
include::modules/installation-about-restricted-network.adoc[leveloffset=+1]
include::modules/cluster-entitlements.adoc[leveloffset=+1]
include::modules/installation-vsphere-infrastructure.adoc[leveloffset=+1]
include::modules/installation-requirements-user-infra.adoc[leveloffset=+1]
include::modules/installation-infrastructure-user-infra.adoc[leveloffset=+1]
include::modules/installation-network-user-infra.adoc[leveloffset=+2]
include::modules/installation-dns-user-infra.adoc[leveloffset=+2]
include::modules/ssh-agent-using.adoc[leveloffset=+1]
//You extract the installation program from the mirrored content.
//You can install the CLI on the mirror host.
include::modules/installation-initializing-manual.adoc[leveloffset=+1]
include::modules/installation-vsphere-config-yaml.adoc[leveloffset=+2]
include::modules/installation-configure-proxy.adoc[leveloffset=+2]
//include::modules/installation-three-node-cluster.adoc[leveloffset=+2]
include::modules/installation-user-infra-generate-k8s-manifest-ignition.adoc[leveloffset=+1]
include::modules/installation-extracting-infraid.adoc[leveloffset=+1]
include::modules/installation-vsphere-machines.adoc[leveloffset=+1]
include::modules/machine-vsphere-machines.adoc[leveloffset=+1]
include::modules/installation-disk-partitioning.adoc[leveloffset=+1]
include::modules/architecture-rhcos-updating-bootloader.adoc[leveloffset=+1]
include::modules/installation-installing-bare-metal.adoc[leveloffset=+1]
include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1]
include::modules/installation-approve-csrs.adoc[leveloffset=+1]
include::modules/installation-operators-config.adoc[leveloffset=+1]
include::modules/installation-registry-storage-config.adoc[leveloffset=+2]
include::modules/registry-configuring-storage-vsphere.adoc[leveloffset=+3]
include::modules/installation-registry-storage-non-production.adoc[leveloffset=+3]
include::modules/installation-registry-storage-block-recreate-rollout.adoc[leveloffset=+3]
For instructions about configuring registry storage so that it references the correct PVC, see xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#registry-configuring-storage-vsphere_configuring-registry-storage-vsphere[Configuring registry storage for VMware vSphere].
include::modules/installation-complete-user-infra.adoc[leveloffset=+1]
You can add extra compute machines after the cluster installation is completed by following xref:../../machine_management/user_infra/adding-vsphere-compute-user-infra.adoc#adding-vsphere-compute-user-infra[Adding compute machines to vSphere].
include::modules/persistent-storage-vsphere-backup.adoc[leveloffset=+1]
== Next steps
* xref:../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster].
* If the mirror registry that you used to install your cluster has a trusted CA, add it to the cluster by xref:../../openshift_images/image-configuration.adoc#images-configuration-cas_image-configuration[configuring additional trust stores].
* 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].
* Optional: xref:../../installing/installing_vsphere/using-vsphere-problem-detector-operator.adoc#vsphere-problem-detector-viewing-events_vsphere-problem-detector[View the events from the vSphere Problem Detector Operator] to determine if the cluster has permission or storage configuration issues.

View File

@@ -0,0 +1,75 @@
[id="installing-vmc-customizations"]
= Installing a cluster on VMC with customizations
include::modules/common-attributes.adoc[]
:context: installing-vmc-customizations
toc::[]
In {product-title} version {product-version}, you can install a cluster on your VMware vSphere instance using installer-provisioned infrastructure by deploying it to link:https://cloud.vmware.com/vmc-aws[VMware Cloud (VMC) on AWS].
Once you configure your VMC environment for {product-title} deployment, you use the {product-title} installation program from the bastion management host, co-located in the VMC environment. The installation program and control plane automates the process of deploying and managing the resources needed for the {product-title} cluster.
To customize the {product-title} installation, you modify parameters in the `install-config.yaml` file before you install the cluster.
include::modules/setting-up-vmc-for-vsphere.adoc[leveloffset=+1]
include::modules/vmc-sizer-tool.adoc[leveloffset=+2]
== vSphere prerequisites
* Provision xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#installation-registry-storage-block-recreate-rollout_configuring-registry-storage-vsphere[block registry storage]. For more information on persistent storage, see xref:../../storage/understanding-persistent-storage.adoc#understanding-persistent-storage[Understanding persistent storage].
* Review details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes.
* If you use a firewall, you must xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall[configure it to allow the sites] that your cluster requires access to.
+
[NOTE]
====
Be sure to also review this site list if you are configuring a proxy.
====
include::modules/cluster-entitlements.adoc[leveloffset=+1]
include::modules/installation-vsphere-infrastructure.adoc[leveloffset=+1]
include::modules/installation-vsphere-installer-infra-requirements.adoc[leveloffset=+1]
include::modules/ssh-agent-using.adoc[leveloffset=+1]
include::modules/installation-obtaining-installer.adoc[leveloffset=+1]
include::modules/installation-adding-vcenter-root-certificates.adoc[leveloffset=+1]
include::modules/installation-initializing.adoc[leveloffset=+1]
include::modules/installation-configuration-parameters.adoc[leveloffset=+2]
include::modules/installation-installer-provisioned-vsphere-config-yaml.adoc[leveloffset=+2]
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]
[id="installing-vmc-customizations-registry"]
== Creating registry storage
After you install the cluster, you must create storage for the Registry Operator.
include::modules/registry-removed.adoc[leveloffset=+2]
include::modules/installation-registry-storage-config.adoc[leveloffset=+2]
include::modules/registry-configuring-storage-vsphere.adoc[leveloffset=+3]
include::modules/installation-registry-storage-block-recreate-rollout.adoc[leveloffset=+3]
For instructions about configuring registry storage so that it references the correct PVC, see xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#registry-configuring-storage-vsphere_configuring-registry-storage-vsphere[Configuring the registry for vSphere].
include::modules/persistent-storage-vsphere-backup.adoc[leveloffset=+1]
== 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].
* xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#configuring-registry-storage-vsphere[Set up your registry and configure registry storage].
* Optional: xref:../../installing/installing_vsphere/using-vsphere-problem-detector-operator.adoc#vsphere-problem-detector-viewing-events_vsphere-problem-detector[View the events from the vSphere Problem Detector Operator] to determine if the cluster has permission or storage configuration issues.

View File

@@ -0,0 +1,90 @@
[id="installing-vmc-network-customizations-user-infra"]
= Installing a cluster on VMC with user-provisioned infrastructure and network customizations
include::modules/common-attributes.adoc[]
:context: installing-vmc-network-customizations-user-infra
toc::[]
In {product-title} version {product-version}, you can install a cluster on your VMware vSphere instance using infrastructure you provision with customized network configuration options by deploying it to link:https://cloud.vmware.com/vmc-aws[VMware Cloud (VMC) on AWS].
Once you configure your VMC environment for {product-title} deployment, you use the {product-title} installation program from the bastion management host, co-located in the VMC environment. The installation program and control plane automates the process of deploying and managing the resources needed for the {product-title} cluster.
By customizing your network configuration, your cluster can coexist with existing IP address allocations in your environment and integrate with existing VXLAN configurations. You must set most of the network configuration parameters during installation, and you can modify only `kubeProxy` configuration parameters in a running cluster.
include::modules/setting-up-vmc-for-vsphere.adoc[leveloffset=+1]
include::modules/vmc-sizer-tool.adoc[leveloffset=+2]
== vSphere prerequisites
* Provision xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#installation-registry-storage-block-recreate-rollout_configuring-registry-storage-vsphere[block registry storage]. For more information on persistent storage, see xref:../../storage/understanding-persistent-storage.adoc#understanding-persistent-storage[Understanding persistent storage].
* Review details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes.
* If you use a firewall, you must xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall[configure it to access Red Hat Insights].
include::modules/cluster-entitlements.adoc[leveloffset=+1]
include::modules/installation-vsphere-infrastructure.adoc[leveloffset=+1]
include::modules/installation-requirements-user-infra.adoc[leveloffset=+1]
include::modules/installation-infrastructure-user-infra.adoc[leveloffset=+1]
include::modules/installation-network-user-infra.adoc[leveloffset=+2]
include::modules/installation-dns-user-infra.adoc[leveloffset=+2]
include::modules/ssh-agent-using.adoc[leveloffset=+1]
include::modules/installation-obtaining-installer.adoc[leveloffset=+1]
include::modules/installation-initializing-manual.adoc[leveloffset=+1]
include::modules/installation-vsphere-config-yaml.adoc[leveloffset=+2]
include::modules/nw-install-config-parameters.adoc[leveloffset=+2]
// Network Operator specific configuration
include::modules/nw-modifying-operator-install-config.adoc[leveloffset=+1]
include::modules/nw-operator-cr.adoc[leveloffset=+1]
include::modules/installation-generate-ignition-configs.adoc[leveloffset=+1]
include::modules/installation-extracting-infraid.adoc[leveloffset=+1]
include::modules/installation-vsphere-machines.adoc[leveloffset=+1]
include::modules/machine-vsphere-machines.adoc[leveloffset=+1]
include::modules/installation-disk-partitioning.adoc[leveloffset=+1]
include::modules/architecture-rhcos-updating-bootloader.adoc[leveloffset=+1]
include::modules/installation-installing-bare-metal.adoc[leveloffset=+1]
include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1]
include::modules/installation-approve-csrs.adoc[leveloffset=+1]
include::modules/installation-operators-config.adoc[leveloffset=+1]
include::modules/registry-removed.adoc[leveloffset=+2]
include::modules/installation-registry-storage-config.adoc[leveloffset=+2]
include::modules/installation-registry-storage-block-recreate-rollout.adoc[leveloffset=+3]
For instructions about configuring registry storage so that it references the correct PVC, see xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#registry-configuring-storage-vsphere_configuring-registry-storage-vsphere[Configuring the registry for vSphere].
include::modules/installation-complete-user-infra.adoc[leveloffset=+1]
You can add extra compute machines after the cluster installation is completed by following xref:../../machine_management/user_infra/adding-vsphere-compute-user-infra.adoc#adding-vsphere-compute-user-infra[Adding compute machines to vSphere].
include::modules/persistent-storage-vsphere-backup.adoc[leveloffset=+1]
== 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].
* xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#configuring-registry-storage-vsphere[Set up your registry and configure registry storage].
* Optional: xref:../../installing/installing_vsphere/using-vsphere-problem-detector-operator.adoc#vsphere-problem-detector-viewing-events_vsphere-problem-detector[View the events from the vSphere Problem Detector Operator] to determine if the cluster has permission or storage configuration issues.

View File

@@ -0,0 +1,82 @@
[id="installing-vmc-network-customizations"]
= Installing a cluster on VMC with network customizations
include::modules/common-attributes.adoc[]
:context: installing-vmc-network-customizations
toc::[]
In {product-title} version {product-version}, you can install a cluster on your VMware vSphere instance using installer-provisioned infrastructure with customized network configuration options by deploying it to link:https://cloud.vmware.com/vmc-aws[VMware Cloud (VMC) on AWS].
Once you configure your VMC environment for {product-title} deployment, you use the {product-title} installation program from the bastion management host, co-located in the VMC environment. The installation program and control plane automates the process of deploying and managing the resources needed for the {product-title} cluster.
By customizing your {product-title} network configuration, your cluster can coexist with existing IP address allocations in your environment and integrate with existing VXLAN configurations. To customize the installation, you modify parameters in the `install-config.yaml` file before you install the cluster. You must set most of the network configuration parameters during installation, and you can modify only `kubeProxy` configuration parameters in a running cluster.
include::modules/setting-up-vmc-for-vsphere.adoc[leveloffset=+1]
include::modules/vmc-sizer-tool.adoc[leveloffset=+2]
== vSphere prerequisites
* Provision xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#installation-registry-storage-block-recreate-rollout_configuring-registry-storage-vsphere[block registry storage]. For more information on persistent storage, see xref:../../storage/understanding-persistent-storage.adoc#understanding-persistent-storage[Understanding persistent storage].
* Review details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes.
* If you use a firewall, you must xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall[configure it to allow the sites] that your cluster requires access to.
+
[NOTE]
====
Be sure to also review this site list if you are configuring a proxy.
====
include::modules/cluster-entitlements.adoc[leveloffset=+1]
include::modules/installation-vsphere-infrastructure.adoc[leveloffset=+1]
include::modules/installation-vsphere-installer-infra-requirements.adoc[leveloffset=+1]
include::modules/ssh-agent-using.adoc[leveloffset=+1]
include::modules/installation-obtaining-installer.adoc[leveloffset=+1]
include::modules/installation-adding-vcenter-root-certificates.adoc[leveloffset=+1]
include::modules/installation-initializing.adoc[leveloffset=+1]
include::modules/installation-configuration-parameters.adoc[leveloffset=+2]
// additional install-config network parameters
include::modules/nw-install-config-parameters.adoc[leveloffset=+2]
include::modules/installation-installer-provisioned-vsphere-config-yaml.adoc[leveloffset=+2]
// begin network customization
include::modules/nw-modifying-operator-install-config.adoc[leveloffset=+1]
include::modules/nw-operator-cr.adoc[leveloffset=+1]
// end network customization
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]
[id="installing-vmc-network-customizations-registry"]
== Creating registry storage
After you install the cluster, you must create storage for the registry Operator.
include::modules/registry-removed.adoc[leveloffset=+2]
include::modules/installation-registry-storage-config.adoc[leveloffset=+2]
include::modules/registry-configuring-storage-vsphere.adoc[leveloffset=+3]
include::modules/installation-registry-storage-block-recreate-rollout.adoc[leveloffset=+3]
For instructions about configuring registry storage so that it references the correct PVC, see xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#registry-configuring-storage-vsphere_configuring-registry-storage-vsphere[Configuring the registry for vSphere].
include::modules/persistent-storage-vsphere-backup.adoc[leveloffset=+1]
== 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].
* xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#configuring-registry-storage-vsphere[Set up your registry and configure registry storage].
* Optional: xref:../../installing/installing_vsphere/using-vsphere-problem-detector-operator.adoc#vsphere-problem-detector-viewing-events_vsphere-problem-detector[View the events from the vSphere Problem Detector Operator] to determine if the cluster has permission or storage configuration issues.

View File

@@ -0,0 +1,96 @@
[id="installing-vmc-user-infra"]
= Installing a cluster on VMC with user-provisioned infrastructure
include::modules/common-attributes.adoc[]
:context: installing-vmc-user-infra
toc::[]
In {product-title} version {product-version}, you can install a cluster on VMware vSphere infrastructure that you provision by deploying it to link:https://cloud.vmware.com/vmc-aws[VMware Cloud (VMC) on AWS].
Once you configure your VMC environment for {product-title} deployment, you use the {product-title} installation program from the bastion management host, co-located in the VMC environment. The installation program and control plane automates the process of deploying and managing the resources needed for the {product-title} cluster.
include::modules/setting-up-vmc-for-vsphere.adoc[leveloffset=+1]
include::modules/vmc-sizer-tool.adoc[leveloffset=+2]
== vSphere prerequisites
* Provision xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#installation-registry-storage-block-recreate-rollout_configuring-registry-storage-vsphere[block registry storage]. For more information on persistent storage, see xref:../../storage/understanding-persistent-storage.adoc#understanding-persistent-storage[Understanding persistent storage].
* Review details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes.
* If you use a firewall, you must xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall[configure it to allow the sites] that your cluster requires access to.
+
[NOTE]
====
Be sure to also review this site list if you are configuring a proxy.
====
include::modules/cluster-entitlements.adoc[leveloffset=+1]
include::modules/installation-vsphere-infrastructure.adoc[leveloffset=+1]
include::modules/installation-requirements-user-infra.adoc[leveloffset=+1]
include::modules/installation-infrastructure-user-infra.adoc[leveloffset=+1]
include::modules/installation-network-user-infra.adoc[leveloffset=+2]
include::modules/installation-dns-user-infra.adoc[leveloffset=+2]
include::modules/ssh-agent-using.adoc[leveloffset=+1]
include::modules/installation-obtaining-installer.adoc[leveloffset=+1]
include::modules/installation-initializing-manual.adoc[leveloffset=+1]
include::modules/installation-vsphere-config-yaml.adoc[leveloffset=+2]
include::modules/installation-configure-proxy.adoc[leveloffset=+2]
//include::modules/installation-three-node-cluster.adoc[leveloffset=+2]
include::modules/installation-user-infra-generate-k8s-manifest-ignition.adoc[leveloffset=+1]
include::modules/installation-extracting-infraid.adoc[leveloffset=+1]
include::modules/installation-vsphere-machines.adoc[leveloffset=+1]
include::modules/machine-vsphere-machines.adoc[leveloffset=+1]
include::modules/installation-disk-partitioning.adoc[leveloffset=+1]
include::modules/architecture-rhcos-updating-bootloader.adoc[leveloffset=+1]
include::modules/cli-installing-cli.adoc[leveloffset=+1]
include::modules/installation-installing-bare-metal.adoc[leveloffset=+1]
include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1]
include::modules/installation-approve-csrs.adoc[leveloffset=+1]
include::modules/installation-operators-config.adoc[leveloffset=+1]
include::modules/registry-removed.adoc[leveloffset=+2]
include::modules/installation-registry-storage-config.adoc[leveloffset=+2]
include::modules/registry-configuring-storage-vsphere.adoc[leveloffset=+3]
include::modules/installation-registry-storage-non-production.adoc[leveloffset=+3]
include::modules/installation-registry-storage-block-recreate-rollout.adoc[leveloffset=+3]
For instructions about configuring registry storage so that it references the correct PVC, see xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#registry-configuring-storage-vsphere_configuring-registry-storage-vsphere[Configuring the registry for vSphere].
include::modules/installation-complete-user-infra.adoc[leveloffset=+1]
You can add extra compute machines after the cluster installation is completed by following xref:../../machine_management/user_infra/adding-vsphere-compute-user-infra.adoc#adding-vsphere-compute-user-infra[Adding compute machines to vSphere].
include::modules/persistent-storage-vsphere-backup.adoc[leveloffset=+1]
== 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].
* xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#configuring-registry-storage-vsphere[Set up your registry and configure registry storage].
* Optional: xref:../../installing/installing_vsphere/using-vsphere-problem-detector-operator.adoc#vsphere-problem-detector-viewing-events_vsphere-problem-detector[View the events from the vSphere Problem Detector Operator] to determine if the cluster has permission or storage configuration issues.

View File

@@ -0,0 +1,66 @@
[id="installing-vmc"]
= Installing a cluster on VMC
include::modules/common-attributes.adoc[]
:context: installing-vmc
toc::[]
In {product-title} version {product-version}, you can install a cluster on VMware vSphere by deploying it to link:https://cloud.vmware.com/vmc-aws[VMware Cloud (VMC) on AWS].
Once you have configured your VMC environment for {product-title} deployment, you use the {product-title} installation program from the bastion management host, co-located in the VMC environment. The installation program and control plane automates the process of deploying and managing the resources needed for the {product-title} cluster.
include::modules/setting-up-vmc-for-vsphere.adoc[leveloffset=+1]
include::modules/vmc-sizer-tool.adoc[leveloffset=+2]
== vSphere prerequisites
* Provision xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#installation-registry-storage-block-recreate-rollout_configuring-registry-storage-vsphere[block registry storage]. For more information on persistent storage, see xref:../../storage/understanding-persistent-storage.adoc#understanding-persistent-storage[Understanding persistent storage].
* Review details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes.
* If you use a firewall, you must xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall[configure it to allow the sites] that your cluster requires access to.
+
[NOTE]
====
Be sure to also review this site list if you are configuring a proxy.
====
include::modules/cluster-entitlements.adoc[leveloffset=+1]
include::modules/installation-vsphere-infrastructure.adoc[leveloffset=+1]
include::modules/installation-vsphere-installer-infra-requirements.adoc[leveloffset=+1]
include::modules/ssh-agent-using.adoc[leveloffset=+1]
include::modules/installation-obtaining-installer.adoc[leveloffset=+1]
include::modules/installation-adding-vcenter-root-certificates.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]
[id="installing-vmc-registry"]
== Creating registry storage
After you install the cluster, you must create storage for the registry Operator.
include::modules/registry-removed.adoc[leveloffset=+2]
include::modules/installation-registry-storage-config.adoc[leveloffset=+2]
include::modules/registry-configuring-storage-vsphere.adoc[leveloffset=+3]
include::modules/installation-registry-storage-block-recreate-rollout.adoc[leveloffset=+3]
For instructions about configuring registry storage so that it references the correct PVC, see xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#registry-configuring-storage-vsphere_configuring-registry-storage-vsphere[Configuring the registry for vSphere].
include::modules/persistent-storage-vsphere-backup.adoc[leveloffset=+1]
== 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].
* xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#configuring-registry-storage-vsphere[Set up your registry and configure registry storage].
* Optional: xref:../../installing/installing_vsphere/using-vsphere-problem-detector-operator.adoc#vsphere-problem-detector-viewing-events_vsphere-problem-detector[View the events from the vSphere Problem Detector Operator] to determine if the cluster has permission or storage configuration issues.

View File

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

View File

@@ -0,0 +1,10 @@
[id="uninstalling-cluster-vmc"]
= Uninstalling a cluster on VMC
include::modules/common-attributes.adoc[]
:context: uninstalling-cluster-vmc
toc::[]
You can remove a cluster installed on VMware vSphere infrastructure that you deployed to link:https://cloud.vmware.com/vmc-aws[VMware Cloud (VMC) on AWS] by using installer-provisioned infrastructure.
include::modules/installation-uninstall-clouds.adoc[leveloffset=+1]

View File

@@ -1,11 +1,14 @@
// Module included in the following assemblies:
//
// * installing-restricted-networks-vsphere.adoc
// * installing-vsphere-network-customizations.adoc
// * installing-vsphere.adoc
// * installing-bare-metal-network-customizations.adoc
// * installing-bare-metal.adoc
// * installing-restricted-networks-bare-metal.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc
// * installing/installing_bare_metal/installing-bare-metal.adoc
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
[id="architecture-rhcos-updating-bootloader.adoc_{context}"]
= Updating the bootloader using bootupd

View File

@@ -21,9 +21,14 @@
// * installing/installing_gcp/installing-gcp-vpc.adoc
// * installing/installing_gcp/installing-gcp-user-infra.adoc
// * installing/install_config/installing-restricted-networks-preparations.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc.adoc
// * installing/installing_vmc/installing-vmc-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
// * installing/installing_ibm_z/installing-ibm-z.adoc
// * openshift_images/samples-operator-alt-registry.adoc
// * installing/installing_rhv/installing-rhv-customizations.adoc

View File

@@ -26,10 +26,18 @@
// * installing/installing_openstack/installing-openstack-installer.adoc
// * installing/installing_aws/installing-restricted-networks-aws.adoc
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vmc/installing-vsphere-user-infra.adoc
// * installing/installing_vmc/installing-vmc.adoc
// * installing/installing_vmc/installing-vmc-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
// * installing/installing_ibm_z/installing-ibm-z.adoc
// * installing/installing_rhv/installing-rhv-customizations.adoc
// * installing/installing_rhv/installing-rhv-default.adoc

View File

@@ -25,8 +25,15 @@
// * installing/installing_aws/installing-restricted-networks-aws.adoc
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
// * installing/installing_rhv/installing-rhv-restricted-network.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vmc/installing-vmc.adoc
// * installing/installing_vmc/installing-vmc-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
@@ -38,6 +45,9 @@ endif::[]
ifeval::["{context}" == "installing-restricted-networks-vsphere"]
:restricted:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vmc-user-infra"]
:restricted:
endif::[]
[id="cluster-entitlements_{context}"]
ifndef::openshift-origin[]
@@ -76,3 +86,6 @@ endif::[]
ifeval::["{context}" == "installing-restricted-networks-vsphere"]
:!restricted:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vmc-user-infra"]
:!restricted:
endif::[]

View File

@@ -2,6 +2,7 @@
//
// * installing/installing_aws/installing-restricted-networks-aws.adoc
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_openstack/installing-openstack-installer-restricted.adoc
// * installing/installing_ibm_z/installing-restricted-networks-ibm-z.adoc

View File

@@ -1,5 +1,8 @@
// Module included in the following assemblies:
//
// * installing/installing_vmc/installing-vmc.adoc
// * installing/installing_vmc/installing-vmc-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc

View File

@@ -7,8 +7,12 @@
// * installing/installing_bare_metal/installing-bare-metal.adoc
// * installing/installing_aws/installing-restricted-networks-aws.adoc
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
// * installing/installing_ibm_z/installing-ibm-z.adoc
// * machine_management/user_provisioned/adding-rhel-compute.adoc
// * machine_management/user_provisioned/more-rhel-compute.adoc

View File

@@ -2,13 +2,20 @@
//
// * installing/installing_bare_metal/installing-bare-metal.adoc
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
// * installing/installing_ibm_z/installing-ibm-z.adoc
ifeval::["{context}" == "installing-restricted-networks-vsphere"]
:restricted:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vmc-user-infra"]
:restricted:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
:restricted:
endif::[]
@@ -215,6 +222,9 @@ endif::restricted[]
ifeval::["{context}" == "installing-restricted-networks-vsphere"]
:!restricted:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vmc-user-infra"]
:!restricted:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
:!restricted:
endif::[]

View File

@@ -19,6 +19,8 @@
// * installing/installing_openstack/installing-openstack-user.adoc
// * installing/installing_openstack/installing-openstack-user-kuryr.adoc
// * installing/installing_rhv/installing-rhv-custom.adoc
// * installing/installing_vmc/installing-vmc-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
@@ -89,6 +91,15 @@ endif::[]
ifeval::["{context}" == "installing-vsphere-installer-provisioned-customizations"]
:vsphere:
endif::[]
ifeval::["{context}" == "installing-vsphere-installer-provisioned-network-customizations"]
:vsphere:
endif::[]
ifeval::["{context}" == "installing-vmc-customizations"]
:vmc:
endif::[]
ifeval::["{context}" == "installing-vmc-network-customizations"]
:vmc:
endif::[]
ifeval::["{context}" == "installing-openstack-installer-restricted"]
:osp:
:osp-custom:
@@ -748,7 +759,7 @@ You can replace `<machine-pool>` with `controlPlane` or `compute`.
endif::rhv[]
ifdef::vsphere[]
ifdef::vsphere,vmc[]
.Additional VMware vSphere cluster parameters
[cols=".^2,.^3a,.^3a",options="header"]
|====
@@ -820,7 +831,7 @@ in vSphere.
|Integer.
|====
endif::vsphere[]
endif::vsphere,vmc[]
ifeval::["{context}" == "installing-aws-customizations"]
:!aws:
@@ -889,6 +900,15 @@ endif::[]
ifeval::["{context}" == "installing-vsphere-installer-provisioned-customizations"]
:!vsphere:
endif::[]
ifeval::["{context}" == "installing-vsphere-installer-provisioned-network-customizations"]
:!vsphere:
endif::[]
ifeval::["{context}" == "installing-vmc-customizations"]
:!vmc:
endif::[]
ifeval::["{context}" == "installing-vmc-network-customizations"]
:!vmc:
endif::[]
ifeval::["{context}" == "installing-openstack-installer-restricted"]
:!osp:
:!osp-custom:

View File

@@ -12,6 +12,8 @@
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
// * installing/installing_openstack/installing-openstack-installer-custom.adoc
// * installing/installing_openstack/installing-openstack-installer-kuryr.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_ibm_z/installing-ibm-z.adoc
@@ -27,9 +29,15 @@ endif::[]
ifeval::["{context}" == "installing-vsphere"]
:vsphere:
endif::[]
ifeval::["{context}" == "installing-installing-restricted-networks-vsphere"]
ifeval::["{context}" == "installing-restricted-networks-vsphere"]
:vsphere:
endif::[]
ifeval::["{context}" == "installing-vmc-user-infra"]
:vmc:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vmc-user-infra"]
:vmc:
endif::[]
[id="installation-configure-proxy_{context}"]
= Configuring the cluster-wide proxy during installation
@@ -87,9 +95,9 @@ connections.
If you use an MITM transparent proxy network that does not require additional proxy configuration but requires additional CAs, you must not specify an `httpsProxy` value.
<3> A comma-separated list of destination domain names, domains, IP addresses, or
other network CIDRs to exclude proxying. Preface a domain with `.` to match subdomains only. For example, `.y.com` matches `x.y.com`, but not `y.com`. Use `*` to bypass proxy for all destinations.
ifdef::vsphere[]
ifdef::vsphere,vmc[]
You must include vCenter's IP address and the IP range that you use for its machines.
endif::vsphere[]
endif::vsphere,vmc[]
<4> If provided, the installation program generates a config map that is named `user-ca-bundle` in
the `openshift-config` namespace that contains one or more additional CA
certificates that are required for proxying HTTPS connections. The Cluster Network
@@ -127,6 +135,12 @@ endif::[]
ifeval::["{context}" == "installing-vsphere"]
:!vsphere:
endif::[]
ifeval::["{context}" == "installing-installing-restricted-networks-vsphere"]
ifeval::["{context}" == "installing-restricted-networks-vsphere"]
:!vsphere:
endif::[]
ifeval::["{context}" == "installing-vmc-user-infra"]
:!vmc:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vmc-user-infra"]
:!vmc:
endif::[]

View File

@@ -1,8 +1,11 @@
// Module included in the following assemblies:
//
// * installing-vsphere.adoc
// * installing-vsphere-network-customizations.adoc
// * installing-restricted-networks-vsphere.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// This content was sourced from the bare metal RHCOS assembly file `modules/installation-user-infra-machines-advanced.adoc` under the `== Disk partitioning` subheader. "Disk partioning" content in the bare metal assembly is not modularized, so anything in this vsphere module should be checked against that file for consistency until such time that the large bare metal assembly can be modularized.

View File

@@ -3,8 +3,12 @@
// * installing/installing_bare_metal/installing-bare-metal.adoc
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
// * installing/installing_platform_agnostic/installing-platform-agnostic.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
// * installing/installing_ibm_z/installing-ibm-z.adoc
// * installing/installing-rhv-restricted-network.adoc

View File

@@ -5,8 +5,12 @@
// * installing/installing_azure/installing-azure-user-infra.adoc
// * installing/installing_gcp/installing-gcp-user-infra.adoc
// * installing/installing_gcp/installing-restricted-networks-gcp.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
ifeval::["{context}" == "installing-aws-user-infra"]
:cp-first: Amazon Web Services
@@ -55,6 +59,26 @@ ifeval::["{context}" == "installing-vsphere"]
:cp: vSphere
:vsphere:
endif::[]
ifeval::["{context}" == "installing-vsphere-network-customizations"]
:cp-first: VMware vSphere
:cp: vSphere
:vsphere:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vmc-user-infra"]
:cp-first: VMware Cloud on AWS
:cp: VMC
:vmc:
endif::[]
ifeval::["{context}" == "installing-vmc-user-infra"]
:cp-first: VMware Cloud on AWS
:cp: VMC
:vmc:
endif::[]
ifeval::["{context}" == "installing-vmc-network-customizations-user-infra"]
:cp-first: VMware Cloud on AWS
:cp: VMC
:vmc:
endif::[]
[id="installation-extracting-infraid_{context}"]
= Extracting the infrastructure name
@@ -73,10 +97,10 @@ templates contain references to this infrastructure name, so you must extract
it.
endif::azure[]
ifdef::vsphere[]
ifdef::vsphere,vmc[]
The Ignition config files contain a unique cluster identifier that you can use to
uniquely identify your cluster in {cp-first}. If you plan to use the cluster identifier as the name of your virtual machine folder, you must extract it.
endif::vsphere[]
endif::vsphere,vmc[]
.Prerequisites
@@ -150,3 +174,23 @@ ifeval::["{context}" == "installing-vsphere"]
:!cp: vSphere
:!vsphere:
endif::[]
ifeval::["{context}" == "installing-vsphere-network-customizations"]
:!cp-first: VMware vSphere
:!cp: vSphere
:!vsphere:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vmc-user-infra"]
:!cp-first: VMware Cloud on AWS
:!cp: VMC
:!vmc:
endif::[]
ifeval::["{context}" == "installing-vmc-user-infra"]
:!cp-first: VMware Cloud on AWS
:!cp: VMC
:!vmc:
endif::[]
ifeval::["{context}" == "installing-vmc-network-customizations-user-infra"]
:!cp-first: VMware Cloud on AWS
:!cp: VMC
:!vmc:
endif::[]

View File

@@ -1,11 +1,15 @@
// Module included in the following assemblies:
//
// * installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
ifeval::["{context}" == "installing-restricted-networks-vsphere"]
:restricted:
endif::[]
ifeval::["{context}" == "installing-vmc-network-customizations-user-infra"]
:restricted:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
:restricted:
endif::[]
@@ -63,3 +67,13 @@ in the directory:
├── metadata.json
└── worker.ign
----
ifeval::["{context}" == "installing-restricted-networks-vsphere"]
:!restricted:
endif::[]
ifeval::["{context}" == "installing-vmc-network-customizations-user-infra"]
:!restricted:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
:!restricted:
endif::[]

View File

@@ -3,8 +3,12 @@
// * installing/installing_bare_metal/installing-bare-metal.adoc
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
// * installing/installing_platform_agnostic/installing-platform-agnostic.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
// * installing/installing_ibm_z/installing-ibm-z.adoc
ifeval::["{context}" == "installing-ibm-z"]

View File

@@ -8,8 +8,12 @@
// * installing/installing_gcp/installing-gcp-private.adoc
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
// * installing/installing_platform_agnostic/installing-platform-agnostic.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
// * installing/installing_ibm_z/installing-ibm-z.adoc
ifeval::["{context}" == "installing-azure-government-region"]
@@ -18,6 +22,9 @@ endif::[]
ifeval::["{context}" == "installing-restricted-networks-vsphere"]
:restricted:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vmc-user-infra"]
:restricted:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
:restricted:
endif::[]
@@ -115,6 +122,9 @@ endif::[]
ifeval::["{context}" == "installing-restricted-networks-vsphere"]
:!restricted:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vmc-user-infra"]
:!restricted:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
:!restricted:
endif::[]

View File

@@ -18,6 +18,8 @@
// * installing/installing_openstack/installing-openstack-user-kuryr.adoc
// * installing/installing_openstack/installing-openstack-user.adoc
// * installing/installing_rhv/installing-rhv-customizations.adoc
// * installing/installing_vmc/installing-vmc-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
@@ -90,6 +92,12 @@ endif::[]
ifeval::["{context}" == "installing-vsphere-installer-provisioned-network-customizations"]
:vsphere:
endif::[]
ifeval::["{context}" == "installing-vmc-customizations"]
:vmc:
endif::[]
ifeval::["{context}" == "installing-vmc-network-customizations"]
:vmc:
endif::[]
ifeval::["{context}" == "installing-openstack-installer-restricted"]
:osp:
:restricted:
@@ -111,6 +119,9 @@ endif::gcp[]
ifdef::osp[]
{rh-openstack-first}.
endif::osp[]
ifdef::vsphere,vmc[]
VMware vSphere.
endif::vsphere,vmc[]
ifdef::rhv[]
{rh-virtualization-first}.
@@ -125,9 +136,7 @@ Installing OpenShift Container Platform (OCP) version 4.6 on Red Hat Virtualizat
====
endif::openshift-origin[]
endif::rhv[]
ifdef::vsphere[]
VMware vSphere.
endif::vsphere[]
.Prerequisites
@@ -215,7 +224,7 @@ and compute nodes.
... Select the base domain to deploy the cluster to. All DNS records will be
sub-domains of this base and will also include the cluster name.
endif::osp[]
ifdef::vsphere[]
ifdef::vsphere,vmc[]
... Select *vsphere* as the platform to target.
... Specify the name of your vCenter instance.
... Specify the user name and password for the vCenter account that has the required permissions to create the cluster.
@@ -228,13 +237,13 @@ The installation program connects to your vCenter instance.
... Enter the virtual IP address that you configured for control plane API access.
... Enter the virtual IP address that you configured for cluster ingress.
... Enter the base domain. This base domain must be the same one that you used in the DNS records that you configured.
endif::vsphere[]
endif::vsphere,vmc[]
ifndef::osp[]
ifndef::rhv[]
... Enter a descriptive name for your cluster.
ifdef::vsphere[]
ifdef::vsphere,vmc[]
The cluster name must be the same one that you used in the DNS records that you configured.
endif::vsphere[]
endif::vsphere,vmc[]
endif::rhv[]
endif::osp[]
ifdef::osp[]
@@ -469,6 +478,12 @@ endif::[]
ifeval::["{context}" == "installing-vsphere-installer-provisioned-network-customizations"]
:!vsphere:
endif::[]
ifeval::["{context}" == "installing-vmc-customizations"]
:vmc:
endif::[]
ifeval::["{context}" == "installing-vmc-network-customizations"]
:vmc:
endif::[]
ifeval::["{context}" == "installing-openstack-installer-restricted"]
:!osp:
:!restricted:

View File

@@ -1,10 +1,16 @@
// Module included in the following assemblies:
//
// * installing/installing_vmc/installing-vmc-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
ifeval::["{context}" == "installing-vsphere-installer-provisioned-network-customizations"]
:network:
endif::[]
ifeval::["{context}" == "installing-vmc-network-customizations"]
:network:
endif::[]
[id="installation-installer-provisioned-vsphere-config-yaml_{context}"]
= Sample `install-config.yaml` file for an installer-provisioned VMware vSphere cluster
@@ -104,3 +110,6 @@ simultaneous multithreading.
ifeval::["{context}" == "installing-vsphere-installer-provisioned-network-customizations"]
:!network:
endif::[]
ifeval::["{context}" == "installing-vmc-network-customizations"]
:!network:
endif::[]

View File

@@ -2,9 +2,13 @@
//
// * installing/installing_bare_metal/installing-bare-metal.adoc
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_platform_agnostic/installing-platform-agnostic.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
// * installing/installing_ibm_z/installing-ibm-z.adoc
ifeval::["{context}" == "installing-restricted-networks-ibm-z"]
@@ -19,6 +23,9 @@ endif::[]
ifeval::["{context}" == "installing-restricted-networks-vsphere"]
:restricted:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vmc-user-infra"]
:restricted:
endif::[]
[id="installation-installing-bare-metal_{context}"]
= Creating the cluster
@@ -83,3 +90,6 @@ endif::[]
ifeval::["{context}" == "installing-restricted-networks-vsphere"]
:!restricted:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vmc-user-infra"]
:!restricted:
endif::[]

View File

@@ -20,7 +20,11 @@
// * installing/installing_openstack/installing-openstack-installer.adoc
// * installing/installing_rhv/installing-rhv-customizations.adoc
// * installing/installing_rhv/installing-rhv-default.adoc
// * installing/installing_vmc/installing-vmc.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
// * installing/installing_vmc/installing-vmc-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
// If you use this module in any other assembly, you must update the ifeval
// statements.
@@ -108,6 +112,18 @@ ifeval::["{context}" == "installing-vsphere-installer-provisioned-network-custom
:custom-config:
:vsphere:
endif::[]
ifeval::["{context}" == "installing-vmc"]
:no-config:
:vmc:
endif::[]
ifeval::["{context}" == "installing-vmc-customizations"]
:custom-config:
:vmc:
endif::[]
ifeval::["{context}" == "installing-vmc-network-customizations"]
:custom-config:
:vmc:
endif::[]
[id="installation-launching-installer_{context}"]
= Deploying the cluster
@@ -330,6 +346,13 @@ admin@internal
endif::rhv[]
--
endif::no-config[]
ifdef::vmc[]
+
[IMPORTANT]
====
Use the `openshift-install` command from the bastion hosted in the VMC environment.
====
endif::vmc[]
+
[NOTE]
====
@@ -470,3 +493,15 @@ ifeval::["{context}" == "installing-vsphere-installer-provisioned-network-custom
:!custom-config:
:!vsphere:
endif::[]
ifeval::["{context}" == "installing-vmc"]
:!no-config:
:!vmc:
endif::[]
ifeval::["{context}" == "installing-vmc-customizations"]
:!custom-config:
:!vmc:
endif::[]
ifeval::["{context}" == "installing-vmc-network-customizations"]
:!custom-config:
:!vmc:
endif::[]

View File

@@ -4,6 +4,9 @@
// * installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
// * installing/installing_platform_agnostic/installing-platform-agnostic.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc

View File

@@ -22,7 +22,13 @@
// * installing/installing_openstack/installing-openstack-installer-kuryr.adoc
// * installing/installing_openstack/installing-openstack-installer.adoc
// * installing/installing_platform_agnostic/installing-platform-agnostic.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vmc/installing-vmc.adoc
// * installing/installing_vmc/installing-vmc-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc

View File

@@ -5,8 +5,12 @@
// * installing/installing_aws/installing-restricted-networks-aws.adoc
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
// * installing/installing_platform_agnostic/installing-platform-agnostic.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
// * installing/installing_ibm_z/installing-ibm-z.adoc
[id="installation-operators-config_{context}"]

View File

@@ -1,6 +1,11 @@
// Module included in the following assemblies:
//
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vmc/installing-vmc-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
// * installing/installing_vmc/installing-vmc.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned.adoc

View File

@@ -4,16 +4,22 @@
// * installing/installing_bare_metal/installing-bare-metal.adoc
// * installing/installing_aws/installing-restricted-networks-aws.adoc
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_ibm_z/installing-ibm-z.adoc
// * installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc
// * installing/installing_bare_metal/installing-bare-metal.adoc
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
// * installing/installing_platform_agnostic/installing-platform-agnostic.adoc
// * installing/installing_vmc/installing-vmc-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
// * installing/installing_vmc/installing-vmc.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
// * registry/configuring_registry_storage/configuring-registry-storage-baremetal.adoc
// * registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc

View File

@@ -5,6 +5,8 @@
// * installing/installing_aws/installing-restricted-networks-aws.adoc
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
// * installing/installing_platform_agnostic/installing-platform-agnostic.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_ibm_z/installing-ibm-z.adoc

View File

@@ -4,6 +4,9 @@
// * installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
// * installing/installing_platform_agnostic/installing-platform-agnostic.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc

View File

@@ -5,6 +5,7 @@
// * installing/installing_gcp/uninstalling-cluster-gcp.adoc
// * installing/installing_osp/uninstalling-cluster-openstack.adoc
// * installing/installing_rhv/uninstalling-cluster-rhv.adoc
// * installing/installing_vmc/uninstalling-cluster-vmc.adoc
// * installing/installing_vsphere/uninstalling-cluster-vsphere-installer-provisioned.adoc
ifeval::["{context}" == "uninstalling-cluster-aws"]

View File

@@ -8,6 +8,8 @@
// * installing/installing_aws/installing-restricted-networks-aws.adoc
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
// * installing/installing_platform_agnostic/installing-platform-agnostic.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_ibm_z/installing-ibm-z.adoc
@@ -26,6 +28,11 @@ ifeval::["{context}" == "installing-azure-user-infra"]
:azure-user-infra:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vsphere"]
:vsphere:
:restricted:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vmc-user-infra"]
:vmc:
:restricted:
endif::[]
ifeval::["{context}" == "installing-bare-metal"]
@@ -54,8 +61,8 @@ endif::[]
ifeval::["{context}" == "installing-vsphere"]
:vsphere:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vsphere"]
:vsphere:
ifeval::["{context}" == "installing-vmc-user-infra"]
:vmc:
endif::[]
ifeval::["{context}" == "installing-platform-agnostic"]
:baremetal:
@@ -131,7 +138,7 @@ Because you create and manage the worker machines yourself, you do not need
to initialize these machines.
endif::aws,azure,gcp[]
ifdef::osp,vsphere[]
ifdef::osp,vsphere,vmc[]
. Remove the Kubernetes manifest files that define the control plane machines and compute machine sets:
+
[source,terminal]
@@ -143,7 +150,7 @@ Because you create and manage these resources yourself, you do not have
to initialize them.
+
* You can preserve the machine set files to create compute machines by using the machine API, but you must update references to them to match your environment.
endif::osp,vsphere[]
endif::osp,vsphere,vmc[]
ifdef::baremetal,baremetal-restricted[]
[WARNING]
@@ -319,6 +326,11 @@ ifeval::["{context}" == "installing-gcp-user-infra-vpc"]
:!user-infra-vpc:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vsphere"]
:!vsphere:
:!restricted:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vmc-user-infra"]
:!vmc:
:!restricted:
endif::[]
ifeval::["{context}" == "installing-bare-metal"]
@@ -340,8 +352,8 @@ endif::[]
ifeval::["{context}" == "installing-vsphere"]
:!vsphere:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vsphere"]
:!vsphere:
ifeval::["{context}" == "installing-vmc-user-infra"]
:!vmc:
endif::[]
ifeval::["{context}" == "installing-platform-agnostic"]
:!baremetal:

View File

@@ -1,12 +1,18 @@
// Module included in the following assemblies:
//
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
ifeval::["{context}" == "installing-restricted-networks-vsphere"]
:restricted:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vmc-user-infra"]
:restricted:
endif::[]
[id="installation-vsphere-config-yaml_{context}"]
= Sample `install-config.yaml` file for VMware vSphere
@@ -202,3 +208,6 @@ endif::[]
ifdef::openshift-origin[]
:!restricted:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vmc-user-infra"]
:!restricted:
endif::[]

View File

@@ -2,9 +2,16 @@
//
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vmc/installing-vmc.adoc
// * installing/installing_vmc/installing-vmc-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
[id="installation-vsphere-infrastructure_{context}"]
= VMware vSphere infrastructure requirements

View File

@@ -3,6 +3,9 @@
// * installing/installing_vsphere/installing-vsphere-installer-provisioned.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
// * installing/installing_vmc/installing-vmc.adoc
// * installing/installing_vmc/installing-vmc-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
[id="installation-vsphere-installer-infra-requirements_{context}"]
= vCenter requirements

View File

@@ -1,5 +1,8 @@
// Module included in the following assemblies:
//
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc

View File

@@ -1,5 +1,11 @@
// Module included in the following assemblies:
//
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
// * machine_management/user_infra/adding-vsphere-compute-user-infra.adoc
[id="machine-vsphere-machines_{context}"]

View File

@@ -4,6 +4,8 @@
// * installing/installing_azure/installing-azure-network-customizations.adoc
// * installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc
// * installing/installing_gcp/installing-gcp-network-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc

View File

@@ -3,8 +3,10 @@
// * installing/installing_aws/installing-aws-network-customizations.adoc
// * installing/installing_azure/installing-azure-network-customizations.adoc
// * installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
// * installing/installing_gcp/installing-gcp-network-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
ifeval::["{context}" == "installing-bare-metal-network-customizations"]
@@ -14,6 +16,10 @@ ifeval::["{context}" == "installing-vsphere-network-customizations"]
:ignition-config:
:vsphere:
endif::[]
ifeval::["{context}" == "installing-vmc-network-customizations-user-infra"]
:ignition-config:
:vmc:
endif::[]
[id="modifying-nwoperator-config-startup_{context}"]
= Modifying advanced network configuration parameters
@@ -108,7 +114,7 @@ specify only the parameters that you want to change.
installation program deletes the `manifests/` directory when creating the
cluster.
ifdef::vsphere[]
ifdef::vsphere,vmc[]
. Remove the Kubernetes manifest files that define the control plane machines and compute machineSets:
+
[source,terminal]
@@ -120,7 +126,7 @@ Because you create and manage these resources yourself, you do not have
to initialize them.
+
* You can preserve the MachineSet files to create compute machines by using the machine API, but you must update references to them to match your environment.
endif::vsphere[]
endif::vsphere,vmc[]
ifeval::["{context}" == "installing-bare-metal-network-customizations"]
:!ignition-config:
@@ -129,3 +135,7 @@ ifeval::["{context}" == "installing-vsphere-network-customizations"]
:!ignition-config:
:!vsphere:
endif::[]
ifeval::["{context}" == "installing-vmc-network-customizations-user-infra"]
:!ignition-config:
:!vmc:
endif::[]

View File

@@ -4,6 +4,8 @@
// * installing/installing_aws/installing-aws-network-customizations.adoc
// * installing/installing_azure/installing-azure-network-customizations.adoc
// * installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
// * installing/installing_gcp/installing-gcp-network-customizations.adoc

View File

@@ -1,6 +1,12 @@
// Module included in the following assemblies:
//
// * storage/persistent_storage/persistent-storage-vsphere.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
// * installing/installing_vmc/installing-vmc.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc

View File

@@ -1,5 +1,10 @@
// Module included in the following assemblies:
//
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
// * installing/installing_vmc/installing-vmc-customizations.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned.adoc

View File

@@ -4,6 +4,12 @@
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
// * installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc
// * installing/installing_platform_agnostic/installing-platform-agnostic.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vmc/installing-vmc.adoc
// * installing/installing_vmc/installing-vmc-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc

View File

@@ -0,0 +1,87 @@
// Module included in the following assemblies:
//
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc.adoc
ifeval::["{context}" == "installing-vmc"]
:ipi:
endif::[]
ifeval::["{context}" == "installing-vmc-customizations"]
:ipi:
endif::[]
ifeval::["{context}" == "installing-vmc-network-customizations"]
:ipi:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vmc-user-infra"]
:restricted:
endif::[]
[id="setting-up-vmc-for-vsphere_{context}"]
= Setting up VMC for vSphere
You can install {product-title} on VMware Cloud (VMC) on AWS hosted vSphere clusters to enable applications to be deployed and managed both on-premise and off-premise, across the hybrid cloud.
image::150_OpenShift_VMware_on_AWS_0321_arch.svg["VMC on AWS Architecture"]
You must configure several options in your VMC environment prior to installing {product-title} on VMware vSphere. Ensure your VMC environment has the following prerequisites:
* Create a non-exclusive, DHCP-enabled, NSX-T network segment and subnet. Other virtual machines (VMs) can be hosted on the subnet, but at least eight IP addresses must be available for the {product-title} deployment.
ifdef::ipi[]
* Allocate two IP addresses, outside the DHCP range, and configure them with reverse DNS records.
** A DNS record for `api.<cluster_name>.<base_domain>` pointing to the allocated IP address.
** A DNS record for `*.apps.<cluster_name>.<base_domain>` pointing to the allocated IP address.
endif::ipi[]
* Configure the following firewall rules:
ifndef::restricted[]
** An ANY:ANY firewall rule between the {product-title} compute network and the Internet. This is used by nodes and applications to download container images.
endif::restricted[]
** An ANY:ANY firewall rule between the installation host and the software-defined data center (SDDC) management network on port 443. This allows you to upload the {op-system-first} OVA during deployment.
** An HTTPS firewall rule between the {product-title} compute network and vCenter. This connection allows {product-title} to communicate with vCenter for provisioning and managing nodes, persistent volume claims (PVCs), and other resources.
* You must have the following information to deploy {product-title}:
** The {product-title} cluster name, such as `vmc-prod-1`.
** The base DNS name, such as `companyname.com`.
** If not using the default, the pod network CIDR and services network CIDR must be identified, which are set by default to `10.128.0.0/14` and `172.30.0.0/16`, respectively. These CIDRs are used for pod-to-pod and pod-to-service communication and are not accessible externally; however, they must not overlap with existing subnets in your organization.
** The following vCenter information:
*** vCenter host name, username, and password
*** Datacenter name, such as `SDDC-Datacenter`
*** Cluster name, such as `Cluster-1`
*** Network name
*** Datastore name, such as `WorkloadDatastore`
+
[NOTE]
====
It is recommended to move your vSphere cluster to the VMC `Compute-ResourcePool` resource pool after your cluster installation is finished.
====
* A Linux-based host deployed to VMC as a bastion.
** The bastion host can be {op-system-base-full} or any another Linux-based host; it must have Internet connectivity and the ability to upload an OVA to the ESXi hosts.
** Download and install the OpenShift CLI tools to the bastion host.
*** The `openshift-install` installation program
*** The OpenShift CLI (`oc`) tool
[NOTE]
====
You cannot use the VMware NSX Container Plugin for Kubernetes (NCP), and NSX is not used as the OpenShift SDN. The version of NSX currently available with VMC is incompatible with the version of NCP certified with {product-title}.
However, the NSX DHCP service is used for virtual machine IP management with the full-stack automated {product-title} deployment and with nodes provisioned, either manually or automatically, by the Machine API integration with vSphere. Additionally, NSX firewall rules are created to enable access with the {product-title} cluster and between the bastion host and the VMC vSphere hosts.
====
ifeval::["{context}" == "installing-vmc"]
:!ipi:
endif::[]
ifeval::["{context}" == "installing-vmc-customizations"]
:!ipi:
endif::[]
ifeval::["{context}" == "installing-vmc-network-customizations"]
:!ipi:
endif::[]
ifeval::["{context}" == "installing-restricted-network-vmc-user-infra"]
:!restricted:
endif::[]

View File

@@ -24,8 +24,15 @@
// * installing/installing_aws/installing-restricted-networks-aws.adoc
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
// * installing/installing_platform_agnostic/installing-platform-agnostic.adoc
// * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vmc/installing-vmc.adoc
// * installing/installing_vmc/installing-vmc-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere.adoc
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
@@ -38,6 +45,9 @@
ifeval::["{context}" == "installing-restricted-networks-vsphere"]
:user-infra:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vmc-user-infra"]
:user-infra:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
:user-infra:
endif::[]
@@ -50,6 +60,9 @@ endif::[]
ifeval::["{context}" == "installing-vsphere"]
:user-infra:
endif::[]
ifeval::["{context}" == "installing-vmc-user-infra"]
:user-infra:
endif::[]
ifeval::["{context}" == "installing-aws-user-infra"]
:user-infra:
endif::[]
@@ -176,6 +189,9 @@ endif::user-infra[]
ifeval::["{context}" == "installing-restricted-networks-vsphere"]
:!user-infra:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-vmc-user-infra"]
:!user-infra:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
:!user-infra:
endif::[]
@@ -188,6 +204,9 @@ endif::[]
ifeval::["{context}" == "installing-vsphere"]
:!user-infra:
endif::[]
ifeval::["{context}" == "installing-vmc-user-infra"]
:!user-infra:
endif::[]
ifeval::["{context}" == "installing-aws-user-infra"]
:!user-infra:
endif::[]

View File

@@ -15,6 +15,7 @@ In {product-title} {product-version}, you can install a cluster that uses instal
** The latest {product-title} release supports both the latest {rh-openstack} long-life release and intermediate release. For complete {rh-openstack} release compatibility, see the link:https://access.redhat.com/articles/4679401[{product-title} on {rh-openstack} support matrix].
* {rh-virtualization-first}
* VMware vSphere
* VMware Cloud (VMC) on AWS
For these clusters, all machines, including the computer that you run the installation process on, must have direct internet access to pull images for platform containers and provide telemetry data to Red Hat.
@@ -34,6 +35,7 @@ In {product-title} {product-version}, you can install a cluster that uses user-p
* {rh-openstack}
* {rh-virtualization}
* VMware vSphere
* VMware Cloud on AWS
* Bare metal
* IBM Z or LinuxONE
* IBM Power Systems

View File

@@ -0,0 +1,25 @@
// Module included in the following assemblies:
//
// * installing/installing_vmc/installing-restricted-network-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations.adoc
// * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
// * installing/installing_vmc/installing-vmc-user-infra.adoc
// * installing/installing_vmc/installing-vmc.adoc
[id="vmc-sizer-tool_{context}"]
= VMC Sizer tool
VMware Cloud on AWS is built on top of AWS bare metal infrastructure; this is the same bare metal infrastructure which runs AWS native services. When a VMware cloud on AWS software-defined data center (SDDC) is deployed, you consume these physical server nodes and run the VMware ESXi hypervisor in a single tenant fashion. This means the physical infrastructure is not accessible to anyone else using VMC. It is important to consider how many physical hosts you will need to host your virtual infrastructure.
To determine this, VMware provides the link:https://vmc.vmware.com/sizer/quick-sizing[VMC on AWS Sizer]. With this tool, you can define the resources you intend to host on VMC:
* Types of workloads
* Total number of virtual machines
* Specification information such as:
** Storage requirements
** vCPUs
** vRAM
** Overcommit ratios
With these details, the sizer tool can generate a report, based on VMware best practices, and recommend your cluster configuration and the number of hosts you will need.