将Spring Cloud框架应用平滑迁移至SAE_Serverless 应用引擎(SAE)-阿里云帮助中心

如果您的Spring Cloud集群（包含多个应用）已经部署在阿里云上，您可以将应用迁移至Serverless 应用引擎 SAE（Serverless App Engine）。本文介绍如何将应用平滑迁移到SAE中，以及实现基本的服务注册与发现。

迁移流程

必需：迁移应用
迁移的应用通常是无状态的，需要先迁移应用。
可选：迁移SLB或修改域名配置
在应用迁移完成后，您还需要迁移SLB或修改域名配置。
- SLB
  - 如果您的应用在迁移之前已经使用SLB，应用迁移后可以复用该SLB。您可以根据您的实际需求选择绑定SLB的策略，具体操作，请参见为应用绑定CLB。
  - 如果您的应用在迁移之前没有使用SLB，建议在迁移完入口应用（例如流程图中所示的API Gateway）后，为该应用创建并绑定一个新SLB。
  - 迁移方案中，推荐使用双注册和双订阅方案，以节约ECS成本。如果由于某种原因（例如原ECS端口被占用）不能复用原ECS，则需要采用切流迁移方案，添加新的ECS用于应用迁移。在应用迁移完成后，依据迁移前应用是否使用SLB，选择复用SLB或创建SLB并绑定到迁移后应用。
- 域名
  - 如果迁移后的应用可以复用SLB，则域名配置无需修改。
  - 如果迁移后的应用需要创建新的SLB并绑定，则需要在域名中添加新的SLB配置，并删除原来不再使用的SLB。具体操作，请参见域名DNS修改。
可选：迁移存储和消息队列
- 如果应用迁移前已经部署在阿里云上，同时存储和消息队列同样使用了阿里云相关产品（例如RDS、MQ），那么应用迁移完成后，迁移前的存储和消息队列无需迁移。
- 如果应用迁移前没有部署在阿里云上，请加入钉群（钉群号：32874633），联系产品技术专家进行咨询。

本文以Demo应用演示平滑迁移。关于Demo应用的下载地址，请参见Demo。

迁移方案

迁移应用有以下两种方案，两种方案均可保证应用正常运行不中断情况下完成平滑迁移。

说明

本文主要介绍双注册和双订阅方案。

切流迁移方案
使用Spring Cloud Alibaba将原有的服务注册中心切换到Nacos。开发一套新的应用部署到SAE，最后通过SLB和域名配置来进行切流。
如果选择此方案，请参见将Spring Cloud应用托管到SAE。
双注册和双订阅迁移方案
双注册和双订阅迁移方案指在应用迁移时同时接入两个注册中心（原有注册中心和SAE注册中心），以保证已迁移的应用和未迁移的应用之间可相互调用。
双注册和双订阅平滑迁移方案架构图如下：
初始状态
第一步
第二步
第三步
第四步
- 已迁移的应用和未迁移的应用之间可以互相发现，从而实现互相调用，保证了业务的连续性。
- 使用方式简单，仅需要添加依赖，并修改极少代码，实现双注册和双订阅。
- 支持查看消费者服务调用列表的详情，实时地查看迁移的进度。
- 支持在不重启应用的情况下，动态地变更服务注册的策略和服务订阅的策略，只需要重启一次应用就可以完成迁移。

步骤一：迁移第一个应用

制定应用迁移优先级。
选择迁移需求优先级高的应用，建议从最下层Provider开始迁移。如果调用链路太复杂，难以分析，可以任意选一应用进行迁移。

在应用程序中添加依赖并修改配置。

在pom.xml文件中添加spring-cloud-starter-alibaba-nacos-discovery依赖。

<dependency>
     <groupId>org.springframework.cloud</groupId>
     <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
     <version>{相应的版本}</version>
 </dependency>

在application.properties中添加nacos-server的IP地址。

spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848

