从Spring Cloud Gateway迁移到云原生API网关_API 网关(API Gateway)-阿里云帮助中心

在K8s架构体系下，Spring Cloud Gateway缺乏发现容器服务的能力，性能不如Nginx Ingress，可观测性和安全性也需要二次开发和集成。在上云、混合云等场景中可能出现Ingress和Spring Cloud Gateway的双层网络架构，这不仅增加了层网络和资源消耗，也增加了运维成本。云原生API网关将传统的流量网关和微服务网关场景二合一，可以大幅降低服务成本，同时具有高性能、高集成和开箱即用的优势。本文介绍如何将服务从Spring Cloud Gateway迁移到云原生API网关。

前提条件

已创建云原生API网关。

步骤一：明确服务来源

如果您是以下情况，可以直接跳到步骤二：迁移Spring Cloud Gateway配置。

使用的ACK容器服务，并使用K8s Service作为服务发现。
已购买使用MSE Nacos作为注册中心（升级到支持MCP的版本）。
未依赖任何服务发现机制，使用域名和固定地址服务。

如果您是自建注册中心，可执行以下迁移操作接入云原生API网关：

购买MSE Nacos注册中心，请参见创建Nacos引擎。
修改配置或代码，将服务注册到MSE Nacos上，请参见Java SDK。
可选：Java应用可以基于MSE治理Agent技术实现注册中心迁移，请参见MSE Sync迁移方案。

步骤二：迁移Spring Cloud Gateway配置

在迁移到云原生API网关时，您需要仔细分析当前的配置和功能需求，并找到在目标网关中能够实现相同功能的配置。下面通过一个具体的例子来展示如何将Spring Cloud Gateway的注册中心迁移到Nacos配置：

注册中心：云原生API网关将注册中心的关联统一抽象为服务来源的管理，您可以通过云原生API网关控制台创建服务来源。根据下方配置信息，创建服务来源为MSE Nacos，然后创建服务，确保动态实时生效。
```
spring:
  application:
    name: gateway-demo
  cloud:
    nacos:
      discovery:
        server-addr: nacos-server:8848
      config:
        enabled: false
```
服务关联配置：根据下方配置项，您需要在服务的策略配置页签中找到负载均衡配置区域进行配置。在从Spring Cloud Gateway转向云原生API网关时，需要将客户端的配置（比如下方配置项中的Ribbon客户端负载均衡配置）迁移到新的环境中，以确保服务能够正常运行并保持原有的功能。

service-a:
  ribbon:
    NFLoadBalancerRuleClassName: com.netflix.loadbalancer.WeightedResponseTimeRule
    ConnectTimeout: 1000
    ReadTimeout: 8000
    MaxAutoRetries: 3
    MaxAutoRetriesNextServer: 2
    MaxTotalConnections: 20000
    MaxConnectionsPerHost: 5000

路由配置：根据下方配置项，您需要先创建对应的API，然后为API配置路由策略，您可以参见路由目录下的文档创建路由。最后为其配置熔断策略，更多信息，请参加路由策略。

spring:
  cloud:
    gateway:
      default-filters:
        - AddResponseHeader=X-Response-Default-Foo, Default-Bar

      routes:
        - id: websocket_test
          uri: ws://localhost:9000
          order: 9000
          predicates:
            - Path=/echo
        - id: default_path_to_service-a
          uri: lb://service-a
          order: 10000
          predicates:
            - Path=/sleep
hystrix:
  command:
    service-a:
      execution:
        isolation:
          thread:
            timeoutInMilliseconds: 60000
          strategy: SEMAPHORE
          semaphore:
            maxConcurrentRequests: 60000

步骤三：为网关配置认证鉴权

云原生API网关支持多种标准鉴权体系，请参见：

步骤四：查看网关全局数据

云原生API网关支持查看网关全局数据大盘，请参见：

步骤五：迁移流量

下面为您提供调用端流量迁移思路：

调用方（客户端）迭代迁移：您可以选取部分业务场景迭代修改访问地址，迁移验证。
代理层逐步灰度迁移：您可以在原接入代理层制定变更步骤（例如，按照核心业务和非核心业务划分），逐步灰度转发到新地址。
域名解析全量切换：充分灰度后，将域名重新到新云原生API网关入口地址。
（推荐）分步骤迁移：
1. 选取部分业务场景试用验收。
2. 逐步迭代灰度迁移核心场景流量。
3. 充分压力验证后，切换域名解析全量迁移。

迁移方案	成本	风险
迭代迁移	高	低
代理层逐步灰度迁移	中	中
域名解析全量切换	低	高
分步骤迁移	较低	较低