From 53a41cbfb5fea8cabbe011ad244347a017b5aa75 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 | 129 ++++++++++++++----- 1 file changed, 98 insertions(+), 31 deletions(-) diff --git a/virt/install/preparing-cluster-for-virt.adoc b/virt/install/preparing-cluster-for-virt.adoc index d5f7d49e77f5..76cb3e8f306d 100644 --- a/virt/install/preparing-cluster-for-virt.adoc +++ b/virt/install/preparing-cluster-for-virt.adoc @@ -9,35 +9,73 @@ toc::[] Review this section before you install {VirtProductName} to ensure that your cluster meets the requirements. -// Hiding in ROSA/OSD as not supported +// hiding 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]. +// the following section is in the assembly for xref reasons +[id="virt-cloud-platforms_{context}"] +== Compatible cloud platforms -{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. +{VirtProductName} is 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. -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 +ifdef::openshift-enterprise[] +:FeatureName: Installing {VirtProductName} on certain cloud platforms include::snippets/technology-preview.adoc[] -:!FeatureName: - -endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] +endif::[] -// Hiding in ROSA/OSD as FIPS not supported -ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] -.FIPS mode +[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 +// | +|=== -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[] +[role="_additional-resources"] +.Additional resources +* xref:../../virt/vm_networking/virt-networking-overview.adoc#virt-networking[Networking overview] +// * https://catalog.redhat.com/search?p=1&target_platforms=Red%20Hat%20OpenShift[{product-title} partners in the Red{nbsp}Hat Ecosystem Catalog] +endif::[] -[id="supported-platforms_preparing-cluster-for-virt"] -== Supported platforms +[id="bare-metal-support_preparing-cluster-for-virt"] +== Bare metal support You can use the following platforms with {VirtProductName}: @@ -48,15 +86,15 @@ ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] * 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}]. + @@ -146,6 +184,35 @@ 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