Cuando un gateway nativo de la nube recibe una solicitud, evalúa las reglas de enrutamiento configuradas desde la prioridad más alta hasta la más baja. El gateway reenvía la solicitud al servicio de destino configurado en la primera regla que coincida con dicha solicitud. Si ninguna regla coincide, el gateway devuelve el código de estado HTTP 404.
Requisitos previos
Una instancia de gateway nativo de la nube existente.
Un nombre de dominio existente para que la ruta coincida, o bien un nombre de dominio que se crea durante la configuración de la ruta.
Un origen de servicio existente que proporcione el servicio de backend de la ruta.
Límites
A continuación se describen los límites aplicables al crear una ruta:
Orígenes de servicio: si Source Type está establecido en MSE Nacos o MSE Zookeeper, solo se permite agregar un origen. Si Source Type está establecido en Container Service, se pueden agregar hasta cinco orígenes. Si Source Type está establecido en EDAS Built-in Registry o SAE Built-in Registry, no hay límite en la cantidad de orígenes.
Pesos de tráfico: la suma de los porcentajes de tráfico de los servicios de destino que utilizan pesos debe ser igual a 100 %.
Fallback: esta función solo es compatible entre servicios HTTP.
Procedimiento
Inicie sesión en la consola de MSE. En la barra de navegación superior, seleccione una región.
En el panel de navegación izquierdo, vaya a Cloud-native Gateway > Gateways. En la página Gateways, haga clic en el ID del gateway.
En el panel de navegación izquierdo, haga clic en Routes. En la pestaña Routes, haga clic en Add Route.
En la página Add Route, configure los parámetros descritos en Route parameters y luego haga clic en Save.
Parámetros de ruta
La siguiente tabla describe los parámetros que se configuran al crear una ruta.
|
Parámetro |
Descripción |
|
Route Name |
Nombre personalizado para la ruta. También puede hacer clic en Add Description para agregar una descripción de la ruta. |
|
Domain Name |
Seleccione los nombres de dominio con los que desea que coincida la ruta. Es posible seleccionar varios nombres de dominio. Para crear uno nuevo, haga clic en Add Domain Name y créelo en el panel que aparece. |
|
Match Rule |
Las reglas de coincidencia se combinan mediante un operador lógico AND. Cuantas más reglas especifique, menor será el rango de solicitudes que coincidan. Para obtener más información sobre cómo se clasifican las reglas de coincidencia, consulte Route matching priorities. |
|
Path |
Especifique el parámetro Path que se utiliza para coincidir con las solicitudes HTTP. Si varias rutas usan la misma regla de coincidencia, la prioridad aumenta conforme crece la longitud del valor de Path. Si las rutas usan reglas distintas, la prioridad es la siguiente: Equal To > Prefix > Regular Expression Match. Equal To: coincidencia exacta; por ejemplo, el valor de Path es igual a |
|
Method |
Especifique el parámetro Method que se utiliza para coincidir con las solicitudes HTTP. Puede seleccionar varios métodos HTTP. El valor predeterminado es ANY. |
|
Header |
Especifique el parámetro Header que se utiliza para coincidir con las solicitudes HTTP. Si varias rutas usan la misma regla de coincidencia, la prioridad aumenta conforme crece el número total de pares clave-valor. |
|
Query Parameters |
Especifique el parámetro Query que se utiliza para coincidir con las solicitudes HTTP. Si varias rutas usan la misma regla de coincidencia, la prioridad aumenta conforme crece el número total de pares clave-valor. |
|
Scenario |
Seleccione el tipo de servicio de destino para la ruta actual. Escenarios básicos: Single Service. Escenarios de versión canary: Multiple Services y Tag-based Routing. Otros escenarios: Mock y Redirect. Para obtener más información sobre los tipos de servicios de destino, consulte Routing modes. |
|
Backend Service |
Seleccione un servicio de backend asociado y un puerto. Haga clic en Associate Service para elegir un origen y un servicio en el panel que aparece. La cantidad de orígenes que puede agregar varía según el tipo de origen. Para más detalles, consulte Limits. |
|
Fallback |
Especifique un servicio de respaldo según sus necesidades empresariales. Si ningún nodo está disponible para el servicio de backend al que apunta la ruta, la solicitud original accederá al servicio de respaldo que especifique aquí. |
|
Timeout Period (s) |
Introduzca un periodo de tiempo de espera. El valor predeterminado es 60 segundos. Un valor de 0 indica que la solicitud nunca caduca. |
|
Number of Retries (times) |
Introduzca el número de reintentos. El valor predeterminado es 2. Un valor de 0 deshabilita los reintentos. |
|
Retry Conditions |
Seleccione las condiciones de reintento. |
|
Retry Status Code |
Agregue uno o más códigos de estado de reintento. |
Prioridades de coincidencia de rutas
Si existen múltiples reglas de enrutamiento, estas se ordenan de mayor a menor prioridad siguiendo este criterio: Domain Name > Path > request header > Query Parameters > Created At. Se aplican las siguientes reglas:
Domain Name: cuanto más larga sea la cadena del nombre de dominio, mayor será la prioridad.
-
Path:
Si la Match Rule es diferente, la prioridad es la siguiente: Equal To > Prefix > Regular Expression Match.
Si la Match Rule es la misma, la prioridad aumenta conforme crece la longitud de la cadena de Path.
Header: cuanto mayor sea el número total de pares clave-valor, mayor será la prioridad.
Query Parameters: cuanto mayor sea el número total de pares clave-valor, mayor será la prioridad.
Hora de creación: cuanto antes se haya creado la ruta, mayor será su prioridad.
La prioridad de coincidencia de las rutas corresponde al orden en que se muestran en la página de configuración de rutas.
Referencias
Puede modificar las reglas de enrutamiento en cualquier momento según sus escenarios reales y requisitos cambiantes. Para consultar las instrucciones, vea Modify a routing rule.