Actualización de un clúster de Red Hat OpenShift en Azure

Como parte del ciclo de vida del clúster de Red Hat OpenShift de Microsoft Azure, debe realizar actualizaciones periódicas a la versión más reciente de la plataforma OpenShift. La actualización de los clústeres de Red Hat OpenShift de Azure le permite actualizar a las características y funcionalidades más recientes y aplicar las versiones de seguridad más recientes.

En este artículo se muestra cómo actualizar todos los componentes de un clúster de OpenShift mediante la consola web de OpenShift, la CLI o el operador managed-upgrade-operator (MUO). Para obtener más información sobre las actualizaciones de OpenShift, consulte Descripción de las actualizaciones de OpenShift.

Importante

No se admite la realización de una actualización de plano de control solo para Red Hat OpenShift en Azure y puede provocar inestabilidad en el clúster.

Note

Para obtener más información sobre la actualización de 4.20 a 4.21, consulte Actualización de 4.20 a 4.21.

Prerrequisitos

Comprobación de las actualizaciones de clúster disponibles mediante la consola web

  1. En el menú izquierdo de la consola web de OpenShift, asegúrese de que está en la perspectiva administrador , que es el valor predeterminado al firmar como kubeadmin.

  2. Seleccione la pestaña Administración.

  3. Seleccione Configuración del clúster y abra la pestaña Detalles . Se muestran la versión, el estado de actualización y el canal. El canal no está configurado de forma predeterminada.

  4. Seleccione el vínculo Canal y, en el indicador, ingrese el canal de actualización deseado, por ejemplo stable-4.19. Una vez que elija el canal deseado, aparece un gráfico en el que se muestran las versiones y los canales disponibles. Si el valor de Update Status (Estado de actualización) del clúster muestra Updates Available (Actualizaciones disponibles), puede actualizar el clúster.

Actualización del clúster con la consola web de OpenShift

En la consola web de OpenShift en el paso anterior, establezca el canal para la versión a la que desea actualizar, como stable-4.19.

Elija una versión para actualizar y luego seleccione Update (actualizar). Verá que el estado de actualización cambia a: Update to <product-version> in progress. Para revisar el progreso de la actualización del clúster, observe las barras de progreso de los operadores y nodos.

Programar actualizaciones individuales mediante el operador de actualización gestionada

Usa el operador de actualización gestionada (MUO) para actualizar el clúster de Red Hat OpenShift de Azure.

El operador managed-upgrade-operator administra las actualizaciones automatizadas del clúster. El operador "managed-upgrade-operator" inicia la actualización del clúster, pero no lleva a cabo ninguna actividad del proceso de actualización en sí. OpenShift Container Platform (OCP) es responsable de actualizar los clústeres. El objetivo del "managed-upgrade-operator" es satisfacer las condiciones de funcionamiento que debe mantener un clúster administrado, tanto antes como después de que se inicie la actualización del clúster.

  1. Prepare el archivo de configuración, como se muestra en el ejemplo siguiente para actualizar a OpenShift 4.19.
apiVersion: upgrade.managed.openshift.io/v1alpha1
kind: UpgradeConfig
metadata:
  name: managed-upgrade-config
  namespace: openshift-managed-upgrade-operator
spec:
  type: "ARO"
  upgradeAt: "2025-09-08T03:20:00Z"
  PDBForceDrainTimeout: 60
  desired:
    channel: "stable-4.19"
    version: "4.19.15"
  • upgradeAT es la hora en que se produce la actualización.
  • channel es el canal del que extrae el archivo de configuración, según la directiva de ciclo de vida. El canal usado debe ser stable-<version> o eus-<version>.
  • version es la versión a la que desea actualizar, como 4.19.15.
  1. Aplique el archivo de configuración. Reemplace por <file_name> el nombre del archivo.
oc create -f <file_name>.yaml

Actualización del clúster mediante la CLI

Para más información, consulte Actualización de un clúster mediante la CLI.

Actualizaciones del complemento de soporte extendido para actualizaciones (EUS) período 1

Al actualizar el clúster desde una versión de EUS a otra versión de EUS (por ejemplo: 4.16 a 4.18), debe actualizar a la versión provisional y, a continuación, a la versión de EUS de destino. Por ejemplo, para actualizar de 4.16 a 4.18, debe actualizar a 4.17 y, a continuación, a 4.18. No se admiten las actualizaciones de tipo «Control Plane Only». También debe seleccionar el canal de actualización pertinente para la versión de destino, por ejemplo eus-4.18.

Actualizar de 4.20 a 4.21

La openshift directiva de imágenes de clúster pasó a estar disponible de forma general en la versión 4.21. Como resultado, ahora se requieren las firmas de Sigstore para las imágenes quay.io/openshift-release-dev/ocp-release para la verificación del lanzamiento. Si intenta actualizar a la versión 4.21, un "Este clúster tiene reflejos configurados. 4.21 requerirá firmas de Sigstore…" el mensaje bloquea la actualización. Para los clústeres de Red Hat OpenShift en Azure, no es necesario realizar ninguna acción adicional porque el servicio ya proporciona las imágenes de firma de Sigstore necesarias.

Para continuar con la actualización, proporcione la confirmación del administrador. Ejecute el siguiente comando antes de continuar:

oc -n openshift-config patch configmap admin-acks --patch '{"data":{"ack-4.20-sigstore-in-4.21":"true"}}' --type=merge

Pasos siguientes

  • Puede encontrar información sobre los avisos y actualizaciones disponibles de OpenShift Container Platform en la sección errata del Portal de clientes de Red Hat.