Dejemos que los microservicios ya no se "pierdan": fragmentos de código reales e historias de aplicaciones de puertas de enlace API

¿Alguna vez se ha encontrado con esta situación: cada vez hay más microservicios en la empresa, cada servicio tiene su propia interfaz y dirección, y llamarlo es como encontrar la salida a un laberinto? Por un tiempo, el servicio A necesita llamar a los datos de B y, por un tiempo, C tiene que encontrar D para verificar los permisos. El simple hecho de mantener estas relaciones de llamadas es un dolor de cabeza. Por no hablar del control de seguridad. ¿No puede cada servicio tener su propio conjunto de verificación de identidad?

Por eso tenemos que hablar de puertas de enlace API.

Imagínese si la arquitectura de microservicios es una fiesta animada, entonces la puerta de enlace API es la recepcionista en la puerta. Es responsable de verificar la lista de invitados (verificación de identidad), guiar a los invitados a la habitación correcta (solicitud de ruta), controlar el ritmo de admisión (limitación actual) y registrar quién entra y quién sale (monitoreo de registro). Sin él, el partido puede caer fácilmente en el caos.

¿Cómo se ve en el código?

Un ejemplo simple de configuración de enrutamiento de puerta de enlace

Suponiendo que esté utilizando Spring Cloud Gateway (que es bastante común en el ecosistema Java), una configuración de enrutamiento básica podría verse así:

@Bean public RouteLocator customRouteLocator(RouteLocatorBuilder builder) { return builder.routes() .route("product_service", r -> r .path("/api/products/**") .filters(f -> f .addRequestHeader("X-Request-Source", "gateway") .circuitBreaker(config -> config .setName("productCB") .setFallbackUri("forward:/fallback/product"))) .uri("lb://PRODUCT-SERVICE")) .route("order_service", r -> r .path("/api/orders/**") .uri("lb://ORDER-SERVICE")) .build(); }

¿Qué hace este código? Le dice a la puerta de enlace: Todas las solicitudes que comienzan con /api/products/ se reenvían al servicio denominado PRODUCTO-SERVICIO. Por cierto, se agrega un encabezado de solicitud y se configuran disyuntores y degradaciones; en caso de que el servicio del producto no pueda responder temporalmente, se transferirá al plan de respaldo. El enrutamiento del servicio de pedidos es más sencillo y se reenvía directamente.

Verá, con solo unas pocas líneas, las personas que llaman externamente no necesitan saber cuántos microservicios hay y en qué dirección IP viven. Solo necesitan mirar hacia la puerta de enlace.

Los beneficios son reales

Alguien puede preguntar: ¿Agregar una capa adicional hará que el sistema sea más lento? De hecho, siempre hay algunos gastos generales con un enlace más. Pero en comparación con los beneficios que aporta, el coste suele merecer la pena.

Por ejemplo, seguridad. En lugar de implementar la verificación JWT repetidamente en cada servicio, deje que la puerta de enlace la maneje de manera uniforme:

# Un ejemplo de configuración de filtros de filtro de puerta de enlace: - nombre: JwtAuthFilter args: secretKey: "tu-clave-secreta-aquí" exclusionPaths: - "/api/public/login" - "/health"

Ahora, a excepción de las dos interfaces públicas de inicio de sesión y verificación de estado, todas las demás solicitudes deben pasar primero la verificación del token. Cuando quieras modificar las reglas de verificación, solo necesitas cambiar este lugar.

Otro ejemplo es el seguimiento. Cuando todo el tráfico pasa por la puerta de entrada, de repente tienes un punto de observación ideal. ¿Qué interfaces se llaman con más frecuencia? ¿Cuál es el tiempo promedio de respuesta? ¿Hay alguna anomalía en la tasa de error? Estos datos se recopilan a nivel de puerta de enlace, lo cual es mucho más conveniente que ir a cada servicio para recuperar registros.

También hay gestión de versiones. Cuando desee actualizar la API de un determinado servicio pero no pueda hacer que todas las personas que llaman la cambien de inmediato, puede hacer un escándalo en la puerta de enlace: dirija el tráfico a diferentes versiones de instancias de servicio según el número de versión en el encabezado de la solicitud. Los usuarios antiguos continúan usando la interfaz anterior, mientras que los nuevos usuarios disfrutan de nuevas funciones y la transición es fluida.

