Tüm Ürünler
Search
Belge Merkezi

Microservices Engine:Kendi barındırdığınız Nacos'tan MSE Nacos'a geçiş yapın

Son Güncelleme:Oct 06, 2026

MSE Nacos, kendi barındırdığınız Nacos yapılandırma merkezine kıyasla yapılandırma şifreleme, şifre çözme ve push izleme gibi gelişmiş özellikler sunar. Yüksek performans, kullanılabilirlik ve kullanım kolaylığı sunarak işletme ve bakım maliyetlerinizi önemli ölçüde azaltır. Yapılandırmalarınızı kendi barındırdığınız bir Nacos örneğinden MSE Nacos'a aktarabilir ve ardından uygulamalarınızı bu yeni ortama yönlendirebilirsiniz.

Önkoşullar

  • Bir Nacos motoru oluşturmuş olmanız gerekir.

  • Gerekli ad alanlarını oluşturmuş olmanız gerekir. Daha fazla bilgi için bkz. Ad alanı oluşturma.

    Not

    Kendi barındırdığınız Nacos örneğinizde birden fazla ad alanı varsa, sorunsuz bir geçiş sağlamak amacıyla MSE Nacos üzerinde aynı isimlere ve kimliklere sahip karşılık gelen ad alanları oluşturun.

1. Adım: Yapılandırmaları MSE Nacos'a aktarın

Yöntem 1: İçe ve dışa aktarma kullanın

Not

Yapılandırmaları her ad alanı için ayrı ayrı dışa aktarıp içe aktarın.

  1. Yapılandırmaları kendi barındırdığınız Nacos konsolundan dışa aktarın.

    1. Kendi barındırdığınız Nacos konsolunda oturum açın.

    2. Configurations sayfasında, taşımak istediğiniz yapılandırmaları seçin ve listenin alt kısmındaki Export seçeneğine tıklayın. Export Configuration iletişim kutusunda Export öğesine tıklayın.

    3. Dışa aktarılan yapılandırma dosyasını kaydedin.

  2. Yapılandırmaları MSE konsoluna içe aktarın.

    1. MSE konsolunda oturum açın.

    2. Sol gezinme bölmesinde Microservices Registry > Instances seçeneklerini belirleyin. Örneğin adına tıklayın.

    3. Sol gezinme bölmesinde Configuration Management > Configurations seçeneklerini belirleyin.

    4. Configurations sayfasında hedef ad alanını seçin ve Import Configuration seçeneğine tıklayın.

    5. Import Configuration iletişim kutusunda içe aktarma ilkesini yapılandırın. Aynı ada sahip mevcut yapılandırmalar için Stop Import, Skip veya Overwrite seçeneklerinden birini belirleyebilirsiniz. Kendi barındırdığınız Nacos örneğinden dışa aktardığınız yapılandırma dosyasını yükleyin ve ardından OK seçeneğine tıklayın.

  3. Çift taraflı güncellemeler uygulayın.

    Not

    Sorunsuz bir geçiş sağlamak için, uygulamalarınızı yeni ortama tamamen taşıyana kadar kendi barındırdığınız Nacos örneği ile MSE Nacos arasındaki yapılandırmaların senkronize kalmasını sağlayın. Yapılandırmaları bir SDK kullanarak güncelliyorsanız çift yazma mekanizması uygulayın. Yapılandırmaları konsoldan güncelliyorsanız değişiklikleri her iki konsola da manuel olarak uygulayın.

Yöntem 2: Anlık geçiş için MSE Sync kullanın

Not

