From 38cee80ebf1472a3368f9ad16469d3df9ac54fb5 Mon Sep 17 00:00:00 2001 From: Pan Ousley Date: Thu, 3 Jul 2025 17:48:39 -0400 Subject: [PATCH] CNV#64393: cloud platforms matrix --- virt/install/preparing-cluster-for-virt.adoc | 156 +++++++++++++------ 1 file changed, 111 insertions(+), 45 deletions(-) diff --git a/virt/install/preparing-cluster-for-virt.adoc b/virt/install/preparing-cluster-for-virt.adoc index d5f7d49e77..49b4f997b6 100644 --- a/virt/install/preparing-cluster-for-virt.adoc +++ b/virt/install/preparing-cluster-for-virt.adoc @@ -7,56 +7,27 @@ include::_attributes/common-attributes.adoc[] toc::[] -Review this section before you install {VirtProductName} to ensure that your cluster meets the requirements. +Before you install {VirtProductName}, review this section to ensure that your cluster meets the requirements. -// Hiding in ROSA/OSD as not supported +// Hiding compatible platforms list in ROSA/OSD ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] -[IMPORTANT] -==== -Installation method considerations:: -You can use any installation method, including user-provisioned, installer-provisioned, or assisted installer, to deploy {product-title}. However, the installation method and the cluster topology might affect {VirtProductName} functionality, such as snapshots or xref:../../virt/install/preparing-cluster-for-virt.adoc#live-migration_preparing-cluster-for-virt[live migration]. -{rh-storage-first}:: -If you deploy {VirtProductName} with {rh-storage-first}, you must create a dedicated storage class for Windows virtual machine disks. See link:https://access.redhat.com/articles/6978371[Optimizing ODF PersistentVolumes for Windows VMs] for details. - -IPv6:: -{VirtProductName} support for single-stack IPv6 clusters is limited to the OVN-Kubernetes localnet and Linux bridge Container Network Interface (CNI) plugins. -==== - -:FeatureName: Deploying {VirtProductName} on a single-stack IPv6 cluster -include::snippets/technology-preview.adoc[] -:!FeatureName: - -endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] - -// Hiding in ROSA/OSD as FIPS not supported -ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] -.FIPS mode - -If you install your cluster in xref:../../installing/overview/installing-fips.adoc#installing-fips-mode_installing-fips[FIPS mode], no additional setup is required for {VirtProductName}. -endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] - -[id="supported-platforms_preparing-cluster-for-virt"] -== Supported platforms +[id="compatible-platforms_{context}"] +== Compatible platforms You can use the following platforms with {VirtProductName}: -// Hiding in ROSA/OSD, as bare metal not supported -ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] * On-premise bare metal servers. See xref:../../installing/installing_bare_metal/preparing-to-install-on-bare-metal.adoc#virt-planning-bare-metal-cluster-for-ocp-virt_preparing-to-install-on-bare-metal[Planning a bare metal cluster for {VirtProductName}]. -* Amazon Web Services bare metal instances. See xref:../../installing/installing_aws/ipi/installing-aws-customizations.adoc#installing-aws-customizations[Installing a cluster on AWS with customizations]. -//See link:https://access.redhat.com/articles/6409731[Deploy {VirtProductName} on AWS metal instance types]. // seems outdated with references to OCS - remove? - -* {ibm-cloud-name} Bare Metal Servers. See link:https://access.redhat.com/articles/6738731[Deploy {VirtProductName} on {ibm-cloud-name} Bare Metal nodes]. -+ --- -ifdef::openshift-enterprise[] -:FeatureName: Installing OpenShift Virtualization on {ibm-cloud-name} Bare Metal Servers -include::snippets/technology-preview.adoc[] -:!FeatureName: -endif::[] --- +//* {ibm-cloud-name} Bare Metal Servers. See link:https://access.redhat.com/articles/6738731[Deploy {VirtProductName} on {ibm-cloud-name} Bare Metal nodes]. +//+ +//-- +//ifdef::openshift-enterprise[] +//:FeatureName: Installing OpenShift Virtualization on {ibm-cloud-name} Bare Metal Servers +//include::snippets/technology-preview.adoc[] +//:!FeatureName: +//endif::[] +//-- * {ibm-z-name} or {ibm-linuxone-name} (s390x architecture) systems where an {product-title} cluster is installed in logical partitions (LPARs). See xref:../../installing/installing_ibm_z/preparing-to-install-on-ibm-z.adoc#preparing-to-install-on-ibm-z_preparing-to-install-on-ibm-z[Preparing to install on {ibm-z-title} and {ibm-linuxone-title}]. + @@ -70,9 +41,73 @@ endif::[] endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] -ifdef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] -* Amazon Web Services bare metal instances. -endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] +// hiding in rosa/osd +ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] +// the following section is in the assembly for xref reasons +Cloud platforms:: + +{VirtProductName} is also compatible with a variety of public cloud platforms. Each cloud platform has specific storage provider options available. The following table outlines which platforms are fully supported (GA) and which are currently offered as Technology Preview features. ++ +-- +ifdef::openshift-enterprise[] +:FeatureName: Installing {VirtProductName} on certain cloud platforms +include::snippets/technology-preview.adoc[] +:!FeatureName: +endif::[] +-- + +[cols="1,1,2,2a", options="header"] +|=== +| Vendor +| Status +| Storage +| Related links + +| {aws-first} +| GA +| Elastic Block Store (EBS), {odf-first}, Portworx, FSx (NetApp) +| * xref:../../installing/installing_aws/ipi/installing-aws-customizations.adoc#installing-aws-customizations[Installing a cluster on AWS with customizations] + +| {product-rosa} (ROSA) +| GA +| EBS, Portworx, FSx (Q3), {odf-short} +| * link:https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/virtualization/index[{VirtProductName}] in the {product-rosa} documentation +* link:https://docs.aws.amazon.com/rosa/latest/userguide/what-is-rosa.html[What is {product-rosa}?] in the {aws-short} documentation + +| {oci-first-no-rt} +| Technology Preview +| {oci} native storage +| * link:https://access.redhat.com/articles/7118050[{VirtProductName} and Oracle Cloud Infrastructure known issues and limitations] in the Red{nbsp}Hat Knowledgebase +* link:https://github.com/oracle-quickstart/oci-openshift/blob/main/custom_manifests/oci-ccm-csi-drivers/v1.30.0-RWX-LA/openshift-virtualization.md[Installing {VirtProductName} on OCI] in the `oracle-quickstart/oci-openshift` GitHub repository + +| Azure Red{nbsp}Hat OpenShift (ARO) +| Technology Preview +| {odf-short} +| * link:https://learn.microsoft.com/en-us/azure/openshift/howto-create-openshift-virtualization[{VirtProductName} for Azure Red Hat OpenShift (preview)] in the Microsoft documentation + +| {gcp-first} +| Technology Preview +| {gcp-short} native storage +| * link:https://access.redhat.com/articles/7120382[{VirtProductName} and {gcp-full} known storage issues and limitations] in the Red{nbsp}Hat Knowledgebase + +// tracker: https://issues.redhat.com/browse/XCMSTRAT-1191 +// | {product-dedicated} +// | Technology Preview +// | {gcp-short} native storage +// | + +// | {ibm-cloud-title} +// | Technology Preview +// | IBM Fusion +// | +|=== + +[TIP] +==== +For platform-specific networking information, see the xref:../../virt/vm_networking/virt-networking-overview.adoc#virt-networking[networking overview]. +==== + +endif::[] // Hiding in ROSA/OSD, as bare metal not supported ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] @@ -146,6 +181,37 @@ The following features are available for use on s390x architecture but function endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] +// Hiding in ROSA/OSD as not supported +ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] + +[id="important-considerations_preparing-cluster-for-virt"] +== Important considerations for any platform + +Before you install {VirtProductName} on any platform, note the following caveats and considerations. + +Installation method considerations:: +You can use any installation method, including user-provisioned, installer-provisioned, or Assisted Installer, to deploy {product-title}. However, the installation method and the cluster topology might affect {VirtProductName} functionality, such as snapshots or xref:../../virt/install/preparing-cluster-for-virt.adoc#live-migration_preparing-cluster-for-virt[live migration]. + +{rh-storage-first}:: +If you deploy {VirtProductName} with {rh-storage-first}, you must create a dedicated storage class for Windows virtual machine disks. See link:https://access.redhat.com/articles/6978371[Optimizing ODF PersistentVolumes for Windows VMs] for details. + +IPv6:: +{VirtProductName} support for single-stack IPv6 clusters is limited to the OVN-Kubernetes localnet and Linux bridge Container Network Interface (CNI) plugins. ++ +-- +:FeatureName: Deploying {VirtProductName} on a single-stack IPv6 cluster +include::snippets/technology-preview.adoc[] +:!FeatureName: +-- + +endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] + +// Hiding in ROSA/OSD as FIPS not supported +ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] + +FIPS mode:: If you install your cluster in xref:../../installing/overview/installing-fips.adoc#installing-fips-mode_installing-fips[FIPS mode], no additional setup is required for {VirtProductName}. +endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] + // Section is in assembly so that we can use xrefs [id="virt-hardware-os-requirements_preparing-cluster-for-virt"] == Hardware and operating system requirements