Tüm Ürünler
Search
Belge Merkezi

Microservices Engine:Migrate from Consul to MSE Nacos

Son Güncelleme:Oct 06, 2026

Hizmetleri MSE Sync ile eşitleyerek, Consul SDK bağımlılıklarını Nacos SDK ile değiştirerek ve uygulama yapılandırmalarını güncelleyerek kendi yönettiğiniz bir Consul örneğinden MSE Nacos'a hizmet verilerini taşıyın.

Geçiş aşamaları

Aşama Açıklama
1. MSE Sync'i yapılandırın Kaynak Consul ve hedef Nacos örnekleri arasında hizmet verilerini eşitlemek için MSE Sync'i ayarlayın.
2. İstemci bağımlılıklarını değiştirin Uygulama projelerindeki Consul SDK'yı Nacos SDK ile değiştirin.
3. Uygulama yapılandırmalarını güncelleyin Uygulamaları Consul örneği yerine MSE Nacos örneğine yönlendirin.
4. Yeniden paketleyin, dağıtın ve doğrulayın Uygulamaları yeniden derleyin ve hizmetlerin MSE Nacos ile doğru şekilde kaydolduğunu onaylayın.

Ön koşullar

Başlamadan önce:

Adım 1: MSE Sync'i yapılandırın

Kaynak Consul ve hedef Nacos örneklerini belirten bir YAML dosyasıyla MSE Sync'i yapılandırın.

Yapılandırma dosyasını oluşturun

Aşağıdaki içeriğe sahip bir YAML dosyası oluşturun:

clusters:
  - clusterName: dst
    connectKeyList:
      - {nacos.endpoint}:8848
    clusterType: NACOS
  - clusterName: src
    connectKeyList:
      - {consul.endpoint}:8500
    clusterType: CONSUL
tasks:
  - source: src
    destination: dst

Yer tutucu değerleri aşağıdaki gibi değiştirin:

Yer Tutucu Değiştirilecek Değer Örnek
{nacos.endpoint} MSE Nacos örnek uç noktası mse-zzzzz-.nacos-ans.mse.aliyuncs.com
{consul.endpoint} Consul örnek IP adresi 10.0.0.1

Yapılandırma dosyasını içe aktarın

MSE Sync'i başlatın ve yapılandırma dosyasını içe aktarın. MSE Sync daha sonra her iki örneği de periyodik olarak tarar ve yeni hizmetler için otomatik olarak eşitleme görevleri oluşturur.

Not

Varsayılan tarama aralığı 5 saniyedir. Bunu değiştirmek için consul.refresh.interval parametresini ayarlayın.

Eşitlemeyi doğrulayın

MSE Sync'te tüm eşitleme görevlerinin tamamlandığını ve Consul'dan gelen hizmet verilerinin Nacos örneğinde göründüğünü doğrulayın.

Adım 2: İstemci bağımlılıklarını değiştirin

Uygulama projelerindeki Consul SDK'yı Nacos SDK ile değiştirin.

Spring Cloud uygulamaları için Maven bağımlılığını aşağıdaki gibi güncelleyin:

groupId artifactId
Önce (Consul) org.springframework.cloud spring-cloud-starter-consul-discovery
Sonra (Nacos) com.alibaba.cloud spring-cloud-starter-alibaba-nacos-discovery

Consul bağımlılığını kaldırın:

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-consul-discovery</artifactId>
</dependency>

Nacos bağımlılığını ekleyin:

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>

Spring Cloud sürümünüzle uyumlu bir spring-cloud-starter-alibaba-nacos-discovery sürümü seçin.

Adım 3: Uygulama yapılandırmalarını güncelleyin

Uygulama yapılandırma dosyasında Consul bloğunu Nacos hizmet kayıt defteri uç noktasıyla değiştirin.

Örnek yapılandırma (application.yml):

server:
  port: 9999

spring:
  application:
    name: sp-provider
  cloud:
    nacos:
      discovery:
        server-addr: mse-xxxxx-nacos-ans.mse.aliyuncs.com:8848

Referans amaçlı orijinal Consul yapılandırması:

#    consul:
#      host: 11.164.x.x
#      port: 8500
#      config:
#        enabled: false
#      discovery:
#        health-check-path: /health

Adım 4: Uygulamaları yeniden paketleyin ve dağıtın

Güncellenmiş bağımlılıklar ve yapılandırmalarla uygulamaları yeniden derleyip dağıtın.

Adım 5: Geçişi doğrulayın

Dağıtımdan sonra aşağıdaki kontrolleri tamamlayın:

  1. Tüm uygulamaların hatasız başladığını onaylayın.

  2. Hizmet keşfinin çalıştığını teyit etmek için hizmetler arası çağrıları test edin.

  3. MSE konsolunda tüm uygulamaların Nacos örneğine kayıtlı olduğunu doğrulayın.

SSS

Consul'daki hizmet verileri MSE Nacos'a eşitlenmiyor

Hizmetin Consul'da sağlık kontrolünden geçtiğini doğrulayın. MSE Sync yalnızca sağlıklı örnekleri eşitler.

Referanslar

MSE Sync tabanlı geçiş çözümü ek ayrıntıları ve desteklenen örnek türlerini kapsar.