Architecture Course Home / Дополнительные материалы / Каталог архитектурных шаблонов / Каталог. Сырой список

API Gateway

Описание

Шаблон объединяющий функционал: Gateway Routing, Gateway Offloading, Gateway Aggregation.

Шлюз API предоставляющая единую точку входа для определенных групп микросервисов. 

Таким образом, Шлюз API располагается между клиентскими приложениями и микросервисами. Он выполняет функцию обратного прокси, передавая запросы от клиентов к службам. Также он может предоставлять другие сквозные функции, например аутентификацию, терминацию SSL и кэширование.

Позитивные драйверы

Performance, Security, Scalability, Performance efficiency

Негативные драйверыPerformance, Reliability, Scalability

Преимущества

  • Обратный прокси-сервер. Шлюз API предоставляет обратный прокси-сервер для маршрутизации или перенаправления запросов к конечным точкам внутренних микросервисов. Шлюз предоставляет единую конечную точку (URL-адрес) для клиентских приложений, а внутри сопоставляет запросы от них с конкретными группами внутренних микросервисов. 
  • Большое количество циклических путей. Для одной страницы (экрана) в клиентском приложении может потребоваться несколько вызовов к разным сервисам. Это приводит к созданию нескольких циклических путей по сети между клиентом и сервером, что значительно увеличивает задержку. Объединения на промежуточном уровне позволяют повысить производительность и улучшить взаимодействие с пользователем.
  • Проблемы безопасности. Без шлюза все микросервисы будут доступны извне, что значительно увеличивает зону уязвимости, если не скрыть внутренние микросервисы, не используемые клиентскими приложениями напрямую. Чем меньше уязвимая зона, тем надежнее будет ваше приложение.
  • Проблемы сквозной функциональности. Каждый публичный микросервис должна самостоятельно обрабатывать такие задачи, как авторизация, шифрование SSL, Rate Limiting, Cache. Во многих случаях эти задачи можно вынести на общий уровень, что позволяет упростить внутренние микросервисы.
  • Несовместимые протоколы сообщений. Сервисы могут использовать протоколы обмена сообщениями, которые не работают в Интернете, например AMQP. Шлюз может привести такие запросы к допустимому формату

Недостатки

  • Необходимо продумать кто будет владельцем этого шлюза
  • Наиболее важный недостаток заключается в том, что при реализации шлюза API вы связываете этот уровень с внутренними микросервисами. Такое связывание может привести к серьезным проблемам для вашего приложения. Clemens Vaster, архитектор команды по разработке служебной шины Azure, называет эту потенциальную трудность "новой служебной шиной предприятия (ESB)" в выступлении Messaging and Microservices на GOTO 2016.
  • Использование шлюза API создает возможную дополнительную единую точку отказа.
  • Шлюз API может привести к увеличению времени ответа из-за дополнительного сетевого вызова. Однако этот дополнительный вызов обычно оказывает меньшее влияние, чем целый клиентский интерфейс, который постоянно взаимодействует с внутренними микросервисами.
  • При отсутствии должного масштабирования шлюз API может стать узким местом.
  • Шлюз API требует дополнительных затрат на разработку и последующее обслуживание, если он включает агрегирование данных. Изменения в реализации внутренних микрослужб могут вызвать изменения кода на уровне API шлюза. Тем не менее, если шлюз API просто применяется для безопасности, ведение журналов и управление версиями.
  • Если шлюз API разрабатывается одной командой, это может быть узким местом разработки. Это еще одна причина, по которой лучше использовать несколько специализированных шлюзов API, которые реализуют различные потребности клиента. Также можно внутренне разделить шлюз API на несколько областей или уровней, которые принадлежат разным командам, работающим над внутренними микросервисами.
Полезные ссылки

Сравнение шаблона шлюза API с прямым взаимодействием клиента и микросервисами

Use API gateways in microservices

Проблема

В архитектуре микросервисов клиент может взаимодействовать с более чем одной интерфейсной службой. Учитывая этот факт, как клиент узнает, какие конечные точки вызывать? Что происходит, когда вводятся новые услуги или рефакторинг существующих услуг? Как службы справляются с терминацией SSL, аутентификацией и другими проблемами?

Решение

Используйте шлюз объединяющий в себе: Gateway Routing, Gateway Offloading, Gateway Aggregation.

При этом следует строго разделять инфраструктурный апи шлюз включающей в себя: Gateway Routing, Gateway Offloading и агрегирующий апи шлюз, реализующий Gateway Aggregation.

При реализации второго следует соблюдать осторожность. Обычно не рекомендуется иметь один шлюз API, который агрегирует все внутренние микросервисы вашего приложения. Такой шлюз выступает в качестве монолитного агрегатора или оркестратора и нарушает автономность микросервисов, связывая все микросервисы друг с другом.

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

Оригинал на wiki