Microservices Engine:Migrasi konfigurasi aplikasi dari pusat konfigurasi Apollo ke pusat konfigurasi MSE Nacos

Deskripsi migrasi

Tabel berikut menjelaskan parameter model Apollo dan model MSE Nacos.

Dalam topik ini, semua konfigurasi dalam satu lingkungan Apollo dimigrasikan sebagai file ke namespace Nacos berdasarkan aturan pemetaan berikut:

• Konfigurasi dalam lingkungan Apollo yang berbeda dapat dipetakan ke instance Nacos yang berbeda atau namespace yang berbeda dari sebuah instance Nacos. Anda dapat menggunakan salah satu metode pemetaan sesuai dengan kebutuhan bisnis Anda.

• Parameter cluster Apollo dipetakan ke parameter group Nacos. Konfigurasi {appId}.{namespace}.{format} Apollo dipetakan ke parameter dataId Nacos.

• Parameter appId Apollo dipetakan ke parameter appName Nacos.

Langkah 1: Ekspor konfigurasi Apollo

select distinct  a.NamespaceId,b.NamespaceName,c.`Comment` AS 'NamespaceDesc' ,b.AppId,b.ClusterName,a.Key,a.Type ,a.Value,a.Comment,a.LineNum from ITEM a left join Namespace b on a.NamespaceId=b.id  left join AppNamespace c on c.Name=b.NamespaceName where a.IsDeleted=0 order by a.NamespaceId,a.LineNum ;

Langkah 2: Ubah format file

Setelah Anda mengekspor konfigurasi Apollo, Anda akan mendapatkan file .zip, .json, atau .xlsx. Anda harus mengubah format file menjadi format yang dapat langsung diimpor ke Nacos di konsol MSE.

1. Jalankan perintah berikut untuk mengunduh alat konversi format file: curl -O https://msesync.oss-cn-hangzhou.aliyuncs.com/ApolloConfigTransfer.jar.

2. Jalankan perintah berikut untuk menjalankan program konversi: java -DsourceFilePath={Jalur lengkap file Apollo yang diekspor} -jar ApolloConfigTransfer.jar.

3. Setelah program dijalankan, file bernama nacos_config_import_{Nama file Apollo yang diekspor}_{Timestamp}.zip tersedia di direktori saat ini.

Langkah 3: Impor file ke Nacos

1. Masuk ke konsol MSE, dan pilih wilayah di bilah navigasi atas.

2. Di panel navigasi sisi kiri, pilih Microservices Registry > Instances. Klik nama instance tersebut.

3. Di panel navigasi sisi kiri, pilih Configuration Management > Configurations.

4. Di halaman yang muncul, pilih namespace dari daftar drop-down Namespace dan klik Import Configuration. Di kotak dialog Impor Konfigurasi, unggah file yang diperoleh di Langkah 2.

   Catatan

   Setelah Anda melakukan operasi sebelumnya, konfigurasi berhasil dimigrasikan dari Apollo ke Nacos.

Langkah 4: Ubah dependensi

Ubah dependensi Apollo menjadi dependensi Spring Cloud Alibaba di proyek aplikasi.

<dependency>
    <groupId>com.ctrip.framework.apollo</groupId>
    <artifactId>apollo-client</artifactId>
    <version>{apollo.version}</version>
</dependency>

<dependency>
    <groupId>com.alibaba.cloud</groupId>
  <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    <version>2.2.10</version>
</dependency>

Langkah 5: Modifikasi kode

Aplikasi mendukung metode konfigurasi dinamis Apollo berikut. Anda dapat memodifikasi kode terkait berdasarkan deskripsi di bagian ini.

@RestController
@RefreshScope
public class DemoController {
    
    @Value("testKey")
    String testKey = "value";

    
    @RequestMapping("/valuekey")
    public String getNacosTestKey() {
        return testKey;
    }
}

@Configuration
@ConfigurationProperties
public class CNStackInfoConfig {
    
    private String name;

    private int customerCount;


    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getCustomerCount() {
        return customerCount;
    }

    public void setCustomerCount(int customerCount) {
        this.customerCount = customerCount;
    }
}

ConfigService.getAppConfig().getProperty("testkey", "defaulyv1");
ConfigService.getAppConfig("namespace").getProperty("testkey", "defaulyv1");

@NacosConfig(dataId="appId1.application.properties",group="group") 
Properties nacosConfigProperties;

private void method() {
    String value=nacosConfigProperties.getProperty("key","defaultValue");
}

    /**
     * notify listener
     * @param configChangeEvent
     */
    @ApolloConfigChangeListener(interestedKeyPrefixes = {"data."})
    public void apolloNotify(ConfigChangeEvent configChangeEvent) {
        System.out.println(configChangeEvent.changedKeys());
    }
    

@NacosConfigKeysListener(dataId="appId1.application.properties",group="group",interestedKeyPrefixes = {"data."})
public void apolloNotify(ConfigChangeEvent configChangeEvent) {
    System.out.println(configChangeEvent.changedKeys()); 
}

Langkah 6: Ubah titik akhir

1. Tambahkan konfigurasi Nacos ke kode proyek.

   ## Konfigurasi Apollo asli 
   # Environment-Dappllo.env={env}
   apollo.meta=http://127.0.0.1:8070
   apollo.bootstrap.enabled=true
   # Tentukan namespace tempat Anda ingin menambahkan konfigurasi.
   apollo.bootstrap.namespaces=application,namespace1
   # Tentukan cluster.
   apollo.bootstrap.cluster=default
   # Tentukan ID aplikasi.
   app.id=app1

   Ubah titik akhir ke titik akhir Nacos.

   # Tentukan dataId dan group dari konfigurasi yang Anda tambahkan.
   spring.config.import[0]=nacos:app1.application.properties?group=default&refreshEnabled=true
   spring.config.import[1]=nacos:app1.namespace1.properties?group=default&refreshEnabled=true
   # Tentukan titik akhir MSE Nacos.
   spring.cloud.nacos.config.server-addr=mse-xxx-p.nacos-ans.mse.aliyuncs.com
   # Tentukan namespace MSE Nacos.
   spring.cloud.nacos.config.namespace={ID Namespace yang sesuai dengan lingkungan tertentu pusat konfigurasi MSE Nacos, seperti 5babe1ee-1352-xxxx-bd7b-7e7ce892e2ab}

2. Mulai ulang layanan.