Merge pull request #63059 from kelbrown20/OSDOCS-7227-reformat-multi-arch-docs

OSDOCS-7227: Reformatting multi-arch compute machines docs

Author: kelbrown20

_topic_maps/_topic_map.yml

@@ -521,8 +521,19 @@ Topics:
 - Name: Bare metal configuration
   File: bare-metal-configuration
 - Name: Configuring multi-architecture compute machines on an OpenShift cluster
+  Dir: configuring-multi-arch-compute-machines
   Distros: openshift-enterprise
-  File: multi-architecture-configuration
+  Topics: 
+  - Name: About clusters with multi-architecture compute machines 
+    File: multi-architecture-configuration
+  - Name: Creating a cluster with multi-architecture compute machines on Azure 
+    File: creating-multi-arch-compute-nodes-azure
+  - Name: Creating a cluster with multi-architecture compute machines on AWS
+    File: creating-multi-arch-compute-nodes-aws
+  - Name: Creating a cluster with multi-architecture compute machines on bare metal
+    File: creating-multi-arch-compute-nodes-bare-metal
+  - Name: Managing your cluster with multi-architecture compute machines
+    File: multi-architecture-compute-managing
 - Name: Enabling encryption on a vSphere cluster
   File: vsphere-post-installation-encryption
 - Name: Machine configuration tasks

post_installation_configuration/configuring-multi-arch-compute-machines/_attributes

@@ -0,0 +1 @@
+../../_attributes/

post_installation_configuration/configuring-multi-arch-compute-machines/creating-multi-arch-compute-nodes-aws.adoc

@@ -0,0 +1,18 @@
+:_content-type: ASSEMBLY
+:context: creating-multi-arch-compute-nodes-aws
+[id="creating-multi-arch-compute-nodes-aws"]
+= Creating a cluster with multi-architecture compute machines on AWS
+include::_attributes/common-attributes.adoc[]
+
+toc::[]
+
+To create an AWS cluster with multi-architecture compute machines, you must first create a single-architecture AWS installer-provisioned cluster with the multi-architecture installer binary. For more information on AWS installations, refer to xref:../../installing/installing_aws/installing-aws-customizations.adoc[Installing a cluster on AWS with customizations]. You can then add a ARM64 compute machine set to your AWS cluster.
+
+include::modules/multi-architecture-verifying-cluster-compatibility.adoc[leveloffset=+1]
+
+include::modules/multi-architecture-modify-machine-set-aws.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+* xref:../../installing/installing_aws/installing-aws-customizations.adoc#installation-aws-arm-tested-machine-types_installing-aws-customizations[Tested instance types for AWS 64-bit ARM]
+

post_installation_configuration/configuring-multi-arch-compute-machines/creating-multi-arch-compute-nodes-azure.adoc

@@ -0,0 +1,21 @@
+:_content-type: ASSEMBLY
+:context: creating-multi-arch-compute-nodes-azure
+[id="creating-multi-arch-compute-nodes-azure"]
+= Creating a cluster with multi-architecture compute machine on Azure
+include::_attributes/common-attributes.adoc[]
+
+toc::[]
+
+To deploy an Azure cluster with multi-architecture compute machines, you must first create a single-architecture Azure installer-provisioned cluster that uses the multi-architecture installer binary. For more information on Azure installations, see xref:../../installing/installing_azure/installing-azure-customizations.adoc#installing-azure-customizations[Installing a cluster on Azure with customizations]. You can then add an ARM64 compute machine set to your cluster to create a cluster with multi-architecture compute machines.
+
+The following procedures explain how to generate an ARM64 boot image and create an Azure compute machine set that uses the ARM64 boot image. This adds ARM64 compute nodes to your cluster and deploys the amount of ARM64 virtual machines (VM) that you need.
+
+include::modules/multi-architecture-verifying-cluster-compatibility.adoc[leveloffset=+1]
+
+include::modules/multi-architecture-creating-arm64-bootimage.adoc[leveloffset=+1]
+
+include::modules/multi-architecture-modify-machine-set.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+* xref:../../machine_management/creating_machinesets/creating-machineset-azure.adoc#creating-machineset-azure[Creating a compute machine set on Azure]

post_installation_configuration/configuring-multi-arch-compute-machines/creating-multi-arch-compute-nodes-bare-metal.adoc

