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 パラメーターにマッピングされます。

手順 1：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 ;

手順 2：ファイル形式を変換する

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 という名前のファイルが現在のディレクトリで使用可能になります。

手順 3：Nacos にファイルをインポートする

1. MSE コンソール にログインし、上部のナビゲーションバーでリージョンを選択します。

2. 左側のナビゲーションペインで、マイクロサービスの登録 > インスタンス を選択します。

3. 左側のナビゲーションペインで、[構成管理] > [構成] を選択します。

4. 表示されるページで、[名前空間] ドロップダウンリストから名前空間を選択し、[構成のインポート] をクリックします。 [構成のインポート] ダイアログボックスで、手順 2 で取得したファイルをアップロードします。

   説明

   上記の手順を実行すると、構成が Apollo から Nacos に移行されます。

手順 4：依存関係を変更する

アプリケーションプロジェクトで、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>

手順 5：コードを変更する

アプリケーションは、次の 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");
}

    /**
     * リスナーに通知する
     * @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()); 
}

手順 6：エンドポイントを変更する

1. Nacos 構成をプロジェクトコードに追加します。

   ## 元の Apollo 構成
   # Environment-Dappllo.env={env}
   apollo.meta=http://127.0.0.1:8070
   apollo.bootstrap.enabled=true
   # 構成を追加する名前空間を指定します。
   apollo.bootstrap.namespaces=application,namespace1
   # クラスターを指定します。
   apollo.bootstrap.cluster=default
   # アプリケーションの ID を指定します。
   app.id=app1

   エンドポイントを Nacos エンドポイントに変更します。

   # 追加した構成の dataId とグループを指定します。
   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 構成センターの指定された環境に対応する名前空間 ID（例：5babe1ee-1352-xxxx-bd7b-7e7ce892e2ab）}

2. サービスを再起動します。