Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este artículo se muestra cómo actualizar un clúster de Red Hat OpenShift de Azure con identidades administradas habilitadas mediante la consola web de OpenShift o el operador managed-upgrade-operator (MUO).
Importante
Actualmente, esta característica red Hat OpenShift de Azure solo se ofrece en versión preliminar. Las características en versión preliminar están disponibles como opción de participación y autoservicio. Las versiones preliminares se proporcionan "tal cual" y "como están disponibles" y se excluyen de los contratos de nivel de servicio y la garantía limitada. Las versiones preliminares de Red Hat OpenShift en Azure reciben cobertura parcial del soporte al cliente en la medida de lo posible. Las características no están pensadas para su uso en producción.
Como parte del ciclo de vida del clúster de Red Hat OpenShift en 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 obtener las características y funcionalidades más recientes y aplicar las versiones de seguridad más recientes.
Prerrequisitos
Antes de comenzar, compruebe que cumple los siguientes requisitos necesarios para actualizar correctamente un clúster de ARO.
- Está ejecutando la CLI de Azure versión 2.67.0 o posterior. Ejecute
az --version
para buscar la versión actual. Si necesita instalar o actualizar la CLI de Azure, consulte Instalación de la CLI de Azure. - Tiene acceso a un clúster de Red Hat OpenShift de Azure existente como usuario con privilegios de administrador.
- Ha actualizado su secreto de extracción de Azure Red Hat OpenShift para un clúster existente de Azure Red Hat OpenShift 4.x, al incluir la entrada cloud.openshift.com de su secreto de extracción, su clúster puede empezar a enviar datos de telemetría a Red Hat.
Para más información, vea Adición o actualización del secreto de extracción de Red Hat en un clúster de la versión 4 de Red Hat OpenShift en Azure. - Compruebe que las credenciales de identidad federada usadas por las identidades administradas del clúster son válidas o actualizadas antes de iniciar la actualización. Para más información, consulte Conciliación de credenciales de identidad federada para el clúster de Red Hat OpenShift de Azure con identidades administradas habilitadas (versión preliminar).
Descargue el archivo de rueda de extensión Red Hat OpenShift de Azure (solo versión preliminar)
Para ejecutar los comandos de este artículo, debe descargar el archivo wheel de extensión de ARO desde https://aka.ms/az-aroext-latest. Para instalar la extensión , ejecute el siguiente comando:
az extension add -s <path to downloaded whl file>
Establezca la anotación actualizable en el recurso CloudCredential del clúster Azure Red Hat OpenShift.
Para poder mejorar un clúster de Red Hat OpenShift de Azure con identidad administrada habilitada, establezca la upgradeable-to
anotación en el recurso del clúster CloudCredential
usando el comando az aro update
.
az aro update --name <CLUSTER_NAME> --resource-group <RESOURCE_GROUP> --upgradeable-to <VERSION>
Donde:
-
--name
es el nombre del clúster. -
--resource-group
es el nombre del grupo de recursos de red. Puede configurar el grupo predeterminado medianteaz-config --defaults group=<name>
. -
--upgradeable-to
es el número de versión de OpenShift al que quiere actualizar, especificado en el formato x.y.z.
Para obtener más información sobre la anotación "actualizable a", consulte Preparación para actualizar un clúster.
Nota:
El comando mostrado az aro update
anteriormente no desencadena la actualización de la versión de OpenShift. Para completar la actualización de la versión de OpenShift, complete los pasos restantes de este artículo.
Comprobación de las actualizaciones del clúster de Red Hat OpenShift en Azure mediante la consola web
- En el menú de navegación izquierdo de la consola web de OpenShift (el valor predeterminado al iniciar sesión como kubeadmin), seleccione la pestaña Administración .
- Seleccione Configuración del clúster y abra la pestaña Detalles . Debería ver la versión, el estado de actualización y el canal. El canal no está configurado de forma predeterminada.
- Seleccione el enlace Canal y, en el campo de entrada, escriba el canal de actualización deseado, por ejemplo stable-4.16. Una vez elegido el canal deseado, se muestra un gráfico que muestra las versiones y 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 de Red Hat OpenShift en Azure con la consola web de OpenShift
En la consola web de OpenShift en el paso anterior, establezca el canal según la versión a la que desea actualizar, como stable-4.16
. Para obtener más información, consulte Actualizar canales.
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 "managed-upgrade-operator"
Use el operador managed-upgrade-operator (MUO) para actualizar el clúster de Red Hat OpenShift en Azure.
El MUO administra las actualizaciones automatizadas del clúster. La MUO inicia la actualización del clúster, pero no realiza ninguna actividad del propio proceso de actualización del clúster. OpenShift Container Platform (OCP) es responsable de actualizar los clústeres. El objetivo del MUO es satisfacer las condiciones de funcionamiento que debe contener un clúster administrado, tanto antes como después de iniciar la actualización del clúster.
Prepare el archivo de configuración, como se muestra en el ejemplo siguiente para actualizar a OpenShift 4.16.
apiVersion: upgrade.managed.openshift.io/v1alpha1 kind: UpgradeConfig metadata: name: managed-upgrade-config namespace: openshift-managed-upgrade-operator spec: type: "ARO" upgradeAt: "2025-04-08T03:20:00Z" PDBForceDrainTimeout: 60 desired: channel: "stable-4.16" version: "4.16.37"
Donde:
-
channel
es el canal del que extrae el archivo de configuración, según la directiva de ciclo de vida. -
version
es la versión a la que quiere actualizar, como4.16.37
. -
upgradeAT
es la hora en que se realiza la actualización.
-
Aplique el archivo de configuración:
$ oc create -f <file_name>.yaml
Pasos siguientes
- Aprenda a actualizar un clúster de Red Hat OpenShift en Azure mediante la CLI de OC.
- Puede encontrar información sobre los avisos y actualizaciones disponibles de OpenShift Container Platform en la sección de erratas del portal del cliente.