Microservices Engine:Migrar do ACM para o MSE Nacos

Migrar aplicações Spring Cloud Alibaba

Caso sua aplicação seja baseada em Spring Cloud Alibaba, modifique o arquivo de configuração bootstrap.properties.

Substitua o seguinte conteúdo:

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

por:

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

Além disso, atualize o namespace para o seu namespace do MSE Nacos:

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

Para um exemplo executável, consulte acm2nacos-spring-cloud-example.

Para verificar se sua aplicação é uma aplicação Spring Cloud Alibaba:

Verifique no arquivo pom.xml a presença da seguinte dependência:

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

• Os endpoints públicos e internos da sua instância MSE Nacos estão disponíveis na página Basic Information.

• O namespace padrão no MSE Nacos não possui ID, portanto, deixe o parâmetro vazio. Se utilizar um namespace diferente do padrão, encontre o ID correspondente na página Namespaces da sua instância.

Ao usar um endpoint público para implantação, adicione os endereços IP dos clientes à lista de permissões para garantir a conectividade. Definir uma lista de permissões

Migrar aplicações Java

• Se você utiliza o ACM-Java-SDK, seu arquivo pom.xml contém a seguinte dependência:

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

  Para migrar, adicione o seguinte argumento JVM e reimplante a aplicação.

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

  Modifique também a configuração de namespace no seu código.

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

• Caso utilize um cliente ACM e deseje alternar para um cliente Nacos, siga as instruções destinadas a usuários do Nacos-Java-SDK.

• Se você usa o Nacos-Java-SDK, seu arquivo pom.xml contém a seguinte dependência:

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

Substitua o espaço reservado ${...} pelo endpoint público ou interno do MSE e ${namespaceId} pelo ID do namespace do MSE; depois, reimplante a aplicação. Se estiver usando o namespace padrão, deixe o parâmetro de namespace vazio.

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

Adicione o seguinte argumento na inicialização para concluir a migração.

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

Migrar aplicações nacos-spring-boot

Se sua aplicação for do tipo nacos-spring-boot, modifique o arquivo de configuração application.properties.

Substitua o seguinte conteúdo:

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

por:

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

Atualize também o namespace para o seu namespace do MSE Nacos:

nacos.config.namespace=${MSE_NACOS_NAMESPACE_ID}

Migrar aplicações Golang

• Se você utiliza o ACM-golang-SDK, substitua ${endpoint} pelo endpoint público/interno da sua instância MSE Nacos.

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

• Caso utilize o Nacos-golang-SDK, substitua ${serverAddr} pelo endpoint público/interno da sua instância MSE Nacos.

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

Migrar aplicações Python

• Se você utiliza o ACM-Python-SDK, substitua ${endpoint} pelo endpoint público/interno da sua instância MSE Nacos e ${namespace_id} pelo ID do namespace correspondente.

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

• Caso utilize o Nacos-Python-SDK, substitua ${server_address} pelo endpoint público/interno da sua instância MSE Nacos e ${namespace_id} pelo ID do namespace correspondente.

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

Migrar aplicações Node.js

• Se você utiliza o ACM-Nodejs-SDK, substitua ${endpoint} pelo endpoint público/interno da sua instância MSE Nacos e ${namespace_id} pelo ID do namespace correspondente.

  // for find address mode
  const configClient = new NacosConfigClient({
    endpoint: '${endpoint}',
    namespace: '${namespace_id}',
    accessKey: 'MSE_AK',
    secretKey: 'MSE_SK',
    requestTimeout: 6000,
  });

• Caso utilize o Nacos-Nodejs-SDK, substitua ${server_address} pelo endpoint público/interno da sua instância MSE Nacos e ${namespace_id} pelo ID do namespace correspondente.

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

Migrar aplicações C#

Substitua ${server_address} pelo endpoint público/interno da sua instância MSE Nacos e ${namespace_id} pelo ID do namespace correspondente.

{
  "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"
  }
}

Migrar aplicações C++

• Se você utiliza o ACM-CPP-SDK, substitua ${endpoint} pelo endpoint público/interno da sua instância MSE Nacos e ${namespace_id} pelo ID do namespace correspondente.

  // Initializes the configuration service using the following parameters.
   ACM::init("${endpoint}","$namespace_id","$accessKey","$secretKey");

• Caso utilize o Nacos-CPP-SDK, substitua ${server_address} pelo endpoint público/interno da sua instância MSE Nacos.

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