将 Dubbo 应用平滑迁移到 EDAS - 开发者指南| 阿里云

迁移到 EDAS 的价值

EDAS 为应用部署提供了启动参数灵活配置、流程可视化、服务优雅上下线和分批发布等功能，让您的应用发布可配、可查、可控。
EDAS 提供了服务发现与配置管理功能，您无需再自行运维 Eureka、ZooKeeper、Consul 等中间件组件，可以直接使用 EDAS 提供的商业版服务发现与配置管理。
EDAS 控制台提供了统一的服务治理，目前支持查询发布和消费的服务详情。
EDAS 提供了动态扩、缩容功能，可以根据流量高峰和低谷实时地为您的应用扩容和缩容。
EDAS 提供了高级监控功能，除了支持基本的实例信息查询外，还支持微服务调用链查询、系统调用拓扑图、慢 SQL 查询等高级监控功能。
EDAS 提供限流降级功能，保证您的应用高可用。
EDAS 提供了全链路灰度功能，满足您的应用在迭代、更新时通过灰度进行小规模验证的需求。

什么是平滑迁移

如果您的 Dubbo 应用已经部署到生产环境并处于正常运行状态中，此时想将应用迁移到 EDAS 享受完整的 EDAS 功能，那么在迁移过程中，保证业务的平稳运行不中断是第一要务，而保证应用平台运行不中断迁移到 EDAS 即为平滑迁移。

说明如果您的应用尚未在生产环境中运行，或者您可以接受停机迁移，则没必要按照本文进行平滑迁移，可直接将应用在本地开发完再部署到 EDAS，详情请参见将 Dubbo 应用托管到 EDAS。

迁移流程

下图是一个比较典型的应用架构，根据迁移的先后顺序需要将迁移流程分为三步。

（必选）迁移应用
迁移的应用一般都是无状态的，所以这一步是可以先进行。同时，本文将重点介绍如何迁移应用。
（可选）迁移 SLB 或修改域名配置
在应用迁移完成后，您还需要迁移 SLB 或修改域名配置。
- SLB
  - 如果您的应用在迁移之前已经使用 SLB，在应用迁移后，可以复用该 SLB。
  - 如果您的应用在迁移之前没有使用 SLB，建议您在迁移完入口应用（如上图所示的 API Gateway）后，为该应用创建并绑定一个新的 SLB。
- 域名
  - 如果迁移后的应用可以复用 SLB，域名配置也无需修改。
  - 如果迁移后的应用需要创建新的 SLB 并绑定到应用，则需要在域名中添加新的 SLB 配置，详情请参见域名 DNS 修改，并删除原来不再使用的 SLB。
（可选）迁移存储和消息队列
- 如果应用已经部署在阿里云上，则存储和消息队列也使用了阿里云相关产品（如 RDS、MQ 等），则应用迁移完成后，之前的存储和消息队列无需迁移。
- 如果应用不在阿里云上，请提交工单或联系 EDAS 技术支持人员为您提供完整的上云及迁移到 EDAS 方案。

本文将主要介绍如何迁移应用。如果您想通过一个 Demo 快速体验平滑迁移的过程，可下载 Demo，参考 Readme 运行一个迁移的样例。

迁移方案

迁移应用有两种方案，切流迁移、双注册和双订阅迁移方案。这两种方案都可以保证您的应用正常运行不中断的完成迁移。

切流迁移方案
使用 Dubbo 将原有的服务注册中心切换到 EDAS ConfigServer，开发一套新的应用部署到 EDAS，最后通过 SLB 和域名配置来进行切流。

如果您选择此方案，那您可以参考将 Dubbo 应用托管到 EDAS开发应用，不需要再阅读迁移应用的后续内容。
双注册和双订阅迁移方案
双注册和双订阅迁移方案是指在应用迁移时同时接入两个注册中心（原有注册中心和 EDAS 注册中心）以保证已迁移的应用和未迁移的应用之间的相互调用。

通过双注册和双订阅平滑迁移应用的架构图如下：
- 已迁移的应用和未迁移的应用可以互相发现，从而实现互相调用，保证了业务的连续性。
- 使用方式简单，只需要添加依赖，并修改一行代码，就可以实现双注册和双订阅。
- 支持查看消费者服务调用列表的详情，实时地查看到迁移的进度。
- 支持在不重启应用的情况下，动态地变更服务注册的策略和服务订阅的策略，只需要重启一次应用就可以完成迁移。

迁移第一个应用