@@ -0,0 +1,24 @@
+:_content-type: ASSEMBLY
+:context: creating-multi-arch-compute-nodes-bare-metal
+[id="creating-multi-arch-compute-nodes-bare-metal"]
+= Creating a cluster with multi-architecture compute machine on bare metal (Technology Preview)
+include::_attributes/common-attributes.adoc[]
+
+toc::[]
+
+To create a cluster with multi-architecture compute machines on bare metal, you must have an existing single-architecture bare metal cluster. For more information on bare metal installations, see xref:../../installing/installing_bare_metal/installing-bare-metal.adoc#installing-bare-metal[Installing a user provisioned cluster on bare metal]. You can then add 64-bit ARM compute machines to your {product-title} cluster on bare metal.
+
+Before you can add 64-bit ARM nodes to your bare metal cluster, you must upgrade your cluster to one that uses the multi-architecture payload. For more information on migrating to the multi-architecture payload, see xref:../../updating/updating_a_cluster/migrating-to-multi-payload.adoc#migrating-to-multi-payload[Migrating to a cluster with multi-architecture compute machines].
+
+The following procedures explain how to create a {op-system} compute machine using an ISO image or network PXE booting. This will allow you to add ARM64 nodes to your bare metal cluster and deploy a cluster with multi-architecture compute machines.
+
+:Featurename: Clusters with multi-architecture compute machines on bare metal user-provisioned installations
+include::snippets/technology-preview.adoc[leveloffset=+1]
+
+include::modules/multi-architecture-verifying-cluster-compatibility.adoc[leveloffset=+1]
+
+include::modules/machine-user-infra-machines-iso.adoc[leveloffset=+1]
+
+include::modules/machine-user-infra-machines-pxe.adoc[leveloffset=+1]
+
+include::modules/installation-approve-csrs.adoc[leveloffset=+1]

post_installation_configuration/configuring-multi-arch-compute-machines/images

@@ -0,0 +1 @@
+../../images/

post_installation_configuration/configuring-multi-arch-compute-machines/modules

@@ -0,0 +1 @@
+../../modules/

post_installation_configuration/configuring-multi-arch-compute-machines/multi-architecture-compute-managing.adoc

@@ -0,0 +1,8 @@
+:_content-type: ASSEMBLY
+:context: multi-architecture-compute-managing
+[id="multi-architecture-compute-managing"]
+= Managing your cluster with multi-architecture compute machines
+
+toc::[] 
+
+include::modules/multi-architecture-import-imagestreams.adoc[leveloffset=+1]

post_installation_configuration/configuring-multi-arch-compute-machines/multi-architecture-configuration.adoc

@@ -0,0 +1,31 @@
+:_content-type: CONCEPT
+:context: multi-architecture-configuration
+[id="post-install-multi-architecture-configuration"]
+= About clusters with multi-architecture compute machines 
+include::_attributes/common-attributes.adoc[]
+
+toc::[]
+
+An {product-title} cluster with multi-architecture compute machines is a cluster that supports compute machines with different architectures. Clusters with multi-architecture compute machines are available only on AWS or Azure installer-provisioned infrastructures and bare metal user-provisioned infrastructures with x86_64 control plane machines.
+
+[NOTE]
+====
+When there are nodes with multiple architectures in your cluster, the architecture of your image must be consistent with the architecture of the node. You need to ensure that the pod is assigned to the node with the appropriate architecture and that it matches the image architecture. For more information on assigning pods to nodes, see link:https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/[Assigning pods to nodes].
+====
+
+[IMPORTANT]
+====
+The Cluster Samples Operator is not supported on clusters with multi-architecture compute machines. Your cluster can be created without this capability. For more information, see xref:../../post_installation_configuration/enabling-cluster-capabilities.adoc#enabling-cluster-capabilities[Enabling cluster capabilities]
+====
+
+For information on migrating your single-architecture cluster to a cluster that supports multi-architecture compute machines, see xref:../../updating/updating_a_cluster/migrating-to-multi-payload.adoc#migrating-to-multi-payload[Migrating to a cluster with multi-architecture compute machines].
+
+== Configuring your cluster with multi-architecture compute machines 
+
+To create a cluster with multi-architecture compute machines for various platforms, you can use the documentation in the following sections:
+
+* xref:../../post_installation_configuration/configuring-multi-arch-compute-machines/creating-multi-arch-compute-nodes-azure.adoc#creating-multi-arch-compute-nodes-azure[Creating a cluster with multi-architecture compute machines on Azure]
+
+* xref:../../post_installation_configuration/configuring-multi-arch-compute-machines/creating-multi-arch-compute-nodes-aws.adoc#creating-multi-arch-compute-nodes-aws[Creating a cluster with multi-architecture compute machines on AWS]
+
+* xref:../../post_installation_configuration/configuring-multi-arch-compute-machines/creating-multi-arch-compute-nodes-bare-metal.adoc#creating-multi-arch-compute-nodes-bare-metal[Creating a cluster with multi-architecture compute machines on bare metal]

post_installation_configuration/configuring-multi-arch-compute-machines/snippets

@@ -0,0 +1 @@
+../../snippets/