MSE Sync'in nasıl dağıtılacağını öğrenmek için bkz. MSE Sync ile geçiş.

  1. MSE Sync dağıtıldıktan sonra MSE konsolunda oturum açın. Sol gezinme bölmesinde Microservices Registry > Migration to Cloud seçeneklerini belirleyin. Buluta Geçiş sayfasında Migration configuration seçeneğine tıklayın.

  2. Migration configuration sayfasında Next seçeneğine tıklayın. Create Configuration adımında Source Instance Type değerini Nacos olarak, Synchronization Type değerini ise Configuration Synchronization olarak ayarlayın. Source Instance Node Address alanına kaynak örneğin IP adresini ve bağlantı noktasını girin ve Destination Instance seçeneğini belirleyin. Next seçeneğine tıklayın. Implement migration sayfasında Download and save the configuration that you want to migrate. seçeneğine tıklayın, ardından dosyayı MSE Sync'e aktararak kaynak kümeden anlık senkronizasyonu etkinleştirin.

    Bir Source Name (3 ila 15 karakter) girin. Namespace List bölümüne, kaynak Nacos örneğinden taşımak istediğiniz ad alanlarını girin. İsterseniz bir de Description (en fazla 64 karakter) ekleyebilirsiniz. Hedef örneğin teknik özelliklerinin değerlendirme raporundaki önerileri karşılamasını veya aşmasını tavsiye ederiz. JVM parametreleri veya Nacos kimlik doğrulaması gibi gelişmiş ayarlar için ilgili belgelere bakın.

Önemli
  • Yapılandırma senkronizasyonu canary yapılandırmalarını desteklemez. MSE Sync, herhangi bir kümenin canary kapsamı içindeyse canary yapılandırmaları diğer kümeye normal yapılandırmalar olarak senkronize edilir.

  • Kaynak ve hedef kümelerde yapılandırmaları eş zamanlı olarak değiştirmeyin.

2. Adım: Uygulama parametrelerini güncelleyin

Uygulamanızın türüne göre parametrelerini aşağıdaki gibi güncelleyin:

Spring Cloud Alibaba uygulamasını geçirin

  1. Uygulamanızın bir Spring Cloud Alibaba uygulaması olup olmadığını kontrol edin.

    pom.xml dosyanız aşağıdaki bağımlılığı içeriyorsa uygulamanız bir Spring Cloud Alibaba uygulamasıdır:

    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    </dependency>
  2. Uygulamanız bir Spring Cloud Alibaba uygulamasıysa bootstrap.properties dosyasını değiştirin.

    ${MSE_ENDPOINT} ifadesini hedef MSE Nacos örneğinizin genel veya dahili uç noktasıyla değiştirin. Uç noktayı örneğin Temel Bilgiler sayfasında bulabilirsiniz.

    spring.cloud.nacos.config.server-addr=${MSE_ENDPOINT}

    Aşağıdaki yapılandırmada ad alanını MSE ad alanı kimliğinizle değiştirin. Kimliği Nacos örneğinin Namespaces sayfasında bulabilirsiniz. Kimlik önceki kurulumunuzla aynıysa değişiklik yapmanız gerekmez. Varsayılan ad alanını kullanıyorsanız bu parametreyi boş bırakın.

Not
  • Uygulamanızı genel bir uç nokta kullanarak dağıtıyorsanız bağlantıyı sağlamak için istemci IP adreslerini izin listesine ekleyin. Daha fazla bilgi için bkz. İzin listesi yapılandırma.

  • İzin listesi boşsa tüm IP adreslerinin uygulamaya erişmesine izin verilir.

Java uygulamasını geçirin

  1. Uygulamanızın Nacos Java SDK'sını kullanıp kullanmadığını kontrol edin.

    pom.xml dosyasında aşağıdaki bağımlılık varsa uygulamanız Nacos Java SDK'sını kullanır.

    <dependency>
      <groupId>com.alibaba.nacos</groupId>
      <artifactId>nacos-client</artifactId>
    </dependency>
  2. Uygulamanız Nacos Java SDK'sını kullanıyorsa aşağıdaki kodda ${MSE_ENDPOINT} ifadesini MSE örneğinin uç noktasıyla değiştirin. ${NAMESPACE_ID} ifadesini MSE örneğinin ad alanı kimliğiyle değiştirin. Varsayılan ad alanını kullanıyorsanız bu parametreyi boş bırakabilirsiniz. Ad alanı kimliği değişmediyse değişiklik yapmanız gerekmez. Ardından uygulamayı yeniden dağıtın.

    properties.put("serverAddr", "${MSE_ENDPOINT}");
    properties.put("namespace", "${NAMESPACE_ID}");

Nacos Spring Boot uygulamasını geçirin

