Microservices Engine:Upgrade the Nacos engine version

Contexto

Para oferecer serviços melhores e simplificar a escolha da edição do MSE Microservices Registry, o serviço descontinuará a edição Basic e liberará os recursos das instâncias às 12:00 (UTC+8) de 3 de março de 2025. Após esse horário, você não poderá mais acessar essas instâncias pelo console ou por suas aplicações. Os serviços de suporte e tickets para instâncias da edição Basic permanecerão disponíveis até o prazo limite. Para mais detalhes, consulte {{XREF_0}}.

Antes de começar

• Selecione uma edição de instância: Antes de atualizar, consulte {{XREF_1}} para decidir se deve migrar para a edição Developer ou Professional. Para detalhes de faturamento, veja {{XREF_2}}.

• Avalie as especificações: Durante a atualização, o MSE Nacos executa uma gravação dupla nos dados de service registrados para garantir consistência e estabilidade. Antes de iniciar, verifique se a contagem de instâncias provedoras no seu cluster não excede o limite máximo da edição Basic correspondente às especificações escolhidas, evitando que a gravação dupla impacte seus services durante o processo. Para mais informações, consulte {{XREF_3}}.

• Verifique a versão do mecanismo: A migração de uma instância da edição Basic para a Professional ou Developer só é possível se o mecanismo Nacos estiver na versão 1.2.1.0 ou superior. Caso utilize uma versão 1.1.3.x, atualize primeiro para a versão 1.2.1 e depois altere a edição da instância. Para instruções, consulte {{XREF_4}}.

• Revise a compatibilidade de versões do mecanismo: Para detalhes sobre os recursos das versões do mecanismo MSE Nacos, consulte {{XREF_5}}. Para manter a estabilidade do sistema, recomendamos evitar versões restritas do Nacos SDK. Para entender os motivos e as soluções, veja {{XREF_6}}.

• Mecanismo Eureka: O service Eureka gerenciado pelo MSE foi descontinuado. O MSE Nacos suporta o protocolo Eureka e é compatível com clientes Eureka. Recomendamos migrar suas instâncias da edição Basic do Eureka para a edição Professional ou Developer do MSE Nacos.

Impacto da atualização

• A atualização leva cerca de 10 minutos. Durante esse período, não é possível executar operações na instância pelo console. Recomendamos realizar a atualização em horários de baixa demanda para evitar interrupções nos seus services.

• Em instâncias com três ou mais nós, a atualização usa implantação contínua entre os nós com sincronização automática de dados, garantindo uma atualização sem tempo de inatividade.

• Para a maioria dos services, a atualização ocorre sem perdas. No entanto, reconexões de rede durante o processo podem gerar alguns logs de erro de reconexão e acesso. Esse comportamento é esperado. Os dados de monitoramento também podem apresentar breves flutuações devido à reinicialização do cluster.

• Em alguns cenários específicos, não há garantia de atualização sem perdas. Antes de prosseguir, verifique as seguintes condições:

  • Instâncias com um ou dois nós não possuem alta disponibilidade (HA), portanto a atualização causará tempo de inatividade.

  • Se você utiliza um {{XREF_7}}, existe uma probabilidade muito baixa de perda de pacotes ou outras anomalias desconhecidas durante a atualização acionarem um bug no cliente, tirando seus services do ar. Nesse caso, a atualização causará tempo de inatividade.

  • Caso utilize um {{XREF_8}} e tenha configurado o caminho de verificação de integridade do Spring Cloud Actuator como sonda de liveness ou readiness do seu service, devido a um bug em versões antigas do Spring Cloud Alibaba, há uma probabilidade muito baixa de falha na sonda causar reinicialização automática da aplicação. Nesse cenário, a atualização resultará em tempo de inatividade.

• Ao migrar de um mecanismo Eureka para a edição Professional ou Developer do Nacos:

  • Não é necessário modificar o código da sua aplicação.

  • Reconexões de rede durante a atualização podem fazer com que a renovação de heartbeat falhe para um pequeno número de instâncias registradas. Os clientes Eureka tentam registrar novamente de forma automática na próxima renovação e se recuperam após conectar-se a um nó de servidor saudável.

  • Por padrão, uma instância da edição Basic do Eureka é migrada para a edição Developer ou Professional do Nacos com a versão de mecanismo 2.1.2.2. Posteriormente, você pode atualizar para a versão mais recente do Nacos. Para mais informações, consulte {{XREF_9}}.

Caminho de atualização

A migração da edição Basic para a Professional ou Developer só é possível se o mecanismo Nacos estiver na versão 1.2.1.0 ou superior. Caso utilize uma versão 1.1.3.x, atualize primeiro o mecanismo para a versão 1.2.1. Para instruções, consulte {{XREF_10}}.

Atualizar a versão do mecanismo Nacos

1. Faça login no MSE console e selecione uma região na barra de navegação superior.

2. No painel de navegação à esquerda, escolha Microservices Registry > Instances.

3. Inicie a atualização pelo console de duas maneiras:

   Nota

   Se a instância de destino já estiver na versão mais recente, a opção Manual Upgrade não será exibida.

   Método 1

   Na página Instances, localize a instância desejada e clique em Manual Upgrade na coluna Engine Version.

   Método 2

   Na página Instances, clique na instância que deseja atualizar. Na página Basic Information, clique em Manual Upgrade ao lado de Engine Version.

4. Na caixa de diálogo Cluster Upgrade, clique em OK.

Atualizar a edição Basic do Nacos/Eureka

1. Faça login no MSE console e selecione uma região na barra de navegação superior.

2. Na página Instances, localize a instância do MSE e clique em More na coluna Actions.

   • Para instâncias por assinatura, selecione Upgrade ou Downgrade conforme suas necessidades de negócio.

   • Para instâncias de pagamento conforme o uso, selecione Upgrade/Downgrade.

3. Na página de alteração de especificações, selecione uma Product Edition:

   • Para instâncias de nó único, escolha a edição Developer.

   • Para instâncias com múltiplos nós, escolha a edição Professional.

   Importante

   As seguintes limitações se aplicam ao alterar a Product Edition:

   • Uma instância da Basic Edition pode ser atualizada para a Developer Edition ou Professional Edition.

   • Uma instância da Developer Edition só pode ser atualizada para uma versão posterior da Developer Edition. Não é possível migrar para a Professional Edition.

   • Uma instância da Professional Edition só pode ser atualizada para uma versão posterior da Professional Edition. Não é possível fazer downgrade para a Developer Edition.

4. Confirme a Engine specification e o Number of Cluster Nodes. Após verificar o custo total no canto inferior direito, clique em Buy now.

Perguntas frequentes

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    <version>${springcloudalibaba.version}</version>
    <exclusions>
        <exclusion>
        <groupId>com.alibaba.nacos</groupId>
        <artifactId>nacos-client</artifactId>
         </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    <version>${springcloudalibaba.version}</version>
    <exclusions>
        <exclusion>
            <groupId>com.alibaba.nacos</groupId>
            <artifactId>nacos-client</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>com.alibaba.nacos</groupId>
    <artifactId>nacos-client</artifactId>
    <version>2.0.2</version>
</dependency>

<dependency>
    <groupId>org.apache.dubbo</groupId>
    <artifactId>dubbo-registry-nacos</artifactId>
    <version>${dubbo.version}</version>
    <exclusions>
        <exclusion>
            <groupId>com.alibaba.nacos</groupId>
            <artifactId>nacos-client</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>com.alibaba.nacos</groupId>
    <artifactId>nacos-client</artifactId>
    <version>2.0.2</version>
</dependency>