选择最先迁移的应用。
建议是从最下层 Provider 开始迁移。但如果调用链路太复杂，比较难分析，也可以任意选一个应用进行迁移。选择完成后，即可参考下面的迁移步骤迁移第一个应用。
在应用程序中添加依赖并修改配置（双注册、双订阅）。
为了能将您原来的应用托管到 EDAS 中，您需要在您的应用程序中添加相关依赖并修改配置。
1. 在pom.xml文件中添加 edas-dubbo-migration-bom 依赖。
```
    <dependency>
            <groupId>com.alibaba.edas</groupId>
            <artifactId>edas-dubbo-migration-bom</artifactId>
            <version>2.6.5.1</version>
            <type>pom</type>
        </dependency>                                
```
2. 在 application.properties 中添加注册中心的地址。
```
dubbo.registry.address = edas-migration://30.5.124.15:9999?service-registry=edas://127.0.0.1:8080,zookeeper://172.31.20.219:2181&reference-registry=zookeeper://172.31.20.219:2181&config-address=127.0.0.1:8848             
```
  说明如果是非 Spring Boot 应用，在 dubbo.properties 或者对应的 Spring 配置文件中配置。
  
  edas-migration://30.5.124.15:9999
  多注册中心的头部可以不做更改，启动的时候，如果日志级别是 WARN 及以下，可能会抛一个 WARN 的日志，因为 Dubbo 会对 IP 和端口做校验，可以忽略。
  
  service-registry
  是服务注册的注册中心地址，默认会进行多注册，写入多个注册中心地址。每个注册中心都是标准的 Dubbo 注册中心格式；多个用,分隔。其中 ZooKeeper 的地址 172.31.20.219 为实例，请使用真实的 ZooKeeper 地址和端口。`
  
  reference-registry
  是服务订阅的注册中心地址，可以进行多注册或者先注册到老的注册中心都可以。每个注册中心都是标准的 Dubbo 注册中心格式；多个用,分隔。
  
  config-address
  是动态推送的地址，如果本地想进行尝试，需要下载 Nacos。 EDAS 会对这个地址进行转换。
3. 其他修改。
  对于非 Spring Boot 的 Spring 应用，将com.alibaba.edas.dubbo.migration.controller.EdasDubboRegistryRest加入到您的扫描路径里。
本地验证。
如果只想进行一次修改，则可以使用动态配置的方式。
1. 准备工作。
2. 检查服务是否成功注册。
  - 登录轻量配置中心，在服务提供者列表中查看对应的服务。
  - 登录 ZooKeeper，查看服务注册和消费信息。
3. （可选）登录 Nacos，配置对应的服务注册信息。
  说明如果不需要动态配置的话，可以跳过此步骤。
  - DataId：dubbo.registry.config
  - Group：对应 Dubbo 应用的名称，applicationName，如 dubbo-migration-demo-server。配置信息是应用维度，所以应用名不能重复。
  - 配置内容：包含两种，一种是应用级别，一种是针对实例的 IP 级别（多张网卡可能出现问题）。
    - 应用级别
      dubbo.reference.registry=edas://127.0.0.1:8080 ##注册服务的注册中心 dubbo.service.registry=edas://127.0.0.1:8080,zookeeper:127.0.0.1:2181 ##订阅服务的注册中心
    - 实例 IP 级别
      169.254.15.86.dubbo.reference.registry=edas://127.0.0.1:8080,zookeeper:127.0.0.1:2181 169.254.15.86.dubbo.service.registry=edas://127.0.0.1:8080
    当对集群验证的时候，可以先从实例 IP 级别，再从整个应用验证这些配置是否生效。
4. 查看应用调用是否正常，查看注册中心的注册订阅关系。
  - Spring Boot 1.x 版本：http://ip:port/dubboRegistry
  - Spring Boot 2.x 版本：http://ip:port/actuator/dubboRegistry
将修改后的应用部署到 EDAS 中。
您可以根据您的实际需求将应用部署到 ECS 集群或容器服务 Kubernetes 集群中，在部署时也可以选择通过控制台、工具等方式进行部属。详情请参见应用部署概述（ECS）和应用部署概述（K8s 集群）。
- 为了帮助您节约成本，建议您继续使用之前 ECS，但需要将 ECS 导入到 EDAS 中，详情请参见创建 ECS 集群。
  
  注意在导入 ECS 的时候如果提示需要转化后导入，请对重要的数据做好备份。
- 如果需要创建新的 ECS、集群等资源，请确保在原有 VPC 内创建，以保证迁移前后的应用网络互通，顺利完成迁移。详情请参见创建资源。
- 在数据库、缓存、消息队列等产品中为新 ECS 配置 IP 白名单等，确保应用依赖的这些第三方组件可以正常访问。
结果验证。
1. 查看业务是否正常。
2. 查看服务订阅监控。
  如果您的应用开启了 Spring Boot Actuator 监控，那么可以访问 Actuator 来查看此应用订阅的各服务的 RibbonServerList 的信息。Actuator 地址如下：
  - Spring Boot 1.x 版本：http://ip:port/dubboRegistry
  - Spring Boot 2.x 版本：http://ip:port/actuator/dubboRegistry
  - dubbo.orig.**表示应用中配置的注册中心信息。
  - dubbo.effective.**表示生效的注册中心信息。

迁移其它所有应用

依照迁移第一个应用的迁移步骤，依次将所有应用迁移到 EDAS。

清理迁移配置

迁移完成后，删除原有的注册中心的配置和迁移过程专用的依赖edas-dubbo-migration-bom。

修改对应的注册中心地址，即将 ZooKeeper 的配置删除，保证 Consumer 只从 EDAS 订阅，Provider只在 EDAS 订阅。有以下两种方式：

方式一：动态配置
可以直接参考本地验证里的配置修改。
方式二：手动修改
当所有的应用都修改完成之后，修改应用的注册中心地址，将订阅的地址改为 EDAS ConfigServer。
```
dubbo.registry.address = edas-migration://30.5.124.15:9999?service-registry=edas://127.0.0.1:8080,zookeeper://172.31.20.219:2181&reference-registry=edas://127.0.0.1:8080&config-address=127.0.0.1:8848                   
```
reference-registry的值从zookeeper://172.31.20.219:2181改为edas://127.0.0.1:8080。修改完成之后，即可部署应用。
说明当应用迁移完成之后，如果不再使用ZooKeeper，需要从注册中心配置中删除zookeeper://172.31.20.219:2181，最后就变成了如下地址。
```
dubbo.registry.address = edas://127.0.0.1:8080                        
```

虽然长期使用对您业务的稳定性没有影响，但增加了 Dubbo 使用注册中心的复杂性和出错率，推荐您在迁移完毕后清理掉，然后在业务量较小的时间分批重启应用。