Microservices Engine:ACM から MSE Nacos への移行

Spring Cloud Alibaba アプリケーションの移行

アプリケーションが Spring Cloud Alibaba アプリケーションの場合は、bootstrap.properties 設定ファイルを変更します。

次の内容を、

spring.cloud.nacos.config.endpoint=${ACM_PUBLIC/INTERNAL_ENDPOINT}

次のように置き換えます。

spring.cloud.nacos.config.server-addr=${MSE_NACOS_PUBLIC/INTERNAL_ENDPOINT}

また、namespace を MSE Nacos の namespace に更新してください。

spring.cloud.nacos.config.namespace=${MSE_NACOS_NAMESPACE_ID}

実行可能なデモについては、「acm2nacos-spring-cloud-example」をご参照ください。

アプリケーションが Spring Cloud Alibaba アプリケーションであるかを確認するには、

pom.xml ファイルで、次の依存関係を確認してください。

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

• MSE Nacos インスタンスのパブリックエンドポイントと内部エンドポイントは、インスタンスの **[Basic Information]** ページで確認できます。

• MSE Nacos のデフォルトのネームスペースには ID がないため、パラメーターは空のままでかまいません。 デフォルト以外のネームスペースを使用する場合、インスタンスのNamespacesページで ID を確認できます。

デプロイにパブリックエンドポイントを使用する場合は、接続を確保するために、クライアント IP アドレスをホワイトリストに追加する必要があります。「ホワイトリストの設定」

Java アプリケーションの移行

• ACM-Java-SDK を使用している場合、pom.xml ファイルには次の依存関係が含まれています。

  <dependency>
      <groupId>com.alibaba.edas.acm</groupId>
      <artifactId>acm-sdk</artifactId>
  </dependency>

  移行するには、次の JVM 引数を追加してアプリケーションを再デプロイしてください。

  -DDIAMOND.SERVER.IPS=${MSE_NACOS_PUBLIC/INTERNAL_ENDPOINT}

  また、コード内の namespace 設定を変更してください。

  properties.put("namespace", "${namespaceId}");

• ACM クライアントを使用していて、Nacos クライアントに切り替える場合は、Nacos-Java-SDK ユーザー向けの移行手順に従ってください。

• Nacos-Java-SDK を使用している場合、pom.xml ファイルには次の依存関係が含まれています。

<dependency>
  <groupId>com.alibaba.nacos</groupId>
  <artifactId>nacos-client</artifactId>
</dependency>

プレースホルダー ${...} を MSE のパブリックまたは内部エンドポイントに、${namespaceId} を MSE の名前空間 ID に置き換えてから、アプリケーションを再デプロイします。デフォルトの名前空間を使用する場合は、名前空間パラメーターを空にします。

properties.put("serverAddr", ${MSE_NACOS_PUBLIC/INTERNAL_ENDPOINT});
properties.put("namespace", "${namespaceId}");

起動時に次の引数を追加すると、移行が完了します。

 -Dnacos.cache.data.init.snapshot=false

Golang アプリケーションの移行

• ACM-golang-SDK を使用する場合、${endpoint} をお使いの MSE Nacos インスタンスのパブリック/内部エンドポイントに置き換えてください。

  clientConfig := constant.ClientConfig{
          Endpoint:       ${endpoint} + ":8080",
          NamespaceId:    namespaceId,
          AccessKey:      MSE_AK,
          SecretKey:      MSE_SK,
          TimeoutMs:      5 * 1000,
          ListenInterval: 30 * 1000,
      }

• Nacos-golang-SDK を使用する場合、${serverAddr} を MSE Nacos インスタンスのパブリック/内部エンドポイントに置き換えてください。

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

Python アプリケーションの移行

• ACM-Python-SDK を使用する場合、${endpoint} を MSE Nacos インスタンスのパブリック/内部エンドポイントに置き換え、${namespace_id} をその名前空間 ID に置き換えます。

  ENDPOINT = "${endpoint}"
  NAMESPACE = "${namespace_id}"
  c = acm.ACMClient(ENDPOINT, NAMESPACE, MSE_AK, MSE_SK)

• Nacos-Python-SDK を使用する場合、${server_address} をお使いの MSE Nacos インスタンスのパブリック/内部エンドポイントに、${namespace_id} をその名前空間 ID に置き換えます。

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

Node.js アプリケーションの移行

• ACM-Nodejs-SDK を使用する場合、${endpoint} を MSE Nacos インスタンスのパブリック/内部エンドポイントに、${namespace_id} をその名前空間 ID に置き換えます。

  // アドレス検索モードの場合
  const configClient = new NacosConfigClient({
    endpoint: '${endpoint}',
    namespace: '${namespace_id}',
    accessKey: 'MSE_AK',
    secretKey: 'MSE_SK',
    requestTimeout: 6000,
  });

• Nacos-Nodejs-SDK を使用する場合、${server_address} を MSE Nacos インスタンスのパブリック/内部エンドポイントに、${namespace_id} をその名前空間 ID に置き換えてください。

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

C# アプリケーションの移行

${server_address} をお使いの MSE Nacos インスタンスのパブリック/内部エンドポイントに、${namespace_id} をその名前空間 ID に置き換えます。

{
  "NacosConfig": {
    "Listeners": [
      {
        "Optional": false,
        "DataId": "common",
        "Group": "DEFAULT_GROUP"
      },
      {
        "Optional": false,
        "DataId": "demo",
        "Group": "DEFAULT_GROUP"
      }
    ],
    "Namespace": "namespace_id",  // Namespace ID の値を設定してください。
    "ServerAddresses": [ "http://${server_address}:8848/" ],
    "UserName": "test2",
    "Password": "123456",
    "AccessKey": "MSE_AK",
    "SecretKey": "MSE_SK",
    "ConfigFilterAssemblies": ["YouPrefix.AssemblyName"],
    "ConfigFilterExtInfo": "some ext information"
  }
}

C++ アプリケーションの移行

• ACM-CPP-SDK を使用する場合、${endpoint} をご使用の MSE Nacos インスタンスのパブリック/内部エンドポイントに、${namespace_id} をその名前空間 ID に置き換えます。

  // 次のパラメータを使用して設定サービスを初期化します。
   ACM::init("${endpoint}", "${namespace_id}", "${MSE_AK}", "${MSE_SK}");

• Nacos-CPP-SDK を使用する場合は、${server_address} をご使用の MSE Nacos インスタンスのパブリック/内部エンドポイントに置き換えてください。

  Properties props;
  props[PropertyKeyConst::SERVER_ADDR] = "${server_address}:8848";// サーバーアドレス