openshift/openshift-docs
1
0
Fork 0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Code Issues Releases Activity

CNV#28025: AWS BM GA and considerations

Browse Source
This commit is contained in:
Pan Ousley
2023-10-20 14:39:40 -04:00
committed by openshift-cherrypick-robot
parent 70c259168c
commit ad48d0a8ed
2 changed files with 81 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files

60
modules/virt-aws-bm.adoc Normal file
View File

@@ -0,0 +1,60 @@
// Module included in the following assemblies:
//
// * virt/install/preparing-cluster-for-virt.adoc
:_content-type: CONCEPT
[id="virt-aws-bm_{context}"]
= {VirtProductName} on AWS bare metal
You can run {VirtProductName} on an Amazon Web Services (AWS) bare-metal {product-title} cluster. Before you set up your cluster, review the following summary of supported features and limitations:
Installing::
--
* You can install the cluster by using installer-provisioned infrastructure, ensuring that you specify bare-metal node instance types in the `install-config.yaml` file. For example, you can use the `c5n.metal` type value for a machine based on x86_64 architecture.
+
For more information, see the {product-title} documentation about installing on AWS.
--
Accessing virtual machines (VMs)::
--
* There is no change to how you access VMs by using the `virtctl` CLI tool or the {product-title} web console.
* You can expose VMs by using a `NodePort` or `LoadBalancer` service.
** The load balancer approach is preferable because {product-title} automatically creates the load balancer in AWS and manages its lifecycle. A security group is also created for the load balancer, and you can use annotations to attach existing security groups. When you remove the service, {product-title} removes the load balancer and its associated resources.
--
Networking::
--
* You cannot use Single Root I/O Virtualization (SR-IOV) or bridge Container Network Interface (CNI) networks, including virtual LAN (VLAN). If your application requires a flat layer 2 network or control over the IP pool, consider using OVN-Kubernetes secondary overlay networks.
--
Storage::
--
* link:https://docs.portworx.com/portworx-enterprise/install-portworx/openshift[Portworx] is supported as a storage provider for {VirtProductName} on AWS bare metal.
** To use Portworx with {VirtProductName}, you must configure the `StorageClass` manifest to support live migration. For example:
+
.Example `StorageClass` manifest
[source,yaml]
----
allowVolumeExpansion: true
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
annotations:
params/aggregation_level: Specifies the number of replication sets the volume
can be aggregated from
#...
name: px-csi-db-shared
parameters:
io_profile: db_remote
repl: "2" <1>
sharedv4: "true"
sharedv4_mount_options: vers=3.0,nolock <2>
sharedv4_svc_type: ClusterIP
provisioner: pxd.portworx.com
reclaimPolicy: Delete
volumeBindingMode: Immediate
----
<1> Use `repl: "2"` for a cluster with 3 worker nodes.
<2> You must use NFS version 3 with the `nolock` mount option.
--
* Amazon Elastic File System (EFS) and Amazon Elastic Block Store (EBS) are not supported for use with {VirtProductName} due to performance and functionality limitations.

39
virt/install/preparing-cluster-for-virt.adoc
View File

@@ -25,25 +25,15 @@ You cannot run {VirtProductName} on a single-stack IPv6 cluster.
If you install your cluster in xref:../../installing/installing-fips.adoc#installing-fips-mode_installing-fips[FIPS mode], no additional setup is required for {VirtProductName}.
// Section is in assembly so that we can use xrefs
[id="virt-hardware-os-requirements_preparing-cluster-for-virt"]
== Hardware and operating system requirements
Review the following hardware and operating system requirements for {VirtProductName}.
[id="supported-platforms_preparing-cluster-for-virt"]
=== Supported platforms
== Supported platforms
You can use the following platforms with {VirtProductName}:
* 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 link:https://access.redhat.com/articles/6409731[Deploy {VirtProductName} on AWS metal instance types].
+
--
ifdef::openshift-enterprise[]
:FeatureName: Installing OpenShift Virtualization on AWS bare metal instances
include::snippets/technology-preview.adoc[]
:!FeatureName:
endif::[]
--
* Amazon Web Services bare metal instances. See xref:../../installing/installing_aws/installing-aws-customizations.html#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 Bare Metal Servers. See link:https://access.redhat.com/articles/6738731[Deploy {VirtProductName} on IBM Cloud Bare Metal nodes].
+
@@ -54,8 +44,21 @@ include::snippets/technology-preview.adoc[]
:!FeatureName:
endif::[]
--
+
*Bare metal instances or servers offered by other cloud providers are not supported.*
Bare metal instances or servers offered by other cloud providers are not supported.
include::modules/virt-aws-bm.adoc[leveloffset=+2]
[role="_additional-resources"]
.Additional resources
* xref:../../virt/vm_networking/virt-connecting-vm-to-ovn-secondary-network.adoc#virt-connecting-vm-to-ovn-secondary-network[Connecting a virtual machine to an OVN-Kubernetes secondary network]
* xref:../../virt/vm_networking/virt-exposing-vm-with-service.adoc#virt-exposing-vm-with-service[Exposing a virtual machine by using a service]
// Section is in assembly so that we can use xrefs
[id="virt-hardware-os-requirements_preparing-cluster-for-virt"]
== Hardware and operating system requirements
Review the following hardware and operating system requirements for {VirtProductName}.
[id="cpu-requirements_preparing-cluster-for-virt"]
=== CPU requirements