Skip to content

Commit 363c2b6

Browse files
authored
Merge pull request #96590 from ousleyp/cnv-64393-18
[enterprise-4.18] CNV#64393: cloud platforms matrix
2 parents 6bf483f + 79a1217 commit 363c2b6

File tree

1 file changed

+99
-36
lines changed

1 file changed

+99
-36
lines changed

virt/install/preparing-cluster-for-virt.adoc

Lines changed: 99 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -7,66 +7,105 @@ include::_attributes/common-attributes.adoc[]
77

88
toc::[]
99

10-
Review this section before you install {VirtProductName} to ensure that your cluster meets the requirements.
10+
Before you install {VirtProductName}, review this section to ensure that your cluster meets the requirements.
1111

12-
// Hiding in ROSA/OSD as not supported
12+
// Hiding compatible platforms list in ROSA/OSD
1313
ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
14-
[IMPORTANT]
15-
====
16-
Installation method considerations::
17-
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].
18-
19-
{rh-storage-first}::
20-
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.
21-
22-
IPv6::
23-
You cannot run {VirtProductName} on a single-stack IPv6 cluster.
24-
====
25-
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
26-
27-
// Hiding in ROSA/OSD as FIPS not supported
28-
ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
29-
.FIPS mode
30-
31-
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}.
32-
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
33-
34-
[id="supported-platforms_preparing-cluster-for-virt"]
35-
== Supported platforms
14+
[id="compatible-platforms_{context}"]
15+
== Compatible platforms
3616

3717
You can use the following platforms with {VirtProductName}:
3818

39-
// Hiding in ROSA/OSD, as bare metal not supported
40-
ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
4119
* 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}].
4220
43-
* 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].
44-
//See link:https://access.redhat.com/articles/6409731[Deploy {VirtProductName} on AWS metal instance types]. // seems outdated with references to OCS - remove?
21+
//* {ibm-cloud-name} Bare Metal Servers. See link:https://access.redhat.com/articles/6738731[Deploy {VirtProductName} on {ibm-cloud-name} Bare Metal nodes].
22+
//+
23+
//--
24+
//ifdef::openshift-enterprise[]
25+
//:FeatureName: Installing OpenShift Virtualization on {ibm-cloud-name} Bare Metal Servers
26+
//include::snippets/technology-preview.adoc[]
27+
//:!FeatureName:
28+
//endif::[]
29+
//--
4530

46-
* {ibm-cloud-name} Bare Metal Servers. See link:https://access.redhat.com/articles/6738731[Deploy {VirtProductName} on {ibm-cloud-name} Bare Metal nodes].
31+
* {ibm-z-name} or {ibm-linuxone-name} (s390x architecture) systems where an {product-title} cluster is installed in a logical partition (LPAR). 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}].
4732
+
4833
--
4934
ifdef::openshift-enterprise[]
50-
:FeatureName: Installing OpenShift Virtualization on {ibm-cloud-name} Bare Metal Servers
35+
:FeatureName: Using {VirtProductName} in a cluster deployed on s390x architecture
5136
include::snippets/technology-preview.adoc[]
5237
:!FeatureName:
5338
endif::[]
5439
--
40+
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
5541
56-
* {ibm-z-name} or {ibm-linuxone-name} (s390x architecture) systems where an {product-title} cluster is installed in a logical partition (LPAR). 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}].
42+
// hiding in rosa/osd
43+
ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
44+
// the following section is in the assembly for xref reasons
45+
Cloud platforms::
46+
47+
{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.
5748
+
5849
--
5950
ifdef::openshift-enterprise[]
60-
:FeatureName: Using {VirtProductName} in a cluster deployed on s390x architecture
51+
:FeatureName: Installing {VirtProductName} on certain cloud platforms
6152
include::snippets/technology-preview.adoc[]
6253
:!FeatureName:
6354
endif::[]
6455
--
65-
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
6656

67-
ifdef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
68-
* Amazon Web Services bare metal instances.
69-
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
57+
[cols="1,1,2,2a", options="header"]
58+
|===
59+
| Vendor
60+
| Status
61+
| Storage
62+
| Related links
63+
64+
| {aws-first}
65+
| GA
66+
| Elastic Block Store (EBS), {odf-first}, Portworx, FSx (NetApp)
67+
| * xref:../../installing/installing_aws/ipi/installing-aws-customizations.adoc#installing-aws-customizations[Installing a cluster on AWS with customizations]
68+
69+
| {product-rosa} (ROSA)
70+
| GA
71+
| EBS, Portworx, FSx (Q3), {odf-short}
72+
| * link:https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/virtualization/index[{VirtProductName}] in the {product-rosa} documentation
73+
* link:https://docs.aws.amazon.com/rosa/latest/userguide/what-is-rosa.html[What is {product-rosa}?] in the {aws-short} documentation
74+
75+
| {oci-first-no-rt}
76+
| Technology Preview
77+
| {oci} native storage
78+
| * link:https://access.redhat.com/articles/7118050[{VirtProductName} and Oracle Cloud Infrastructure known issues and limitations] in the Red{nbsp}Hat Knowledgebase
79+
* 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
80+
81+
| Azure Red{nbsp}Hat OpenShift (ARO)
82+
| Technology Preview
83+
| {odf-short}
84+
| * link:https://learn.microsoft.com/en-us/azure/openshift/howto-create-openshift-virtualization[{VirtProductName} for Azure Red Hat OpenShift (preview)] in the Microsoft documentation
85+
86+
| {gcp-first}
87+
| Technology Preview
88+
| {gcp-short} native storage
89+
| * link:https://access.redhat.com/articles/7120382[{VirtProductName} and {gcp-full} known storage issues and limitations] in the Red{nbsp}Hat Knowledgebase
90+
91+
// tracker: https://issues.redhat.com/browse/XCMSTRAT-1191
92+
// | {product-dedicated}
93+
// | Technology Preview
94+
// | {gcp-short} native storage
95+
// |
96+
97+
// | {ibm-cloud-title}
98+
// | Technology Preview
99+
// | IBM Fusion
100+
// |
101+
|===
102+
103+
[TIP]
104+
====
105+
For platform-specific networking information, see the xref:../../virt/vm_networking/virt-networking-overview.adoc#virt-networking[networking overview].
106+
====
107+
108+
endif::[]
70109

71110
// Hiding in ROSA/OSD, as bare metal not supported
72111
ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
@@ -135,6 +174,30 @@ $ virtctl restart <vm_name>
135174

136175
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
137176

177+
// Hiding in ROSA/OSD as not supported
178+
ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
179+
180+
[id="important-considerations_preparing-cluster-for-virt"]
181+
== Important considerations for any platform
182+
183+
Before you install {VirtProductName} on any platform, note the following caveats and considerations.
184+
185+
Installation method considerations::
186+
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].
187+
188+
{rh-storage-first}::
189+
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.
190+
191+
IPv6:: You cannot run {VirtProductName} on a single-stack IPv6 cluster.
192+
193+
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
194+
195+
// Hiding in ROSA/OSD as FIPS not supported
196+
ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
197+
198+
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}.
199+
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
200+
138201
// Section is in assembly so that we can use xrefs
139202
[id="virt-hardware-os-requirements_preparing-cluster-for-virt"]
140203
== Hardware and operating system requirements

0 commit comments

Comments
 (0)