Это третий пост из моей серии о микросервисах, в которой я рассказываю о своих впечатлениях от этого архитектурного стиля с использованием Java с Spring Boot.

Полный цикл статей приведен ниже:

• Часть I : Настройка проекта, REST связь и обнаружение сервисов
• Часть II : отказоустойчивость и сервер конфигурации
• Часть III: API-шлюз и централизованные журналы
• Часть IV: Аутентификация и авторизация ( это еще в моем списке TODO .. :-P)

В этой статье мы реализуем API-шлюз и решение для централизованного журнала, снова используя практический подход с использованием среды Java и Spring Boot.

Код этой статьи доступен на GitHub в ветке ch-03 .

API-шлюз

Очень распространенный шаблон, используемый в микросервисах, - это реализация шлюза API, который является единой точкой входа для всех клиентов. Это становится первым уровнем доступа к сервису, который может быть предоставлен одним или несколькими микросервисами. Некоторые запросы просто перенаправляются в соответствующую службу, в то время как другие должны обращаться к нескольким службам.

Некоторые преимущества этого шлюза API:

• Единая точка входа в API : инкапсулирует внутреннюю архитектуру системы, абстрагируя внутренние детали от клиентов. Он может предоставлять персонализированный API для некоторых клиентов (также известный как «Backends for Frontend»);
• Обеспечивает лучшее управление версиями и развитие API : позволяет проводить рефакторинг и настройку микросервисов, которые предоставляют сервис, лежащий в основе API, без воздействия на клиентов;
• Обеспечивает большую безопасность : шлюз может обеспечивать аутентификацию и порог использования для каждого клиента. Этот дополнительный уровень также может предоставлять механизмы для предотвращения злонамеренных атак, например, таких как DoS и SQLInjection.
• Позволяет отслеживать использование : можно отслеживать и управлять запросами и ответами, обеспечивая лучший баланс нагрузки, кеширование, выставление счетов и статистику использования API.

Предполагаемая архитектура в примере этой серии статей, включая API Gateway, будет такой:

Вернемся к коду, давайте настроим новый проект в качестве шлюза API с использованием Spring Cloud Gateway, поскольку это рекомендуемая библиотека в новых версиях Spring Boot (Zuul устарела):

Полный файл pom.xml этого проекта можно увидеть здесь .

Теперь нам нужно обратиться к маршрутам в файле application.yml . Обратите внимание, что каждый сопоставленный маршрут в шлюзе адресован соответствующему микросервису:

spring:
  application:
    name: API-GATEWAY
  cloud:
    gateway:
      routes:
        - id: PRODUCT-CATALOG-SERVICE
          uri: lb://PRODUCT-CATALOG-SERVICE
          predicates:
            - Path=/api/product/**
        - id: USER-INFORMATION-SERVICE
          uri: lb://USER-INFORMATION-SERVICE
          predicates:
            - Path=/api/user/**
        - id: SHOPPING-CART-SERVICE
          uri: lb://SHOPPING-CART-SERVICE
          predicates:
            - Path=/api/cart/**

server:
  port: 8085

Итак, после запуска всех сервисов мы можем сделать прямой запрос к микросервисам корзины покупок , каталога продуктов или информации о пользователе , или мы можем вызвать их через API-шлюз (обратите внимание на порт шлюза 8085), который будет перенаправлен на каждая запрашиваемая услуга:

Централизованное управление журналами

По мере роста количества микросервисов становится все труднее и труднее управлять журналами каждого из них и отслеживать некоторые запросы / ответы.

Чтобы лучше отслеживать запросы, мы можем использовать сервер Zipkin и Spring Cloud Sleuth .

Это решение предоставляет « TraceId », который является уникальным идентификатором запроса, и « SpanId », который представляет каждую службу, которой достиг запрос.

Журнал будет выглядеть так:

[SERVICE-NAME,trace-id,span-id]

Сгенерированные журналы и идентификаторы могут быть отправлены на сервер Zipkin, где можно искать и отслеживать каждый запрос по многим параметрам.

Прежде всего, нам нужен запущенный Zipkin-сервер. Мы можем скачать его с этого сайта (я решил загрузить версию jar и запустить ее с помощью java -jar….):

Теперь нам нужно добавить зависимость zipkin и sleuth в каждый микросервис:

<dependency>
   <groupId>org.springframework.cloud</groupId>
   <artifactId>spring-cloud-starter-sleuth</artifactId>
</dependency>
<dependency>
   <groupId>org.springframework.cloud</groupId>
   <artifactId>spring-cloud-sleuth-zipkin</artifactId>
</dependency>

spring:
  // ... omitted configs ...
  zipkin:
    base-url: http://127.0.0.1:9411/

После запуска всех микросервисов и выполнения некоторого запроса (например, POST в конечной точке корзины покупок ) мы можем отследить запрос на странице Zipkin, используя некоторые критерии, такие как 'имя-службы', например:

И страница результатов должна выглядеть так:

Где вы можете подробнее узнать о запросе:

Ресурсы и дополнительная литература:

• API-шлюз
• Домашняя страница Zipkin
• Проекты на GitHub