Todos los productos
Search
Centro de documentos

ApsaraMQ for Kafka:Actualización de la versión de una instancia

Última actualización: Sep 04, 2026

ApsaraMQ for Kafka es compatible con las versiones principales 0.10.x, 2.2.0 y 2.6.2. Actualice a una versión más reciente para obtener mejoras de rendimiento, correcciones de bugs y nuevas funciones, sin perder la compatibilidad con sus SDK y operaciones de API existentes.

Funcionamiento

ApsaraMQ for Kafka admite dos tipos de actualizaciones de versión:

Tipo de actualización

Descripción

Ejemplo

Actualización de versión principal

Actualiza la instancia de una versión principal a otra.

De 0.10.x a 2.x

Actualización de versión secundaria

Aplica correcciones de bugs y optimizaciones de rendimiento dentro de la misma versión principal.

De 2.2.0 a 2.2.0 con kernel optimizado

La versión principal 0.10.x incluye las versiones secundarias 0.10 y 0.10.2.

Proceso de actualización continua

Durante una actualización, los nodos se actualizan uno por uno de forma continua. Cada nodo se verifica antes de comenzar con el siguiente. En condiciones normales, este enfoque mantiene la instancia disponible durante todo el proceso.

A continuación se describe lo que ocurre durante la actualización:

  1. Un solo nodo inicia el proceso de actualización.

  2. El nodo se actualiza y se reinicia.

  3. El sistema comprueba que el nodo actualizado esté en buen estado antes de continuar.

  4. Se actualiza el siguiente nodo y el proceso se repite hasta completar todos los nodos.

Dado que los nodos se actualizan de forma secuencial, el clúster permanece disponible. Los productores y consumidores pueden experimentar desconexiones breves mientras se reinician nodos individuales, pero los clientes de Kafka se reconectan automáticamente y recuperan los metadatos actualizados.

Antes de empezar

Las actualizaciones no tienen costo adicional y son compatibles con los SDK y las operaciones de API existentes.

Asegúrese de que:

  • La instancia de ApsaraMQ for Kafka se encuentre en estado Running

  • Su cliente admita la reconexión automática y pueda manejar desconexiones breves (los clientes de Kafka lo admiten de forma predeterminada)

Recomendaciones

  • Pruebe la actualización en una instancia que no sea de producción antes de actualizar su instancia de producción.

  • Programe las actualizaciones fuera del horario pico para minimizar el impacto de las reconexiones breves.

  • Después de una actualización de versión principal, actualice la versión de su cliente para mantener la coherencia entre las versiones del cliente y del broker. Tras una actualización de versión secundaria, no es necesario actualizar el cliente.

Importante

El formato de almacenamiento de mensajes de la versión 2.x difiere del de la versión 0.10.x. Después de actualizar de 0.10.x a 2.x, no puede revertir a 0.10.x. Proceda con precaución.

Nota

Las instancias de ApsaraMQ for Kafka recién desplegadas ejecutan la versión 2.x. Las instancias 0.10.x existentes continúan funcionando como se espera.

Duración estimada de la actualización

La duración de la actualización depende de la especificación de cómputo de la instancia.

Para instancias que utilizan la especificación alikafka.hr.30xlarge o alikafka.hw.30xlarge, o una especificación inferior:

Tipo de actualización

Duración estimada

Actualización de versión principal

~25 minutos

Actualización de versión secundaria

~15 minutos

Actualización de una instancia

  1. Inicie sesión en la consola de ApsaraMQ for Kafka. En la sección Resource Distribution de la página Overview, seleccione la región donde reside la instancia.

  2. En la página Instances, haga clic en el nombre de la instancia.

  3. En la sección Basic Information de la página Instance Details, inicie la actualización:

    • Para actualizar la versión principal, haga clic en Major Version Upgrade junto a Major Version.

    • Para actualizar la versión secundaria, haga clic en Minor Version Update junto a Minor Version.

  4. En el panel que aparece, complete los siguientes pasos:

    1. Lea el contenido de la sección Read Before Upgrade.

    2. Introduzca su nombre en el campo Emergency Contact.

    3. Introduzca su número de teléfono de emergencia en el campo Emergency Contact Number.

    4. Seleccione la hora de actualización en el campo Started At.

    5. Haga clic en Confirm.

Nota

Después de hacer clic en OK, la instancia se actualiza inmediatamente o a la hora programada dentro de un plazo de siete días.

Comportamiento esperado durante la actualización

Durante la actualización, puede observar el siguiente comportamiento. Estos efectos son temporales y se resuelven al finalizar la actualización.

Comportamiento

Detalles

Mensajes de desconexión del cliente

Pueden aparecer mensajes de error en los registros de la aplicación que indiquen que el cliente se desconectó de un nodo. El cliente se reconecta automáticamente y recupera los metadatos más recientes. No se requiere intervención manual.

Referencias