Todos los productos
Search
Centro de documentos

Container Service for Kubernetes:Manually upgrade a cluster

Última actualización: Sep 29, 2026

Para mitigar los riesgos de seguridad y estabilidad asociados con versiones obsoletas, actualice su clúster a la brevedad. Actualice el plano de control y los node pools para que todo el clúster ejecute la nueva versión.

Importante

Antes de actualizar el clúster, consulte Upgrade a cluster para comprender el proceso de actualización, los métodos disponibles y las consideraciones importantes.

Punto de entrada de la operación

Primero, actualice el plano de control. Después, actualice los node pools. En los clústeres que ejecutan la versión 1.30 o posterior, la versión máxima compatible del plano de control puede ser dos versiones menores superior a la versión más baja de kubelet entre todos los nodos. Por ejemplo, si la versión más baja de kubelet entre todos los nodos es 1.30, el plano de control se puede actualizar como máximo a la versión 1.32.

  1. Inicie sesión en la consola de ACK. En el panel de navegación izquierdo, haga clic en Clusters.

  2. En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Operations > Upgrade Cluster.

  3. En la página Upgrade Cluster, seleccione una Destination Version disponible y siga las instrucciones en pantalla para completar el proceso de actualización.

Actualización del plano de control

1. Comprobación previa

La comprobación previa a la actualización del plano de control busca elementos como API obsoletas. También verifica la compatibilidad de los componentes y el estado general del clúster.

En los clústeres que ejecutan la versión 1.20 o posterior, la comprobación previa busca cualquier deprecated APIs . Los resultados del análisis no afectan el proceso de actualización, ya que son únicamente informativos. Resuelva cualquier problema antes de la actualización para asegurar que la nueva versión del clúster funcione correctamente.

En la pestaña Control Plane Update, haga clic en Precheck para buscar posibles riesgos antes de la actualización. Una vez completado el análisis, consulte los resultados en la sección Pre-check Results. A continuación se muestra un ejemplo:

image

  • Normal: la comprobación de actualización fue exitosa. Continúe con la actualización.

  • Abnormal: el resultado no afecta la operación ni el estado del clúster actual. Resuelva los problemas según las soluciones proporcionadas. Para obtener más información, consulte Cluster check items and solutions.

2. Ejecución de la actualización

Duración: En los clústeres administrados de ACK y los clústeres serverless de ACK, ACK gestiona la actualización y esta toma aproximadamente 5 minutos. En los clústeres dedicados de ACK, los nodos maestros se actualizan uno por uno de forma secuencial. Cada nodo tarda aproximadamente 8 minutos.

Después de resolver los problemas detectados en la comprobación previa, haga clic en Upgrade y siga las instrucciones en pantalla para actualizar el plano de control. Durante este proceso, no despliegue ni modifique aplicaciones de negocio. Tampoco ejecute operaciones de administración y mantenimiento, como escalar el clúster o gestionar node pools. Estas acciones pueden interrumpir la actualización o causar interrupciones en el servicio.

Una vez actualizado el plano de control, los nodos agregados mediante escalado horizontal también ejecutarán la versión del plano de control.

image

3. Validación posterior a la actualización

Una vez actualizado el plano de control, compruebe los siguientes elementos:

对 El plano de control se actualizó correctamente. La versión del clúster se actualiza en la página Clusters.

对 API Server y los componentes principales se encuentran en estado Normal.

对 Las aplicaciones de negocio funcionan correctamente.

对 Los pods se crean con normalidad.

对 Los nodos se agregan con normalidad.

4. (Opcional) Continuación de la actualización del plano de control

Si necesita llevar el plano de control a una versión posterior, repita los pasos del 1 al 3 para ejecutar la comprobación previa, aplicar la actualización y validar el resultado. Repita este ciclo hasta que el plano de control alcance la versión más alta disponible para el clúster.

Actualización de un node pool

Después de actualizar el plano de control, actualice el node pool lo antes posible durante las horas de menor actividad. Esta actualización implica actualizar kubelet y el entorno de ejecución de contenedores en los nodos.

1. Comprobación previa

La comprobación previa a la actualización del node pool analiza el estado de los nodos, los recursos del sistema, el estado de los discos y el entorno de red.

En la página Node Pool Upgrade, localice el node pool de destino en la lista y haga clic en Upgrade en la columna Actions. Luego, en la parte inferior de la página, haga clic en Precheck para buscar posibles riesgos durante el proceso de actualización. Una vez completado el análisis, consulte los resultados en la sección Pre-check Results.

image

  • Normal: la comprobación de actualización fue exitosa. Puede continuar con la actualización.

  • Abnormal: el resultado no afecta la operación ni el estado del clúster actual. Resuelva los problemas según las soluciones proporcionadas. Para obtener más información, consulte Cluster check items and solutions.

2. Configuración de una política de actualización y ejecución del proceso

