Todos os produtos
Search
Central de documentação

Microservices Engine:Migrar Nacos Dubbo autogerenciado para o MSE Nacos

Última atualização: Aug 21, 2026

O MSE Sync permite migrar dados de um registro Nacos autogerenciado para o MSE Nacos com impacto mínimo nos serviços de produção. Em comparação a um registro autogerenciado, o MSE Nacos oferece maior desempenho e capacidade, mais protocolos de descoberta de services, operações e manutenção simplificadas e dimensionamento flexível.

Pré-requisitos

Limitações

  • Falhas na ferramenta de migração podem interromper a sincronização de dados. Para garantir alta disponibilidade, implante a ferramenta em pelo menos dois nós e conclua a migração o mais rápido possível após o início.

  • Garanta a conectividade de rede entre o Nacos autogerenciado, a ferramenta de migração e o MSE Nacos.

  • Use clientes Nacos 2.x. Se você usar clientes Nacos 1.x, atualize sua instância do MSE Nacos para uma especificação superior.

Procedimento

O diagrama a seguir ilustra a arquitetura de implantação da migração.

image

Etapa 1: Configure a tarefa de sincronização

  1. No painel de navegação à esquerda da ferramenta de migração, clique em Cluster configuration e, em seguida, clique em New Cluster. Na caixa de diálogo New Cluster, adicione as informações do cluster Nacos de source e clique em OK.

    Parameter

    Description

    Cluster Name

    Nome personalizado para o cluster.

    Cluster type

    NACOS.

    Namespace ID

    ID do namespace dos serviços a serem sincronizados.

    Username

    Se a autenticação do Nacos estiver ativada, insira o nome de usuário e a senha correspondentes.

    Password

    AccessKey ID

    Seu AccessKey ID.

    AccessKey secret

    Seu AccessKey secret.

    Connect IP

    Insira o endereço IP e a porta de cada nó do Nacos, um por linha. A porta padrão é 8848.

    Se o cluster de source utilizar SLB para balanceamento de carga, insira o endereço IP e a porta do SLB no campo Connect IP.

  2. Clique em New Cluster novamente e adicione as informações do cluster Nacos de destino.

    Parameter

    Description

    Cluster Name

    Nome personalizado para o cluster.

    Cluster type

    NACOS.

    Namespace ID

    ID do namespace dos serviços a serem sincronizados.

    Username

    Se a autenticação do Nacos estiver ativada, insira o nome de usuário e a senha correspondentes.

    Password

    AccessKey ID

    Seu AccessKey ID.

    AccessKey secret

    Seu AccessKey secret.

    Connect IP

    Endpoint da instância MSE Nacos de destino. Por exemplo, mse-8b7de****-p.zk.mse.aliyuncs.com:8848.

  3. No painel de navegação à esquerda, clique em Sync Task e, em seguida, clique em New Task para adicionar o service Dubbo que deseja migrar.

    • Sync Method: Selecione Bidirectional Synchronization. Dessa forma, qualquer alteração feita no service sincronizado em um dos lados será replicada automaticamente para o outro.

    • Synchronization Type: Escolha Service Information. O MSE Sync lista automaticamente todos os serviços do cluster de source para seleção conforme necessário.

  4. Clique em OK.

    Na página Sync Service da ferramenta de migração, visualize os nomes dos serviços sincronizados.

Etapa 2: Verifique a sincronização

  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. Na página Instances, clique no nome da instância.

  4. No painel de navegação à esquerda, clique em Service Management > Services para verifique se os serviços foram sincronizados.

Etapa 3: Migrar os clientes Dubbo

  1. Modifique o endpoint nos clientes Dubbo.

    No arquivo de configuração XML do seu cliente Dubbo, substitua o endpoint do Nacos autogerenciado no atributo dubbo:registry address pelo endpoint da instância do MSE Nacos.

    Antes:

     <dubbo:registry address="nacos://127.0.0.1:8848"/>

    Depois:

     <dubbo:registry address="nacos://mse-********-p.nacos-ans.mse.aliyuncs.com:8848"/>
  2. Reinicie os clientes. Os clientes Dubbo passarão então a se conectar ao MSE Nacos.

    Nota

    Para garantir a continuidade dos negócios, reinicie seus clientes em lotes. Após reiniciar cada lote, verifique se os clientes se desconectaram do registro autogerenciado e se registraram com sucesso no MSE Nacos.

Etapa 4: Desativar o cluster Nacos autogerenciado

  1. Pare o cluster Nacos autogerenciado.

  2. Pare a ferramenta de migração.