Microservices Engine：從Apollo遷移到MSE Nacos

遷移說明

Apollo的模型和MSE Nacos的模型如下：

本遷移文檔將單個Apollo環境中的所有配置以檔案的方式匯入到Nacos中的一個命名空間，將以如下規則進行映射：

• 不同的Apollo環境可以映射為不同的Nacos執行個體，也可以映射到同一個Nacos執行個體下的不同命名空間之中，可自行選擇。

• Apollo的cluster對應Nacos中的group，Apollo中的{appId}.{namespace}.{format}對應Nacos中的dataId。

• Apollo中的appId將映射為Nacos配置中的應用appName。

步驟一：匯出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 ;

步驟二：檔案轉換

對Apollo配置進行了匯出，可以獲得一個設定匯出檔案（檔案以.zip,.json,.xlsx結尾），需要將檔案轉換為可以直接在MSE Nacos控制台中進行匯入的檔案格式。

1. 下載轉換工具：curl -O https://msesync.oss-cn-hangzhou.aliyuncs.com/ApolloConfigTransfer.jar。

2. 執行轉換程式：java -DsourceFilePath={apollo匯出檔案的完整路徑} -jar ApolloConfigTransfer.jar。

3. 程式執行成功後，可以在目前的目錄下獲得一個名為nacos_config_import_{apollo檔案名稱}_{時間戳記}.zip的檔案。

步驟三：匯入Nacos配置

1. 登入MSE管理主控台，並在頂部功能表列選擇地區。

2. 在左側導覽列，選擇注册配置中心 > 实例列表。單擊目標執行個體名稱。

3. 在基礎資訊頁面的左側導覽列選擇組態管理 > 配置列表。

4. 在配置列表頁面，選擇對應的命名空間，單擊匯入配置，在匯入配置頁面上傳步驟二的設定檔。

   說明

   至此，我們已經完成配置從Apllo到Nacos的遷移。

步驟四：更改依賴

在應用專案中將Apollo的依賴更改為Spring Cloud Alibaba的依賴。

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

步驟五：改造代碼

應用程式使用Apollo動態配置有以下幾種用法。

@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()); 
}

步驟六：修改串連地址

1. 引入Nacos配置

   ##原有apollo的配置 
   #環境-Dappllo.env={env}
   apollo.meta=http://127.0.0.1:8070
   apollo.bootstrap.enabled=true
   #指定引入的命名空間
   apollo.bootstrap.namespaces=application,namespace1
   #指定叢集
   apollo.bootstrap.cluster=default
   #指定應用的
   app.id=app1

   修改為Nacos的地址

   #指定載入的配置dataId及group
   spring.config.import[0]=nacos:app1.application.properties?group=default&refreshEnabled=true
   spring.config.import[1]=nacos:app1.namespace1.properties?group=default&refreshEnabled=true
   #指定MSE Nacos的地址
   spring.cloud.nacos.config.server-addr=mse-xxx-p.nacos-ans.mse.aliyuncs.com
   #指定MSE Nacos的命名空間
   spring.cloud.nacos.config.namespace={mse nacos中指定環境對應namespaceid，比如5babe1ee-1352-xxxx-bd7b-7e7ce892e2ab}

2. 重啟服務。