从ACM迁移到MSE Nacos

迁移spring-cloud-alibaba应用

如果您的应用为spring-cloud-alibaba应用，修改应用程序的bootstrap.properties配置文件。

将如下内容：

spring.cloud.nacos.config.endpoint=${ACM的公网/私网地址}

替换为：

spring.cloud.nacos.config.server-addr=${MSE的公网/私网地址}

并且在如下配置中，将Namespace替换为MSE中的Namespace：

spring.cloud.nacos.config.namespace=${MSE的namespaceID}

可运行的示例Demo，请参见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实例的公网和私网地址可以在实例的基础信息页面获取。

  

• MSE中默认命名空间（Namespace）为空，可以不填写。如果导入的命名空间ID不为空，可以在Nacos实例的命名空间页面获取。

如果您使用公网地址进行部署，为了保证连通性，您需要将客户端列入白名单。具体操作，请参见设置白名单。

迁移Java应用

• 如果您使用的是ACM-Java-SDK，即您的依赖pom.xml中存在如下关键字：

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

  则可以直接在JVM运行参数中添加如下参数，并重新部署，即可完成迁移。

  -DDIAMOND.SERVER.IPS=${MSE的公网/私网地址}

  另外，请在代码中修改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的公网/私网地址});
properties.put("namespace", "${namespaceId}");

在启动时增加如下参数，即可完成迁移。

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

迁移Golang应用

• 如果您使用的是ACM-golang-SDK，则需要将${endpoint}替换为MSE的注册地址。

  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的注册地址。

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

迁移Python应用

• 如果您使用的是ACM-Python-SDK，则需要将${endpoint}和${namespace_id}替换为MSE的注册地址和命名空间ID。

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

• 如果您使用的是Nacos-Python-SDK，则需要将${server_address}和${namespace_id}替换为MSE的注册地址和命名空间ID。

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

迁移Node.js应用

• 如果您使用的是ACM-Nodejs-SDK，则需要将${endpoint}和${namespace_id}替换为MSE的注册地址和命名空间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}和${namespace_id}替换为MSE的注册地址和命名空间ID。

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

迁移C#应用

请将${server_address}和${namespace_id}替换为MSE的注册地址。

{
  "NacosConfig": {
    "Listeners": [
      {
        "Optional": false,
        "DataId": "common",
        "Group": "DEFAULT_GROUP"
      },
      {
        "Optional": false,
        "DataId": "demo",
        "Group": "DEFAULT_GROUP"
      }
    ],
    "Namespace": "namespace_id",  // Please set the value of Namespace 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 information"
  }
}

迁移C++应用

• 如果您使用的是ACM-CPP-SDK，则需要将${endpoint}和${namespace_id}替换为MSE的注册地址和命名空间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的注册地址。

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