Todos os produtos
Search
Central de documentação

ApsaraMQ for Kafka:Upgrade the version of an instance

Última atualização: Jun 27, 2026

O ApsaraMQ for Kafka é compatível com as versões principais 0.10.x, 2.2.0 e 2.6.2. Atualize para uma versão mais recente para obter melhorias de desempenho, correções de bugs e novos recursos, mantendo a compatibilidade com seus SDKs e operações de API existentes.

Como funciona

O ApsaraMQ for Kafka oferece dois tipos de atualização de versão:

Tipo de atualização

Descrição

Exemplo

Atualização de versão principal

Atualiza a instância de uma versão principal para outra.

De 0.10.x para 2.x

Atualização de versão secundária

Aplica correções de bugs e otimizações de desempenho na mesma versão principal.

De 2.2.0 para 2.2.0 com kernel otimizado

A versão principal 0.10.x inclui as versões secundárias 0.10 e 0.10.2.

Processo de atualização contínua

Durante a atualização, os nós são atualizados um por vez, de forma contínua. O sistema verifica cada nó antes de iniciar o próximo. Em condições normais, essa abordagem mantém a instância disponível durante todo o procedimento.

A sequência a seguir descreve o que ocorre durante a atualização:

  1. Um único nó inicia o processo de atualização.

  2. O nó é atualizado e reiniciado.

  3. O sistema verifica a integridade do nó atualizado antes de prosseguir.

  4. O próximo nó é atualizado e o processo se repete até a conclusão de todos os nós.

Como os nós são atualizados sequencialmente, o cluster permanece disponível. Produtores e consumidores podem sofrer breves desconexões conforme os nós individuais são reiniciados, mas os clientes Kafka se reconectam automaticamente e recuperam os metadados atualizados.

Antes de começar

As atualizações são gratuitas e compatíveis com os SDKs e operações de API existentes.

Certifique-se de que:

  • A instância do ApsaraMQ for Kafka esteja no estado Running.

  • Seu cliente seja compatível com reconexão automática e consiga lidar com breves desconexões (os clientes Kafka têm esse suporte por padrão).

Recomendações

  • Teste a atualização em uma instância fora de produção antes de atualizar sua instância de produção.

  • Agende as atualizações para horários de baixa demanda para minimizar o impacto das breves reconexões.

  • Após uma atualização de versão principal, atualize também a versão do seu cliente para manter a consistência entre as versões do cliente e do broker. Após uma atualização de versão secundária, não é necessário atualizar o cliente.

Importante

O formato de armazenamento de mensagens da versão 2.x difere da versão 0.10.x. Após atualizar de 0.10.x para 2.x, não é possível reverter para 0.10.x. Prossiga com cautela.

Nota

Instâncias do ApsaraMQ for Kafka recém-implantadas executam a versão 2.x. As instâncias 0.10.x existentes continuam funcionando normalmente.

Duração estimada da atualização

A duração da atualização depende da especificação de computação da instância.

Para instâncias que utilizam a especificação alikafka.hr.30xlarge ou alikafka.hw.30xlarge, ou uma especificação inferior:

Tipo de atualização

Duração estimada

Atualização de versão principal

~25 minutos

Atualização de versão secundária

~15 minutos

Atualizar uma instância

  1. Faça login no console do ApsaraMQ for Kafka. Na seção Resource Distribution da página Overview, selecione a região onde a instância está localizada.

  2. Na página Instances, clique em nome da instância.

  3. Na seção Basic Information da página Instance Details, inicie a atualização:

    • Para atualizar a versão principal, clique em Major Version Upgrade ao lado de Major Version.

    • Para atualizar a versão secundária, clique em Minor Version Update ao lado de Minor Version.

  4. No painel exibido, conclua as etapas a seguir:

    1. Leia o conteúdo na seção Read Before Upgrade.

    2. Insira seu nome no campo Emergency Contact.

    3. Insira seu telefone de emergência no campo Emergency Contact Number.

    4. Selecione o horário da atualização no campo Started At.

    5. Clique em Confirm.

Nota

Após clicar em OK, a instância será atualizada imediatamente ou no horário agendado dentro de sete dias.

O que esperar durante a atualização

Durante a atualização, você pode observar os comportamentos descritos abaixo. Esses efeitos são temporários e se resolvem à medida que a atualização é concluída.

Comportamento

Detalhes

Mensagens de desconexão do cliente

Mensagens de erro indicando que o cliente foi desconectado de um nó podem aparecer nos logs da aplicação. O cliente se reconecta automaticamente e recupera os metadados mais recentes. Nenhuma intervenção manual é necessária.

Referências