Duración: La duración depende de cómo se agrupen los nodos. Una actualización in situ toma entre 5 y 10 minutos por lote. Una actualización con reemplazo de disco sin instantáneas toma aproximadamente 8 minutos. El tiempo exacto varía según el tiempo de drenaje de los nodos. Si se crean instantáneas, la actualización comienza después de generarlas. El tiempo necesario para crear las instantáneas depende del volumen de datos.
  • En la pestaña Update a node pool, busque el node pool de destino en la lista y haga clic en Update Now.

  • En el panel Upgrade Policy Configuration, confirme la información de actualización y configure la política tal como se describe en la siguiente tabla. Después, haga clic en Start Update para completar la actualización del node pool según las indicaciones.

Elemento de configuración

Descripción

Información de versión

Las versiones actuales y disponibles de kubelet y del entorno de ejecución de contenedores.

Update Nodes

Actualice All Nodes, o bien seleccione Specific Node para actualizar solo esos nodos.

Update Method

  • In-place Upgrade: los componentes necesarios se actualizan y reemplazan directamente en el nodo original. El disco del sistema no se reemplaza y el nodo no se reinicializa. Los datos del nodo original no se ven afectados.

  • Upgrade by Replacing System Disk: el nodo se reinicializa al reemplazar su disco del sistema. Las propiedades de la instancia del nodo, como el nombre del nodo, el ID de instancia y la dirección IP, permanecen sin cambios. Sin embargo, los datos del disco del sistema se eliminan. Los datos de los discos de datos conectados por separado al nodo no se ven afectados.

    Para obtener más información sobre la lógica y el proceso de actualización, consulte Reference: In-place upgrade and disk replacement upgrade.

Ignore Warnings

Especifica si se debe continuar con la actualización del node pool cuando la comprobación previa automática devuelve elementos de advertencia.

Batch Update Policy

  • Maximum Number of Nodes per Batch: ACK actualiza solo un node pool a la vez. Los nodos dentro del node pool se actualizan en lotes según esta configuración. Si pausa y luego reanuda la actualización, se sigue aplicando la política de lotes. La cantidad de nodos por lote aumenta progresivamente (1, 2, 4, 8, etc.) hasta alcanzar el número máximo de nodos simultáneos. A partir de ese momento, cada lote contiene el número máximo de nodos simultáneos.

    Por ejemplo, si el número máximo de nodos simultáneos es 4, la cantidad de nodos en cada lote será 1, 2, 4, 4, 4, y así sucesivamente. Para obtener más información, consulte Reference: In-place upgrade and disk replacement upgrade.
  • Automatic Pause Policy: la política para pausar el proceso de actualización de nodos. Si selecciona Automatic, también puede configurar el parámetro Interval Between Batches. Este valor define la duración del intervalo, si existe, entre los lotes de actualización (de 5 a 120 minutos).

  • Interval Between Batches: el intervalo entre dos lotes de actualización. Si selecciona Do not set, el siguiente lote comienza inmediatamente después de actualizar el lote actual.

  • Auto Snapshot: si los discos del sistema de sus nodos contienen datos de negocio importantes, puede elegir si desea crear snapshots para los nodos antes de actualizar el node pool. Esto le permite respaldar y restaurar los datos de los nodos.

    Importante
    • Se recomienda usar instantáneas automáticas para las actualizaciones con reemplazo de disco.

    • El uso de instantáneas genera snapshot fees. El time required to create a snapshot varía. De forma predeterminada, las instantáneas se conservan durante 7 días. Después de la actualización, si ya no necesita las instantáneas, delete them a la brevedad.

3. Validación posterior a la actualización

Una vez actualizado el node pool, compruebe los siguientes elementos:

对 Los nodos se actualizaron correctamente. Las versiones de kubelet y containerd se actualizan en la página de detalles del nodo.

对 La programación de pods funciona con normalidad.

对 Las aplicaciones de negocio funcionan correctamente.

Referencias

  • Para obtener respuestas a preguntas frecuentes antes y durante la actualización de un clúster, consulte FAQ.

  • Para obtener información sobre la política de compatibilidad de versiones de Kubernetes en ACK, consulte Version Guide.

  • A partir de la versión 1.24, Docker ya no se admite como entorno de ejecución de contenedores integrado. Si actualiza a la versión 1.24 o posterior, debe migrate the container runtime of nodes from Docker to containerd.

  • A partir de la versión 1.30, CentOS y Alibaba Cloud Linux 2 ya no son compatibles. Utilice otras operating systems admitidas.

  • Como alternativa, habilite las actualizaciones automáticas del clúster para reducir la carga operativa asociada con la gestión de versiones. Para obtener más información, consulte Automatically upgrade a cluster.

  • Antes de la actualización, agregue los nodos huérfanos del clúster a los node pools para gestionar todos los nodos de manera unificada, tal como se describe en Migrate unmanaged nodes to a node pool.