Microservices Engine:Migrer d'ACM vers MSE Nacos

Migrer les applications Spring Cloud Alibaba

Si votre application est une application Spring Cloud Alibaba, modifiez le fichier de configuration bootstrap.properties.

Remplacez le contenu suivant :

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

par :

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

Mettez également à jour le namespace vers celui de votre MSE Nacos :

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

Pour consulter une démonstration fonctionnelle, reportez-vous à acm2nacos-spring-cloud-example.

Pour vérifier si votre application est une application Spring Cloud Alibaba :

Vérifiez la présence de la dépendance suivante dans le fichier pom.xml :

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

• Vous trouverez les endpoints publics et internes de votre instance MSE Nacos sur sa page Basic Information.

• Le namespace par défaut dans MSE Nacos ne possède pas d'ID, vous pouvez donc laisser ce paramètre vide. Si vous utilisez un namespace autre que celui par défaut, vous trouverez son ID sur la page Namespaces de votre instance.

Si vous utilisez un endpoint public pour le déploiement, vous devez ajouter les adresses IP des clients à la liste d'autorisation afin d'assurer la connectivité. Définir une liste d'autorisation

Migrer les applications Java

• Si vous utilisez l'ACM-Java-SDK, votre fichier pom.xml contient la dépendance suivante :

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

  Pour migrer, ajoutez l'argument JVM suivant et redéployez l'application.

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

  Modifiez également le paramètre de namespace dans votre code.

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

• Si vous utilisez un client ACM et souhaitez passer à un client Nacos, suivez les instructions destinées aux utilisateurs de Nacos-Java-SDK.

• Si vous utilisez le Nacos-Java-SDK, votre fichier pom.xml contient la dépendance suivante :

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

Remplacez l'espace réservé ${...} par l'endpoint public ou interne de MSE et ${namespaceId} par l'ID du namespace MSE, puis redéployez l'application. Si vous utilisez le namespace par défaut, laissez le paramètre de namespace vide.

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

Ajoutez l'argument suivant au démarrage pour finaliser la migration.

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

Migrer les applications nacos-spring-boot

Si votre application est une application nacos-spring-boot, modifiez le fichier de configuration application.properties.

Remplacez le contenu suivant :

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

par :

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

Mettez également à jour le namespace vers celui de votre MSE Nacos :

nacos.config.namespace=${MSE_NACOS_NAMESPACE_ID}

Migrer les applications Golang

• Si vous utilisez l'ACM-golang-SDK, remplacez ${endpoint} par l'endpoint public/interne de votre instance MSE Nacos.

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

• Si vous utilisez le Nacos-golang-SDK, remplacez ${serverAddr} par l'endpoint public/interne de votre instance MSE Nacos.

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

Migrer les applications Python

• Si vous utilisez l'ACM-Python-SDK, remplacez ${endpoint} par l'endpoint public/interne de votre instance MSE Nacos et ${namespace_id} par son ID de namespace.

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

• Si vous utilisez le Nacos-Python-SDK, remplacez ${server_address} par l'endpoint public/interne de votre instance MSE Nacos et ${namespace_id} par son ID de namespace.

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

Migrer les applications Node.js

• Si vous utilisez l'ACM-Nodejs-SDK, remplacez ${endpoint} par l'endpoint public/interne de votre instance MSE Nacos et ${namespace_id} par son ID de namespace.

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

• Si vous utilisez le Nacos-Nodejs-SDK, remplacez ${server_address} par l'endpoint public/interne de votre instance MSE Nacos et ${namespace_id} par son ID de namespace.

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

Migrer les applications C#

Remplacez ${server_address} par l'endpoint public/interne de votre instance MSE Nacos et ${namespace_id} par son ID de namespace.

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

Migrer les applications C++

• Si vous utilisez l'ACM-CPP-SDK, remplacez ${endpoint} par l'endpoint public/interne de votre instance MSE Nacos et ${namespace_id} par son ID de namespace.

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

• Si vous utilisez le Nacos-CPP-SDK, remplacez ${server_address} par l'endpoint public/interne de votre instance MSE Nacos.

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