Red Hat Summit Red Hat SummitApoyoConsolaDesarrolladoresIniciar una pruebaContacto

Este contenido no está disponible en el idioma seleccionado.

Chapter 10. Migrating to a cluster with multi-architecture compute machines

You can migrate your current cluster with single-architecture compute machines to a cluster with multi-architecture compute machines by updating to a multi-architecture, manifest-listed payload. This allows you to add mixed architecture compute nodes to your cluster.

For information about configuring your multi-architecture compute machines, see Configuring multi-architecture compute machines on an OpenShift Container Platform cluster.

Important

Migration from a multi-architecture payload to a single-architecture payload is not supported. Once a cluster has transitioned to using a multi-architecture payload, it can no longer accept a single-architecture upgrade payload.

Prerequisites

  • You have access to the cluster as a user with the cluster-admin role.

  • Your OpenShift Container Platform version is up to date to at least version 4.13.0.

    For more information on how to update your cluster version, see Updating a cluster using the web console or Updating a cluster using the CLI.

  • You have installed the OpenShift CLI (oc) that matches the version for your current cluster.
  • Your oc client is updated to at least verion 4.13.0.

  • Your OpenShift Container Platform cluster is installed on either the AWS or Azure platform.

    For more information on selecting a supported platform for your cluster installation, see Selecting a cluster installation type.

Procedure

  1. Verify that the RetrievedUpdates condition is True in the Cluster Version Operator (CVO) by running the following command: 

    $ oc get clusterversion/version -o=jsonpath="{.status.conditions[?(.type=='RetrievedUpdates')].status}"
    Copy to Clipboard Toggle word wrap

    If the RetrievedUpates condition is False, you can find supplemental information regarding the failure by using the following command: 

    $ oc adm upgrade
    Copy to Clipboard Toggle word wrap

    For more information about cluster version condition types, see Understanding cluster version condition types.

  2. If the condition RetrievedUpdates is False, change the channel to stable-<4.y> or fast-<4.y> with the following command: 

    $ oc adm upgrade channel <channel>
    Copy to Clipboard Toggle word wrap

    After setting the channel, verify if RetrievedUpdates is True.

    For more information about channels, see Understanding update channels and releases.

  3. Migrate to the multi-architecture payload with following command: 

    $ oc adm upgrade --to-multi-arch
    Copy to Clipboard Toggle word wrap

Verification

  • You can monitor the migration by running the following command: 

    $ oc adm upgrade
    Copy to Clipboard Toggle word wrap
    Important

    Machine launches may fail as the cluster settles into the new state. To notice and recover when machines fail to launch, we recommend deploying machine health checks. For more information about machine health checks and how to deploy them, see About machine health checks.

    The migrations must be complete and all the cluster operators must be stable before you can add compute machine sets with different architectures to your cluster.

Volver arriba
Red Hat logoGithubredditYoutubeTwitter

Aprender

Pruebe, compre y venda

Comunidades

Acerca de la documentación de Red Hat

Ayudamos a los usuarios de Red Hat a innovar y alcanzar sus objetivos con nuestros productos y servicios con contenido en el que pueden confiar. Explore nuestras recientes actualizaciones.

Hacer que el código abierto sea más inclusivo

Red Hat se compromete a reemplazar el lenguaje problemático en nuestro código, documentación y propiedades web. Para más detalles, consulte el Blog de Red Hat.

Acerca de Red Hat

Ofrecemos soluciones reforzadas que facilitan a las empresas trabajar en plataformas y entornos, desde el centro de datos central hasta el perímetro de la red.

Theme

© 2025 Red Hat