Skip to content

Commit 5adb697

Browse files
ousleypopenshift-cherrypick-robot
authored andcommitted
CNV#64393: cloud platforms matrix
1 parent ff5a0cb commit 5adb697

File tree

1 file changed

+106
-40
lines changed

1 file changed

+106
-40
lines changed

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

Lines changed: 106 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -7,72 +7,107 @@ 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
13-
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-
{VirtProductName} support for single-stack IPv6 clusters is limited to the OVN-Kubernetes localnet and Linux bridge Container Network Interface (CNI) plugins.
24-
====
25-
26-
:FeatureName: Deploying {VirtProductName} on a single-stack IPv6 cluster
27-
include::snippets/technology-preview.adoc[]
28-
:!FeatureName:
29-
30-
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
31-
32-
// Hiding in ROSA/OSD as FIPS not supported
12+
// Hiding compatible platforms list in ROSA/OSD
3313
ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
34-
.FIPS mode
35-
36-
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}.
37-
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
3814

39-
[id="supported-platforms_preparing-cluster-for-virt"]
40-
== Supported platforms
15+
[id="compatible-platforms_{context}"]
16+
== Compatible platforms
4117

4218
You can use the following platforms with {VirtProductName}:
4319

44-
// Hiding in ROSA/OSD, as bare metal not supported
45-
ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
4620
* 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}].
4721

48-
* 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].
49-
//See link:https://access.redhat.com/articles/6409731[Deploy {VirtProductName} on AWS metal instance types]. // seems outdated with references to OCS - remove?
22+
//* {ibm-cloud-name} Bare Metal Servers. See link:https://access.redhat.com/articles/6738731[Deploy {VirtProductName} on {ibm-cloud-name} Bare Metal nodes].
23+
//+
24+
//--
25+
//ifdef::openshift-enterprise[]
26+
//:FeatureName: Installing OpenShift Virtualization on {ibm-cloud-name} Bare Metal Servers
27+
//include::snippets/technology-preview.adoc[]
28+
//:!FeatureName:
29+
//endif::[]
30+
//--
5031
51-
* {ibm-cloud-name} Bare Metal Servers. See link:https://access.redhat.com/articles/6738731[Deploy {VirtProductName} on {ibm-cloud-name} Bare Metal nodes].
32+
* {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}].
5233
+
5334
--
5435
ifdef::openshift-enterprise[]
55-
:FeatureName: Installing OpenShift Virtualization on {ibm-cloud-name} Bare Metal Servers
36+
:FeatureName: Using {VirtProductName} in a cluster deployed on s390x architecture
5637
include::snippets/technology-preview.adoc[]
5738
:!FeatureName:
5839
endif::[]
5940
--
6041
61-
* {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}].
42+
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
43+
44+
// hiding in rosa/osd
45+
ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
46+
// the following section is in the assembly for xref reasons
47+
Cloud platforms::
48+
49+
{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.
6250
+
6351
--
6452
ifdef::openshift-enterprise[]
65-
:FeatureName: Using {VirtProductName} in a cluster deployed on s390x architecture
53+
:FeatureName: Installing {VirtProductName} on certain cloud platforms
6654
include::snippets/technology-preview.adoc[]
6755
:!FeatureName:
6856
endif::[]
6957
--
7058
71-
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
59+
[cols="1,1,2,2a", options="header"]
60+
|===
61+
| Vendor
62+
| Status
63+
| Storage
64+
| Related links
65+
66+
| {aws-first}
67+
| GA
68+
| Elastic Block Store (EBS), {odf-first}, Portworx, FSx (NetApp)
69+
| * xref:../../installing/installing_aws/ipi/installing-aws-customizations.adoc#installing-aws-customizations[Installing a cluster on AWS with customizations]
70+
71+
| {product-rosa} (ROSA)
72+
| GA
73+
| EBS, Portworx, FSx (Q3), {odf-short}
74+
| * link:https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/virtualization/index[{VirtProductName}] in the {product-rosa} documentation
75+
* link:https://docs.aws.amazon.com/rosa/latest/userguide/what-is-rosa.html[What is {product-rosa}?] in the {aws-short} documentation
76+
77+
| {oci-first-no-rt}
78+
| Technology Preview
79+
| {oci} native storage
80+
| * link:https://access.redhat.com/articles/7118050[{VirtProductName} and Oracle Cloud Infrastructure known issues and limitations] in the Red{nbsp}Hat Knowledgebase
81+
* 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
82+
83+
| Azure Red{nbsp}Hat OpenShift (ARO)
84+
| Technology Preview
85+
| {odf-short}
86+
| * link:https://learn.microsoft.com/en-us/azure/openshift/howto-create-openshift-virtualization[{VirtProductName} for Azure Red Hat OpenShift (preview)] in the Microsoft documentation
87+
88+
| {gcp-first}
89+
| Technology Preview
90+
| {gcp-short} native storage
91+
| * link:https://access.redhat.com/articles/7120382[{VirtProductName} and {gcp-full} known storage issues and limitations] in the Red{nbsp}Hat Knowledgebase
92+
93+
// tracker: https://issues.redhat.com/browse/XCMSTRAT-1191
94+
// | {product-dedicated}
95+
// | Technology Preview
96+
// | {gcp-short} native storage
97+
// |
98+
99+
// | {ibm-cloud-title}
100+
// | Technology Preview
101+
// | IBM Fusion
102+
// |
103+
|===
104+
105+
[TIP]
106+
====
107+
For platform-specific networking information, see the xref:../../virt/vm_networking/virt-networking-overview.adoc#virt-networking[networking overview].
108+
====
72109
73-
ifdef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
74-
* Amazon Web Services bare metal instances.
75-
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
110+
endif::[]
76111
77112
// Hiding in ROSA/OSD, as bare metal not supported
78113
ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
@@ -146,6 +181,37 @@ The following features are available for use on s390x architecture but function
146181
147182
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
148183
184+
// Hiding in ROSA/OSD as not supported
185+
ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
186+
187+
[id="important-considerations_preparing-cluster-for-virt"]
188+
== Important considerations for any platform
189+
190+
Before you install {VirtProductName} on any platform, note the following caveats and considerations.
191+
192+
Installation method considerations::
193+
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].
194+
195+
{rh-storage-first}::
196+
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.
197+
198+
IPv6::
199+
{VirtProductName} support for single-stack IPv6 clusters is limited to the OVN-Kubernetes localnet and Linux bridge Container Network Interface (CNI) plugins.
200+
+
201+
--
202+
:FeatureName: Deploying {VirtProductName} on a single-stack IPv6 cluster
203+
include::snippets/technology-preview.adoc[]
204+
:!FeatureName:
205+
--
206+
207+
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
208+
209+
// Hiding in ROSA/OSD as FIPS not supported
210+
ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
211+
212+
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}.
213+
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
214+
149215
// Section is in assembly so that we can use xrefs
150216
[id="virt-hardware-os-requirements_preparing-cluster-for-virt"]
151217
== Hardware and operating system requirements

0 commit comments

Comments
 (0)