Chapter 16. Installing a cluster with the support for configuring multi-architecture compute machines
An OpenShift Container Platform cluster with multi-architecture compute machines supports compute machines with different architectures.
When you have nodes with multiple architectures in your cluster, the architecture of your image must be consistent with the architecture of the node. You must 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, Scheduling workloads on clusters with multi-architecture compute machines.
You can install a Google Cloud Platform (GCP) cluster with the support for configuring multi-architecture compute machines. After installing the GCP cluster, you can add multi-architecture compute machines to the cluster in the following ways:
- Adding 64-bit x86 compute machines to a cluster that uses 64-bit ARM control plane machines and already includes 64-bit ARM compute machines. In this case, 64-bit x86 is considered the secondary architecture.
- Adding 64-bit ARM compute machines to a cluster that uses 64-bit x86 control plane machines and already includes 64-bit x86 compute machines. In this case, 64-bit ARM is considered the secondary architecture.
Before adding a secondary architecture node to your cluster, it is recommended to install the Multiarch Tuning Operator, and deploy a ClusterPodPlacementConfig
custom resource. For more information, see "Managing workloads on multi-architecture clusters by using the Multiarch Tuning Operator".
16.1. Installing a cluster with multi-architecture support
You can install a cluster with the support for configuring multi-architecture compute machines.
Prerequisites
-
You installed the OpenShift CLI (
oc
). - You have the OpenShift Container Platform installation program.
- You downloaded the pull secret for your cluster.
Procedure
Check that the
openshift-install
binary is using themulti
payload by running the following command:$ ./openshift-install version
Example output
./openshift-install 4.17.0 built from commit abc123etc release image quay.io/openshift-release-dev/ocp-release@sha256:abc123wxyzetc release architecture multi default architecture amd64
The output must contain
release architecture multi
to indicate that theopenshift-install
binary is using themulti
payload.Update the
install-config.yaml
file to configure the architecture for the nodes.Sample
install-config.yaml
file with multi-architecture configurationapiVersion: v1 baseDomain: example.openshift.com compute: - architecture: amd64 1 hyperthreading: Enabled name: worker platform: {} replicas: 3 controlPlane: architecture: arm64 2 name: master platform: {} replicas: 3 # ...
Next steps