Microservices Engine:アプリケーション構成管理から MSE Nacos インスタンスへのアプリケーションの移行

Spring Cloud Alibaba アプリケーション

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

以下を置き換えます。

spring.cloud.nacos.config.endpoint=${Public or internal endpoint of Application Configuration Management}

以下に置き換えます。

spring.cloud.nacos.config.server-addr=${Public or internal endpoint of your MSE Nacos instance}

次の構成で、MSE Nacos インスタンスの名前空間の ID を指定します。

spring.cloud.nacos.config.namespace =${ID of a namespace in your MSE Nacos instance}

サンプルデモの詳細については、「acm2nacos-spring-cloud-example」をご参照ください。

次の方法を使用して、アプリケーションが Spring Cloud Alibaba アプリケーションかどうかを確認できます。

pom.xml ファイルに次の依存関係が見つかった場合、アプリケーションは Spring Cloud Alibaba アプリケーションです。

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

• MSE Nacos インスタンスのパブリックエンドポイントまたは内部エンドポイントは、インスタンスの [基本情報] ページから取得できます。

• デフォルトの名前空間を使用する場合、名前空間には ID がありません。この場合、名前空間 ID は空のままにすることができます。宛先名前空間に ID がある場合は、MSE コンソールの MSE Nacos インスタンスの [名前空間] ページから名前空間 ID を取得できます。

インターネット経由で MSE Nacos インスタンスにアクセスする場合は、接続を確保するために、クライアントのパブリック IP アドレスを MSE Nacos インスタンスのパブリック IP アドレスホワイトリストに追加する必要があります。

Java アプリケーション

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

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

  この場合、次のパラメータを JVM ランタイムパラメータに直接追加し、アプリケーションを再デプロイして移行を完了できます。

  -DDIAMOND.SERVER.IPS=${Public or internal endpoint of your MSE Nacos instance}

  コード内の名前空間情報を変更します。

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

• 移行後にアプリケーション構成管理クライアントの代わりに Nacos クライアントを使用する場合は、後続の手順に従います。

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

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

この場合、次のコードで ${} を MSE Nacos インスタンスの登録済みエンドポイントに設定し、{namespaceId} を MSE Nacos インスタンスの名前空間 ID に設定してから、アプリケーションを再デプロイして移行を完了できます。デフォルトの名前空間を使用する場合は、{namespaceId} を空のままにします。

properties.put("serverAddr", ${Public or internal endpoint of your MSE Nacos instance});
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} を MSE Nacos インスタンスの名前空間 ID に設定する必要があります。

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

• Nacos-Python-SDK が使用されている場合、${server_address} を MSE Nacos インスタンスの登録済みエンドポイントに設定し、${namespace_id} を MSE Nacos インスタンスの名前空間 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} を MSE Nacos インスタンスの名前空間 ID に設定する必要があります。

  // for find address mode
  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} を MSE Nacos インスタンスの名前空間 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 を MSE Nacos インスタンスの名前空間 ID に設定します。

{
  "NacosConfig": {
    "Listeners": [
      {
        "Optional": false,
        "DataId": "common",
        "Group": "DEFAULT_GROUP"
      },
      {
        "Optional": false,
        "DataId": "demo",
        "Group": "DEFAULT_GROUP"
      }
    ],
    "Namespace": "namespace_id",  // 名前空間 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 infomation"
  }
}

C++ アプリケーション

• ACM-CPP-SDK が使用されている場合、${endpoint} を MSE Nacos インスタンスの登録済みエンドポイントに設定し、$namespace_id を MSE Nacos インスタンスの名前空間 ID に設定する必要があります。

  // Initialize configuration service and the console will retrieve the following parameters through the sample code.
   ACM::init("${endpoint}","$namespace_id","$accessKey","$secretKey");

• Nacos-CPP-SDK が使用されている場合、${server_address} を MSE Nacos インスタンスの登録済みエンドポイントに設定する必要があります。

  Properties props;
  props[PropertyKeyConst::SERVER_ADDR] = "${serverAddr}:8848";//Server address