添加多注册中心依赖edas-sc-migration-starter。
Spring Cloud默认依赖中只能引入一个注册中心，存在多个注册中心时，启动会异常。如果需要支持多个注册中心，需要添加依赖edas-sc-migration-starter。
```
<dependency>
     <groupId>com.alibaba.edas</groupId>
     <artifactId>edas-sc-migration-starter</artifactId>
     <version>1.0.2</version>
 </dependency>                            
```

修改RibbonClients默认配置。
Ribbon是实现负载均衡组件，应用从多个注册中心订阅服务，需要修改Ribbon配置。在应用启动的主类中，将RibbonClients默认配置修改为MigrationRibbonConfiguration。
假设原有的应用主类启动代码如下：
```
@SpringBootApplication
 public class ConsumerApplication {
     public static void main(String[] args) {
         SpringApplication.run(ConsumerApplication.class, args);
     }
 }                                
```
修改后应用主类启动代码如下：
```
@SpringBootApplication
 @RibbonClients(defaultConfiguration = MigrationRibbonConfiguration.class)
 public class ConsumerApplication {
     public static void main(String[] args) {
         SpringApplication.run(ConsumerApplication.class, args);
     }
 }                                
```
说明
在本地修改应用或者应用部署到SAE后，如果对应用有其他控制需求，例如将应用注册到某些注册中心或从某些注册中心订阅，则可以通过Spring Cloud Config或Nacos Config动态地调整配置，而无需重启应用。调整配置的方法，请参见动态调整服务注册和订阅方式。
要通过Spring Cloud Config或Nacos Config动态地调整配置，需要在应用中添加配置管理依赖和修改配置。如果使用Spring Cloud Config，请参见相应的开源文档。如果使用Nacos Config，请参见实现配置管理。
将应用部署到SAE。
根据实际需求将应用部署到SAE。具体操作，请参见应用托管概述。
结果验证。
1. 观察业务运行是否正常。
2. 查看服务订阅监控。
  - Spring Boot 1.x版本：http://ip:port/dubboRegistry
  - Spring Boot 2.x版本：http://ip:port/actuator/dubboRegistry
  如果应用开启了Spring Boot Actuator监控功能，请访问Actuator查看此应用订阅的各服务的RibbonServerList信息。Actuator地址如下： metaInfo中serverGroup字段表示此节点的服务注册中心。

步骤二：迁移其他所有应用

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

步骤三：清理迁移配置

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

edas-sc-migration-starter迁移专用的starter，长期使用对业务的稳定性没有影响，对于Ribbon负载均衡实现有一定的局限性，建议在迁移完毕后删除，并在业务量较小的时间段内分批重启应用。

动态调整服务注册和订阅方式
应用迁移过程中，可以通过SAE配置管理功能动态变更服务注册和订阅方式。
动态调整服务订阅
系统默认的订阅策略，是SAE从所有注册中心订阅服务数据，并对数据进行聚合。
您可以通过SAE的配置管理修改spring.cloud.edas.migration.subscribes属性，选择具体的注册中心订阅数据。
```
spring.cloud.edas.migration.subscribes=nacos,eureka  # 同时从Eureka和Nacos订阅服务。
spring.cloud.edas.migration.subscribes=nacos         # 只从Nacos订阅服务。                        
```
动态变更服务注册
系统默认的注册策略，是SAE注册到所有注册中心。
您可以通过SAE的配置管理来调整服务注册中心。
通过修改spring.cloud.edas.migration.registry.excludes属性关闭指定的注册中心。
```
spring.cloud.edas.migration.registry.excludes=              # 默认值为空，注册到所有的服务注册中心。
spring.cloud.edas.migration.registry.excludes=eureka        # 关闭Eureka的注册。
spring.cloud.edas.migration.registry.excludes=nacos,eureka  # 关闭Nacos和Eureka的注册。                       
```
应用运行时，如果需要动态修改服务注册策略，可以使用Spring Cloud配置管理功能在运行时修改此属性。

迁移流程

迁移方案

初始状态

第一步

第二步

第三步

第四步

步骤一：迁移第一个应用

步骤二：迁移其他所有应用

步骤三：清理迁移配置