Microservices Engine:Migrate from Zuul to a cloud-native gateway

Elegir un tipo de origen de servicio

zuul:
  routes:
    demo:
      path: /test/a
      serviceId: service-a
    pre:
      path: /auth/validation/**
      serviceId: service-a
    header:
      path: /auth/test
      requestHeadersToAdd:
      - key: debug_tag
        value: true
    retry:
      path: /app/try/**
      stripPrefix: false
      retryable: true
      serviceId: service-a
  retryable: true
  ignoredPatterns:
  - /login/api/a/v3/a
  - /auth/api/b

spring:
  application:
    name: zuul-demo
  cloud:
    nacos:
      discovery:
        server-addr: nacos-server:8848
      config:
        enabled: false

service-a:
  ribbon:
    NFLoadBalancerRuleClassName: com.netflix.loadbalancer.WeightedResponseTimeRule
    ConnectTimeout: 1000
    ReadTimeout: 8000
    MaxAutoRetries: 3
    MaxAutoRetriesNextServer: 2
    MaxTotalConnections: 20000
    MaxConnectionsPerHost: 5000
hystrix:
  command:
    service-a:
      execution:
        isolation:
          thread:
            timeoutInMilliseconds: 60000
          strategy: SEMAPHORE
          semaphore:
            maxConcurrentRequests: 60000

2a. Agregar un origen de servicio (reemplaza la configuración de registro)

En la consola de MSE:

1. Abra la página Service source de su puerta de enlace nativa de la nube.

2. Agregue su registro de Nacos (u otro tipo de registro) como origen de servicio.

3. Los cambios surten efecto en tiempo real.

Esto reemplaza la configuración spring.cloud.nacos.discovery.server-addr en Zuul. Add a service source.

2b. Importar y configurar servicios (reemplaza serviceId y Ribbon)

1. Importe los servicios a los que hacen referencia sus rutas de Zuul (por ejemplo, service-a). Add a service.

2. Configure una versión de ruta para cada servicio. Manage service versions.

La puerta de enlace nativa de la nube gestiona el balanceo de carga de forma nativa. Esto reemplaza la configuración de Ribbon (WeightedResponseTimeRule, ConnectTimeout, ReadTimeout, grupos de conexiones) mediante la configuración integrada de servicios y reglas de enrutamiento.

Mapeo de Ribbon a puerta de enlace nativa de la nube

Mapeo de Hystrix a puerta de enlace nativa de la nube

2c. Crear reglas de enrutamiento (reemplaza zuul.routes)

Cree reglas de enrutamiento en la consola de MSE. Cada ruta de Zuul se asigna a una regla de enrutamiento con un predicado de ruta y un servicio destino.

Conversión de rutas lado a lado

Para ignoredPatterns (/login/api/a/v3/a, /auth/api/b), no cree reglas de enrutamiento para esas rutas.

La puerta de enlace nativa de la nube utiliza internamente el formato de Spring Cloud Gateway:

spring:
  cloud:
    gateway:
      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

Create a routing rule.

2d. Configurar directivas de enrutamiento adicionales

Las directivas de enrutamiento integradas reemplazan el código de filtros de Zuul:

Estrategias de migración de tráfico

Recomendación: migración por procedimientos

1. Pruebe con servicios no críticos. Actualice las URL de acceso de varios servicios no críticos para que apunten a la puerta de enlace nativa de la nube. Compruebe el enrutamiento, la autenticación y la observability.

2. Migre los servicios críticos en secuencia. Una vez que las pruebas sean exitosas, migre los servicios críticos uno por uno. Monitoree errores, cambios de latencia y anomalías de tráfico en los paneles de la puerta de enlace.

3. Realice la transición de DNS tras las pruebas de estrés. Después de migrar y validar todos los servicios, ejecute pruebas de estrés en la puerta de enlace nativa de la nube y asocie el nombre de dominio original con su URL de acceso.

Comprobar la migración

Después de cada fase, compruebe lo siguiente:

• Las reglas de enrutamiento coinciden con el comportamiento esperado (pruebe las rutas clave).

• La autenticación se completa correctamente para todos los endpoints de servicio.

• Los paneles de monitoreo muestran los patrones de tráfico esperados.

• No aparecen errores en los registros de la puerta de enlace (revise la salida del envío de registros).

Reversión

Si surgen problemas:

1. Revierta las URL de acceso (o los registros DNS) para que apunten nuevamente a la puerta de enlace Zuul.

2. Mantenga la puerta de enlace Zuul en ejecución hasta que la migración se valide por completo.

3. Investigue y resuelva los problemas antes de reintentar la migración.