Dirija el tráfico entrante a sus aplicaciones de SAE mediante un API Gateway nativo de la nube. Esta guía le explica cómo crear una ruta de gateway en la consola de SAE y detalla las opciones clave de configuración.
Contexto
Un API Gateway nativo de la nube es una solución unificada que integra gateways de tráfico, de microservicios, de seguridad y de IA en una sola plataforma. Gestiona el descubrimiento de servicios, el balanceo de carga y la comunicación entre servicios, lo que elimina la fragmentación típica de los gateways distribuidos tradicionales. Para obtener más información, consulte What is a cloud-native API gateway?.
Requisitos previos
Antes de empezar, asegúrese de contar con lo siguiente:
MSE: Una instancia de API Gateway nativo de la nube. Consulte Create a cloud-native API Gateway instance.
SAE: Un namespace en la misma región que el gateway, vinculado a la misma Virtual Private Cloud (VPC). Consulte Create a namespace.
SAE: Una aplicación desplegada en dicho namespace.
Creación de una ruta de gateway
Vaya a la página de Enrutamiento de gateway de SAE, seleccione una región y un namespace, y luego haga clic en Create Gateway Route.
En la página Create Route, configure los siguientes parámetros y haga clic en Save.
Configuración básica
|
Parámetro |
Descripción |
Ejemplo |
|
Route name |
Nombre personalizado para la regla de enrutamiento. |
|
|
Network type |
Red mediante la cual se reenvían las solicitudes. Internet: tráfico proveniente de internet público; se cobra según el tráfico reenviado real. Private: tráfico exclusivo dentro de la VPC actual; sin costo. |
Internet |
|
Gateway type |
Seleccione Cloud-native API Gateway. |
Cloud-native API Gateway |
|
Gateway instance |
Obligatorio cuando Gateway type es Cloud-native API Gateway. Seleccione una instancia en la misma región y VPC que el namespace. Para crear una nueva instancia, haga clic en Create Cloud-native API Gateway. Consulte Create a cloud-native API Gateway instance. |
|
|
Domain name |
Uno o varios nombres de dominio para coincidir. Para agregar un nuevo dominio, haga clic en Create Domain Name. Consulte Crear un nombre de dominio. |
|
Condiciones de coincidencia
Configure la forma en que el gateway identifica las solicitudes que maneja esta ruta.
Coincidencia de ruta
Establezca el patrón de ruta que debe coincidir en las solicitudes HTTP.
|
Tipo de coincidencia |
Comportamiento |
Ejemplo |
|
Equals |
Solo coincidencia exacta. |
|
|
Prefix |
Coincide con cualquier ruta que comience con el valor especificado. |
|
|
Regular expression |
Compara las rutas con un patrón de expresión regular. |
|
Cuando varias reglas comparten el mismo tipo de coincidencia, la regla con la ruta más larga tiene prioridad. Entre distintos tipos de coincidencia, la prioridad es la siguiente: Equals > Prefix > Regular expression.
Ejemplo de prioridad
La siguiente tabla muestra qué ruta selecciona SAE para algunas solicitudes de ejemplo:
|
Ruta de la solicitud |
Ruta seleccionada |
Motivo |
|
|
|
La coincidencia exacta tiene la mayor prioridad. |
|
|
|
No hay coincidencia exacta; se aplica el prefijo. |
|
|
|
No hay coincidencia exacta ni por prefijo; se aplica la expresión regular. |
Otras condiciones de coincidencia
|
Parámetro |
Descripción |
Ejemplo |
|
Method |
Métodos HTTP para coincidir. Déjelo en blanco para coincidir con todos los métodos. |
|
|
Request header |
Nombre del encabezado, tipo de coincidencia y valor. Cuando varias reglas comparten las mismas condiciones, prevalece la regla con más parámetros de encabezado. |
Nombre: |
|
Request parameter (Query) |
Clave de cadena de consulta, tipo de coincidencia y valor. Cuando varias reglas comparten las mismas condiciones, prevalece la regla con más parámetros de consulta. |
Clave: |
Origen del servicio y backend
Service source
Seleccione el registro de servicios que corresponda al método de registro de su aplicación.
|
Opción |
Cuándo utilizarla |
|
MSE Nacos |
La aplicación usa MSE Nacos para el registro y descubrimiento de servicios. Requiere seleccionar una MSE Nacos instance y un MSE Nacos namespace. |
|
K8s Service |
La aplicación utiliza ServiceNames de Kubernetes. Admite registro y descubrimiento de servicios en múltiples lenguajes, y asigna nombres de dominio fijos para evitar cambios de dirección IP tras el despliegue. |
El origen del servicio debe coincidir con el método de registro y descubrimiento de servicios que utiliza su aplicación.
Escenarios y servicio de backend
|
Parámetro |
Descripción |
Ejemplo |
|
Scenarios |
Single service: dirige todas las solicitudes coincidentes a un solo backend. Multiple services (versión canary): divide el tráfico entre varios backends según un peso asignado. Consulte Overview of routing methods. |
Single service |
|
Backend service |
Aplicación destino, nombre del servicio, protocolo y puerto. Al usar múltiples servicios, la suma de los porcentajes de peso del tráfico debe ser igual a 100%. |
Aplicación: |
Ejemplo de versión canary
En una versión canary (escenario de múltiples servicios), puede dividir el tráfico por porcentaje para validar una nueva versión antes del despliegue completo:
Versión estable (
demo-v1): 90% del tráficoVersión canary (
demo-v2): 10% del tráfico
Una vez que la versión canary sea estable, aumente gradualmente el porcentaje hasta que maneje el 100% del tráfico.
Configuración avanzada
|
Parámetro |
Descripción |
Valor predeterminado |
Ejemplo |
|
Fallback |
Habilite esta opción para especificar un servicio de respaldo. Si no hay ningún nodo saludable disponible para el backend principal, el gateway reenvía las solicitudes al servicio de respaldo. Actualmente solo es compatible entre servicios HTTP. |
Off |
Enabled |
|
Timeout (s) |
Tiempo máximo en segundos que el gateway espera una respuesta del backend. Establezca este valor en |
60 |
|
|
Retries |
Número de intentos de reintento tras una solicitud con errores. Establezca este valor en |
— |
|
|
Retry conditions |
Eventos que desencadenan un intento de reintento. Consulte Configurar una directiva de reintentos. |
— |
|
|
Retry status codes |
Códigos de estado HTTP que desencadenan un reintento. |
— |
|
Gestión de reglas de enrutamiento
Después de crear una ruta, vaya a la página de Gateway Routing para consultar, editar o eliminar rutas de gateway.
Siguientes pasos
Overview of routing methods: aprenda cómo funciona el enrutamiento de servicio único y de servicios múltiples.
Configurar una directiva de reintentos: ajuste el comportamiento de reintentos para sus rutas mediante fine-tune.