Uygulamanız bir Nacos Spring Boot uygulamasıysa application.properties dosyasını değiştirin.

${MSE_ENDPOINT} ifadesini MSE örneğinin uç noktasıyla değiştirin.

nacos.config.server-addr=${MSE_ENDPOINT}

Aşağıdaki yapılandırmada ad alanını MSE ad alanı kimliğinizle değiştirin:

nacos.config.namespace=${NAMESPACE_ID}

Go uygulamasını geçirin

Not

Herhangi bir API işlemini çağırmadan önce erişim kimlik bilgilerinizi ortam değişkenleri kullanarak ayarlayın. Microservices Engine için AccessKey ID ve AccessKey secret ortam değişkenlerinin adları sırasıyla MSE_AK ve MSE_SK'dir.

Nacos Go SDK'sını kullanıyorsanız ${SERVER_IP} ifadesini MSE örneğinin IP adresiyle değiştirmeniz gerekir.

sc := []constant.ServerConfig{
    {
    IpAddr: "${SERVER_IP}",
    Port:   8848,
    },
}
Not

Resmi bir Go uygulama demosu için bkz. nacos-sdk-go.

Python uygulamasını geçirin

Nacos Python SDK'sını kullanıyorsanız ${SERVER_ADDRESSES} ve ${NAMESPACE_ID} ifadelerini MSE örneğinin uç noktası ve ad alanı kimliğiyle değiştirmeniz gerekir.

SERVER_ADDRESSES = "${SERVER_ADDRESSES}"
NAMESPACE = "${NAMESPACE_ID}"
client = nacos.NacosClient(SERVER_ADDRESSES, namespace=NAMESPACE)

Node.js uygulamasını geçirin

Nacos Node.js SDK'sını kullanıyorsanız ${SERVER_ADDRESS} ve ${NAMESPACE_ID} ifadelerini MSE örneğinin uç noktası ve ad alanı kimliğiyle değiştirmeniz gerekir.

const configClient = new NacosConfigClient({
  serverAddr: '${SERVER_ADDRESS}',
  namespace: '${NAMESPACE_ID}',
  accessKey: 'MSE_AK',
  secretKey: 'MSE_SK',
  requestTimeout: 6000,
});

C# uygulamasını geçirin

${SERVER_ADDRESS} ve ${NAMESPACE_ID} ifadelerini MSE örneğinin uç noktası ve ad alanı kimliğiyle değiştirin.

{
  "NacosConfig": {
    "Listeners": [
      {
        "Optional": false,
        "DataId": "common",
        "Group": "DEFAULT_GROUP"
      },
      {
        "Optional": false,
        "DataId": "demo",
        "Group": "DEFAULT_GROUP"
      }
    ],
    "Namespace": "${NAMESPACE_ID}", 
    "ServerAddresses": [ "http://${SERVER_ADDRESS}:8848/" ],
    "UserName": "test2",
    "Password": "123456",
    "AccessKey": "MSE_AK",
    "SecretKey": "MSE_SK",
    "EndPoint": "acm.aliyun.com",
    "ConfigFilterAssemblies": ["YouPrefix.AssemblyName"],
    "ConfigFilterExtInfo": "some ext information"
  }
}

C++ uygulamasını geçirin

Nacos C++ SDK'sını kullanıyorsanız ${SERVER_ADDRESS} ve ${NAMESPACE_ID} ifadelerini MSE örneğinin uç noktası ve ad alanı kimliğiyle değiştirmeniz gerekir.

Properties props;
props[PropertyKeyConst::SERVER_ADDR] = "${SERVER_ADDRESS}:8848";
props[PropertyKeyConst::NAMESPACE] = "${NAMESPACE_ID}";

3. Adım: Doğrulama yapın ve kendi barındırdığınız örneği devreden çıkarın

Tüm uygulamalar MSE Nacos üzerinde kararlı bir şekilde çalıştıktan sonra iki örnek arasındaki yapılandırma senkronizasyonunu durdurun. Trafik, istemci bağlantısı veya yapılandırma push sorgusu kalmadığından emin olmak için kendi barındırdığınız örneği izleyin ve ardından devreden çıkarın.