MSE Sync迁移方案

迁移工具介绍

• 可平滑迁移

  MSE Sync是基于开源Nacos Sync优化的一款数据同步工具。MSE Sync提供双向同步、自动获取服务和一键同步全部服务等功能，能更好地完成Nacos、Zookeeper和Eureka注册配置中心的迁移。在迁移过程中，MSE Sync能使源集群的服务信息和MSE云上产品的服务信息保持同步，从而实现自建配置注册中心和MSE产品之间的平滑迁移。本文图片中的pub指服务发布者，sub指服务订阅者。

• 可多实例部署

  为了避免单实例宕机导致两端服务信息不一致，MSE Sync可采用多实例部署的方式实现容灾。

• 操作简易

  MSE Sync适配Zookeeper、Nacos和Eureka的服务注册逻辑，能够实现Zookeeper到Zookeeper、Zookeeper到Nacos、Nacos到Nacos和Eureka到Nacos的服务信息同步，并且支持从Zookeeper、Nacos和Eureka中自动获取服务信息，一键全选避免繁琐操作。

支持的注册中心类型

部署MSE Sync迁移工具

部署模式

• 依赖MySQL部署

  需要自行构建MySQL服务， 并创建具有读写权限的MSE Sync账号和数据库，通过环境变量传入MySQL的URL、用户名和密码。多个MSE Sync可共享一个MySQL服务

• 依赖Derby部署

  MSE Sync支持内嵌Derby数据库，可单机启动。

环境变量

• 数据库相关环境变量

  MSE Sync通过环境变量自动判断使用MySQL还是Derby依赖启动，当MYSQL_URL、MYSQL_USER_NAME和MYSQL_PASSWORD这几个环境变量的取值都不为空时，MSE Sync才会通过给定环境连接MySQL服务启动，其他情况下都通过依赖内嵌Derby数据库进行启动。

  环境变量名	描述	举例
  MYSQL_URL	MySQL的连接串。	jdbc:mysql://localhost:3306/sync
  MYSQL_USER_NAME	MSE Sync具有读写权限的账户用户名。	无
  MYSQL_PASSWORD	MYSQL_USER_NAME对应的密码。	无

• JVM相关环境变量

  在conf文件夹下的java.env文件中，通过JAVA_OPT变量添加JVM 参数。

  例如，通过代码设置JVM堆内存大小，JAVA_OPT="$JAVA_OPT -Xms2048m -Xmx2048m。

部署方式

• K8s部署

  1. 修改以下配置的MySQL用户名、密码和replicas等参数, 保存配置文件为mse-sync-deployment.yaml。

     apiVersion: apps/v1
     kind: Deployment
     metadata:
       labels:
         app.kubernetes.io/name: mse-sync
       name: mse-sync-svc
     spec:
       replicas: 3
       selector:
         matchLabels:
           app.kubernetes.io/name: mse-sync
       template:
         metadata:
           labels:
             app.kubernetes.io/name: mse-sync
         spec:
           containers:
           - name: mse-sync
             image: msecrinstance-registry.cn-hangzhou.cr.aliyuncs.com/mse-demo/mse-sync:latest
             ports:
             - containerPort: 8000
               env:
             - name: MYSQL_URL
               value: "jdbc:mysql://192.xx.xx.xx:3306/sync"
             - name: MYSQL_USER_NAME
               value: "mse-sync"
               - name: MYSQL_PASSWORD
                 value: password

     说明

     如果需要访问MSE Sync UI，需要添加一个Service指向MSE Sync的8000端口。

  2. 执行以下命令，部署MSE Sync。

     kubectl apply -f mse-sync-deployment.yaml

• ECS部署

  1. 下载MSE Sync的二进制包。

     curl https://msesync.oss-cn-hangzhou.aliyuncs.com/MseSync.zip --output msesync.zip

  2. 解压二进制包，并进入MSE Sync的根目录。

     unzip ./msesync.zip

  3. 可选：如需依赖MySQL，需要配置如下环境变量。

     export MYSQL_URL=""
     export MYSQL_USER_NAME=""
     export MYSQL_PASSWORD=""

  4. 启动应用。

     ./MseSync/bin/startup.sh start

配置集群信息和迁移任务

配置示例

clusters:
  - clusterName: src
    connectKeyList:
      - mse-xxxxx-nacos-ans.mse.aliyuncs.com:8848
    clusterType: NACOS
    namespace: public,test
  - clusterName: dst
    connectKeyList:
      - mse-xxxxxx-nacos-ans.mse.aliyuncs.com:8848
    clusterType: NACOS

tasks:
  - source: src
    destination: dst
    type: Service
    mode: Bidirectional
    serviceMatchPattern: ".*"
    autoScanAndAddService: true

配置示例可见，配置项有两个字段，即clusters和tasks，分别描述集群和同步任务信息。以下分别对类型为List的clusters和tasks字段解释说明。

• clusters

  字段	说明	取值举例
  clusterName	集群名称 说明 配置中的集群名不可重复。	sourceCluster
  clusterType	集群类型	NACOS ZOOKEEPER EUREKA
  namespace	Nacos namespace名称 说明 可以输入多个，使用英文逗号分隔。	public test test1
  connectKeyList	集群的接入Endpoint，类型为List。	connectKeyList: - localhost:8848 - localhost1:8848
  userName	Nacos用户名	无。
  password	Nacos密码	无。
  ak	MSE Nacos RAM鉴权具有读写权限子账号的AccessKey。	无。
  sk	AccessKey对应的SecretKey。	无。

• tasks

  字段	说明	取值举例
  source	clusters源集群名	无。
  destination	clusters目标集群名	目标集群的命名空间自动和源集群保持一致，如果目标集群中不存在对应的命名空间，MSE Sync会自动创建。
  type	同步类型	Service Config，仅当ZooKeeper同步ZooKeeper时，支持Config类型。
  mode	同步模式	Unidirectional （单向同步）：只会将原生注册的服务信息从源集群同步到目标集群。 Bidirectional（双向同步）：能够实现源集群和目标集群之间原生注册的服务信息的双向同步。
  serviceMatchPattern	需要同步的服务的正则匹配表达式。	默认同步所有服务。
  autoScanAndAddService	是否自动扫描并同步源集群中新增加的服务。	默认为True。