Skip to content

CNV#64393: cloud platforms matrix #95622

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

CNV#64393: cloud platforms matrix #95622

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
129 changes: 98 additions & 31 deletions virt/install/preparing-cluster-for-virt.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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"]
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] RedHat.TermsErrors: Use 'bare-metal servers' rather than 'bare metal servers'. For more information, see RedHat.TermsErrors.

== Bare metal support

You can use the following platforms with {VirtProductName}:

Expand All @@ -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}].
+
Expand Down Expand Up @@ -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
Expand Down