Microservices Engine:Upgrade the Nacos engine version

Contexto

Para oferecer serviços melhores e simplificar a seleção de edições do MSE Microservices Registry, o MSE Microservices Registry descontinuará os serviços da edição básica 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 abertura de tickets para instâncias da edição básica permanecerão disponíveis até o prazo limite. Para mais detalhes, consulte o {{XREF_0}}.

Antes de começar

• Selecione uma edição de instância: Antes de atualizar, consulte o {{XREF_1}} para decidir se deseja atualizar para a edição de desenvolvedor ou profissional. Para detalhes de faturamento, consulte {{XREF_2}}.

• Avalie as especificações: Durante a atualização, o MSE Nacos realiza uma gravação dupla nos dados de serviços registrados para garantir a consistência dos dados e a estabilidade da atualização. Antes de começar, certifique-se de que a contagem de instâncias provedoras no seu cluster não exceda a contagem máxima de instâncias para a edição básica das especificações correspondentes, evitando que a gravação dupla afete seus serviços durante a atualização. Para mais informações, consulte {{XREF_3}}.

• Verifique a versão do mecanismo: Você só pode atualizar uma instância da edição básica para a edição profissional ou de desenvolvedor se o seu mecanismo Nacos for da versão 1.2.1.0 ou posterior. Se você estiver usando uma versão 1.1.3.x, precisará primeiro atualizar para a versão 1.2.1 e, em seguida, atualizar a edição da instância. Para obter instruções, consulte {{XREF_4}}.

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

• Mecanismo Eureka: O serviço 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 básica do Eureka para a edição profissional ou de desenvolvedor do MSE Nacos.

Impacto da atualização

• A atualização leva cerca de 10 minutos. Durante esse período, você não pode realizar nenhuma operação na instância pelo console. Recomendamos realizar a atualização em horários de baixa demanda para evitar interrupções nos seus serviços.

• Para 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 serviços, a atualização ocorre sem perdas. No entanto, as reconexões de rede durante a atualização podem gerar alguns logs de erro de reconexão e acesso. Esse é um comportamento esperado. Os dados de monitoramento também podem apresentar breves flutuações devido à reinicialização do cluster.

• Em alguns cenários especiais, não é possível garantir uma atualização sem perdas. Antes de realizar a atualização, verifique as seguintes condições:

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

  • Se você estiver usando um {{XREF_7}}, há uma probabilidade muito baixa de que a perda de pacotes ou outras anomalias desconhecidas durante a atualização acionem um bug no cliente, fazendo com que seus serviços fiquem offline. Nesse caso, a atualização causará tempo de inatividade.

  • Se você estiver usando um {{XREF_8}} e tiver configurado o caminho de verificação de integridade do Spring Cloud Actuator como a sondagem liveness ou readiness para o seu serviço, devido a um bug em versões mais antigas do Spring Cloud Alibaba, há uma probabilidade muito baixa de que a falha na sondagem faça com que sua aplicação seja reiniciada automaticamente. Nesse caso, a atualização causará tempo de inatividade.

• Ao atualizar de um mecanismo Eureka para a edição profissional ou de desenvolvedor do Nacos:

  • Você não precisa modificar o código da sua aplicação.

  • As 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 se conectarem a um nó de servidor íntegro.

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

Caminho de atualização

Você só pode atualizar da edição básica para a edição profissional ou de desenvolvedor se o seu mecanismo Nacos for da versão 1.2.1.0 ou posterior. Se você estiver usando uma versão 1.1.3.x, precisará primeiro atualizar o mecanismo para a versão 1.2.1. Para obter instruções, consulte {{XREF_10}}.

Atualize a versão do mecanismo Nacos

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

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

3. Você pode iniciar 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, encontre a instância de destino 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.

Atualize a edição básica do Nacos/Eureka

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

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

   • Para uma instância de assinatura, selecione Upgrade ou Downgrade de acordo com os requisitos do seu negócio.

   • Para uma instância 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, selecione a edição de desenvolvedor.

   • Para instâncias de vários nós, selecione a edição profissional.

   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. Ela não pode ser atualizada para a Professional Edition.

   • Uma instância da Professional Edition só pode ser atualizada para uma versão posterior da Professional Edition. Ela não pode ser rebaixada 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>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>

<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>