¿A qué debes prestar atención al elegir?

Hay muchas opciones de puertas de enlace API en el mercado. ¿Cómo elegir? No creo que sea necesario realizar las funciones más completas. La clave es si estas cosas son convenientes:

En primer lugar, la pérdida de rendimiento debe estar dentro de un rango aceptable. Una buena puerta de enlace debe encontrar un equilibrio entre funcionalidad adicional y latencia introducida. En segundo lugar, la configuración debe ser lo suficientemente flexible. Al igual que en el ejemplo de código anterior, las reglas de enrutamiento se pueden definir mediante configuración o código para adaptarse a los hábitos de diferentes equipos. En tercer lugar, la información de seguimiento debe ser detallada. Cuando algo sale mal, debe poder determinar rápidamente si se trata de una falla en la puerta de enlace o de uno de los servicios detrás de ella.

Su compatibilidad con su conjunto de tecnologías existente también es importante. Si sus microservicios están escritos principalmente en Go, puede resultar más práctico elegir una puerta de enlace que sea compatible con Go y que tenga un buen soporte comunitario.

Algunas consideraciones durante el despliegue real

Hablar por escrito es, en última instancia, superficial. Para usarlo realmente, debes pensar en algunos detalles de antemano.

Por ejemplo, ¿qué debo hacer si la propia puerta de enlace se convierte en un único punto de falla? Simple, implemente algunas instancias más y agregue equilibrio de carga al frente. Para poner otro ejemplo, ¿cómo se puede actualizar la configuración sin reiniciar el servicio? Algunas puertas de enlace admiten la configuración de actualizaciones en caliente. Cambiar las reglas de enrutamiento no requiere reiniciar el proceso, lo cual es muy amigable para los servicios en línea.

El registro también debe diseñarse cuidadosamente. ¿Qué registros debe mantener la puerta de enlace? Demasiado afectará el rendimiento, muy poco será perjudicial para la resolución de problemas. Por lo general, los metadatos de la solicitud y la respuesta (hora, ruta, código de estado, IP del cliente) son necesarios, pero para contenido potencialmente grande como el cuerpo de la solicitud, debe elegir con cuidado, tal vez solo registrar el cuerpo de la solicitud de una ruta específica o solo una muestra del registro.

También existe el almacenamiento en caché. Algunos resultados de solicitudes de consulta no cambiarán en un corto período de tiempo y pueden almacenarse en caché en la capa de puerta de enlace y devolverse directamente para reducir la presión sobre los servicios de back-end. Pero qué interfaces son adecuadas para el almacenamiento en caché y durante cuánto tiempo deben permanecer en caché dependen de las características del negocio.

se honesto

La arquitectura de microservicios es como un arma de doble filo. Dividirlo en pequeños servicios hace que el desarrollo y la implementación sean más flexibles, pero también aumenta la complejidad de la gestión. La puerta de enlace API es como la "recepción" de este complejo sistema. No maneja el negocio principal, pero sin él, será difícil que todo el sistema funcione correctamente.

Comenzando con unas pocas líneas de configuración de enrutamiento y agregando lentamente capacidades de seguridad, monitoreo y limitación actual, encontrará que este rol de "recepcionista" se está volviendo cada vez más importante. Permite que los servicios backend hagan lo que mejor saben hacer sin tener que lidiar con preocupaciones transversales.

Eso es lo que debería ser una buena herramienta: fácil de usar, no complicada y útil en los momentos críticos. Probablemente puedas apreciar esto cuando ya no tengas que preocuparte por los detalles complicados de llamar a servicios durante todo el día.

Establecido en 2005,kpotenciase ha dedicado a un fabricante profesional de unidades de movimiento compacto, con sede en Dongguan, provincia de Guangdong, China. Aprovechando las innovaciones en la tecnología de accionamiento modular,kpotenciaintegra motores de alto rendimiento, reductores de precisión y sistemas de control multiprotocolo para proporcionar soluciones de sistemas de accionamiento inteligentes eficientes y personalizadas.kpotenciaha entregado soluciones de sistemas de accionamiento profesionales a más de 500 clientes empresariales en todo el mundo con productos que cubren diversos campos, como sistemas domésticos inteligentes, electrónica automática, robótica, agricultura de precisión, drones y automatización industrial.