Merge pull request #83248 from lahinson/osdocs-11101-arm-hcp

[OSDOCS-11101]: Updating multiarch docs for HCP

Author: lahinson

hosted_control_planes/hcp-deploy/hcp-deploy-aws.adoc

@@ -48,6 +48,11 @@ include::modules/hcp-aws-enable-private-link.adoc[leveloffset=+1]
 
 include::modules/hcp-aws-deploy-hc.adoc[leveloffset=+1]
 
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../../hosted_control_planes/hcp-deploy/hcp-deploy-aws.adoc#hcp-enable-arm-amd_hcp-deploy-aws[Running hosted clusters on an ARM64 architecture]
+
 include::modules/hcp-access-pub-hc-aws.adoc[leveloffset=+2]
 
 include::modules/hcp-access-pub-hc-aws-cli.adoc[leveloffset=+2]

modules/hcp-aws-deploy-hc.adoc

@@ -8,6 +8,18 @@
 
 You can deploy a hosted cluster on {aws-first} by using the `hcp` command-line interface (CLI).
 
+By default for {hcp} on {aws-first}, you use an AMD64 hosted cluster. However, you can enable {hcp} to run on an ARM64 hosted cluster. For more information, see "Running hosted clusters on an ARM64 architecture".
+
+For compatible combinations of node pools and hosted clusters, see the following table:
+
+.Compatible architectures for node pools and hosted clusters
+[cols="2,2",options="header"]
+|===
+| Hosted cluster | Node pools
+| AMD64 | AMD64 or ARM64
+| ARM64 | ARM64 or AMD64
+|===
+
 .Prerequisites
 
 * You have set up the hosted control plane CLI, `hcp`.

modules/hcp-create-hc-arm64-aws.adoc

@@ -8,6 +8,8 @@
 
 You can run a hosted cluster on an ARM64 {product-title} cluster for {aws-first} by overriding the default release image with a multi-architecture release image.
 
+If you do not use a multi-architecture release image, the compute nodes in the node pool are not created and reconciliation of the node pool stops until you either use a multi-architecture release image in the hosted cluster or update the `NodePool` custom resource based on the release image.
+
 .Prerequisites
 
 * You must have an {product-title} cluster with a 64-bit ARM infrastructure that is installed on {aws-short}. For more information, see link:https://console.redhat.com/openshift/install/aws/arm[Create an {product-title} Cluster: {aws-short} (ARM)].
@@ -27,8 +29,7 @@ $ hcp create cluster aws \
   --sts-creds <path_to_sts_credential_file> \// <5>
   --region <region> \// <6>
   --release-image quay.io/openshift-release-dev/ocp-release:<ocp_release_image> \// <7>
-  --role-arn <role_name> \// <8>
-  --multi-arch <9>
+  --role-arn <role_name> <8>
 ----
 <1> Specify the name of your hosted cluster, for instance, `example`.
 <2> Specify the node pool replica count, for example, `3`.
@@ -38,7 +39,6 @@ $ hcp create cluster aws \
 <6> Specify the AWS region name, for example, `us-east-1`.
 <7> Specify the supported {product-title} version that you want to use, for example, `4.17.0-multi`. If you are using a disconnected environment, replace `<ocp_release_image>` with the digest image. To extract the {product-title} release image digest, see "Extracting the {product-title} release image digest".
 <8> Specify the Amazon Resource Name (ARN), for example, `arn:aws:iam::820196288204:role/myrole`.
-<9> The `multi-arch` flag indicates that the hosted cluster supports both `amd64` and `arm64` node pools. When you set the flag and supply a release image, the release image must be a multi-architecture release image. When you set the flag and supply a release stream, the release stream must be a multi-architecture release stream. If you do not set the `multi-arch` flag, the management cluster and node pool CPU architectures must match. Otherwise, a warning is displayed. A node pool supports only one CPU architecture within the same node pool.
 
 . Add a `NodePool` object to the hosted cluster by running the following command:
 +
@@ -51,4 +51,4 @@ $ hcp create nodepool aws \
 ----
 <1> Specify the name of your hosted cluster, for instance, `example`.
 <2> Specify the node pool name.
-<3> Specify the node pool replica count, for example, `3`.
+<3> Specify the node pool replica count, for example, `3`.

modules/hcp-enable-arm-amd.adoc

@@ -4,7 +4,7 @@
 
 :_mod-docs-content-type: CONCEPT
 [id="hcp-enable-arm-amd_{context}"]
-= Running hosted clusters on AMD64 and AMD64 architectures
+= Running hosted clusters on an ARM64 architecture
 
 By default for {hcp} on {aws-first}, you use an AMD64 hosted cluster. However, you can enable {hcp} to run on an ARM64 hosted cluster.
 
@@ -16,4 +16,4 @@ For compatible combinations of node pools and hosted clusters, see the following
 | Hosted cluster | Node pools
 | AMD64 | AMD64 or ARM64
 | ARM64 | ARM64 or AMD64
-|===
+|===