NacosSync迁移用户手册

NacosSync迁移用户手册

手册目标

启动NacosSync服务
通过一个简单的例子,演示如何将注册到Zookeeper的Dubbo客户端迁移到Nacos

系统需要

启动服务之前,你需要安装下面的服务:

64bit OS: Linux/Unix/Mac/Windows supported, Linux/Unix/Mac recommended.
64bit JDK 1.8+: downloads, JAVA_HOME settings.
Maven 3.2.x+: downloads, settings.
MySql 5.6.+

获取安装包

有2种方式可以获得NacosSync的安装包:

直接下载NacosSync的二进制安装包（下载最新的版本 https://github.com/nacos-group/nacos-sync/releases）
nacosSync.${version}.zip
从GitHub上下载NacosSync的源码进行构建
Package:

cd nacosSync/
mvn clean package -U

目标文件的路径:

nacos-sync/nacossync-distribution/target/nacosSync.${version}.zip

解压安装包之后,工程的文件目录结构:

nacosSync
├── LICENSE
├── NOTICE
├── bin
│   ├── nacosSync.sql
│   ├── shutdown.sh
│   └── startup.sh
├── conf
│   ├── application.properties
│   └── logback-spring.xml
├── logs
└── nacosSync-server.${version}.jar

初始化DB

系统默认配置的数据库是MySql,也能支持其他的关系型数据库

建库,缺省的数据库名字为“nacos_Sync”
数据库表不需要单独创建,默认使用了hibernate的自动建表功能
如果你的环境不支持自动建表,可以使用系统自带的sql脚本建表,脚本放在bin目录下

DB配置

DB的配置文件放在conf/application.properties中:

spring.datasource.url=jdbc:mysql://127.0.0.1:3306/nacos_sync?characterEncoding=utf8
spring.datasource.username=root
spring.datasource.password=root

启动服务器

$ nacosSync/bin:
sh startup.sh  restart

检查系统状态

1.系统日志检查日志的路径在 nacosSync/logs/nacosSync.log,检查是否有异常信息2.检查系统端口(缺省的系统端口是8081,你可以自己定义在application.properties中)

$netstat -ano|grep 8081
tcp        0      0 0.0.0.0:8081                0.0.0.0:*                   LISTEN      off (0.00/0/0)

控制台

访问路径:

http://127.0.0.1:8081/#/serviceSync

如果检查没有问题,NacosSync已经正常启动了,NacosSync的部署结构:

开始迁移

迁移信息

Dubbo服务的部署信息:

迁移的服务:

Service Name	Version	Group Name
com.alibaba.nacos.api.DemoService	1.0.0	zk

添加注册中心集群信息

1.点击左侧导航栏中的“集群配置”按钮,新增加一个集群,先增加一个Zookeeper集群,选择集群类型为ZK

注意:集群名字可以自定义,但是一旦确认,不能被修改,否则基于此集群增加的任务,在NacosSync重启后,将不会恢复成功

2.同样的步骤,增加NacosSync集群

添加完成后,可以在列表中查询到

添加同步任务

1.增加一个同步任务,从Zookeeper集群同步到Nacos集群,同步的粒度是服务,Zookeeper集群则称为源集群,Nacos集群称为目标集群

添加完成之后,可以在服务同步列表中,查看已添加的同步任务:

2.同步完成之后,检查下数据是否同步成功到Nacos集群,可以通过Nacos的控制台进行查询

此刻,数据已经成功从Zookeeper集群同步到了Nacos集群,部署结构如下:

让Dubbo客户端连接到Nacos注册中心

Dubbo Consumer客户端迁移

Dubbo 已经支持Nacos注册中心,支持的版本为2.5+,需要增加一个Nacos注册中心的Dubbo扩展插件依赖:

<dependency>
      <groupId>com.alibaba</groupId>
      <artifactId>dubbo-registry-nacos</artifactId>
            <version>0.0.2</version>
</dependency>

增加Nacos客户端的依赖:

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

配置Dubbo Consumer的Dubbo配置文件,让客户端能够找到Nacos集群consumer.yaml

spring:
  application:
name: dubbo-consumer
demo:
  service:
    version: 1.0.0
    group: zk
dubbo:
  registry:
    address: nacos://127.0.0.1:8848

不需要修改代码,配置更新完毕之后 ,你就可以重启你的应用,使之生效了.

Consumer发布完成之后,目前的部署结构如下:

Dubbo Provider迁移

在升级Provider之前,你需要确保该Provider发布的服务,都已经配置在NacosSync中,同步的方式为从Nacos同步到Zookeeper,因为Provider升级连接到Nacos之后,需要确保老的Dubbo Consumer客户端能够在Zookeeper上订阅到该Provider的地址,现在,我们增加一个同步任务: