Microservices Engine：從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