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.

Note

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.
Note

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

  1. Check that the openshift-install binary is using the multi 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 the openshift-install binary is using the multi payload.

  2. Update the install-config.yaml file to configure the architecture for the nodes.

    Sample install-config.yaml file with multi-architecture configuration

    apiVersion: 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
    # ...

    1
    Specify the architecture of the worker node. You can set this field to either arm64 or amd64.
    2
    Specify the control plane node architecture. You can set this field to either arm64 or amd64.
Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.