Перейти к основному содержимому

Сервисы

В главе Core NATS вы написали обработчик запросов вручную. Он подписывался на субъект, читал каждый запрос и отправлял ответ. Это работает, но такой обработчик — лишь функция, доступная по сети. У него нет имени для поиска и версии. Нельзя узнать, сколько копий запущено, и нет встроенного счётчика обработанных запросов.

Фреймворк сервисов устраняет этот пробел. В некоторых клиентских библиотеках (Go, Python) его модуль называется micro, в других (JavaScript, Java, Rust, C#) — service/services; идея везде одинакова. Он превращает знакомый обработчик запросов и ответов в сервис: именованный обработчик с версией, который можно обнаружить через сервер, который сообщает свою статистику и распределяет нагрузку между любым числом запущенных копий. Новая инфраструктура не нужна. В основе сервиса остаётся обмен запросами и ответами; фреймворк связывает его части за вас.

В этой главе обработчик inventory из Core NATS становится полноценным сервисом OrderInventory и развивается от страницы к странице. Полезная нагрузка заказа, субъекты и один локальный сервер остаются прежними, но обработчик теперь окружён фреймворком.

Что получится к концу главы​

  • Сервис OrderInventory версии 1.0.0, отвечающий на orders.inventory.check через именованную конечную точку в группе очереди по умолчанию "q".
  • Второй сервис ShippingQuote, показывающий, как один процесс может обслуживать несколько конечных точек и объединять их общим префиксом субъектов.
  • Возможность обнаруживать оба сервиса через субъекты $SRV: узнавать, какие сервисы присутствуют, какие конечные точки они предоставляют и какова их текущая статистика.
  • Статистика каждой конечной точки, доступная в любой момент: число обработанных запросов, число ошибок и время обработки.
  • Два или более экземпляра OrderInventory, между которыми группа очереди распределяет запросы без координатора.

Для кого эта глава​

Вы прочитали подробную главу о Core NATS либо уже знакомы с запросами и ответами и группами очередей. Эта глава не объясняет эти механизмы заново, а непосредственно опирается на них: сервис — обработчик запросов и ответов, а балансировка нагрузки по умолчанию обеспечивается группой очереди. Если речь идёт об одном из этих базовых механизмов, страница называет его и даёт ссылку на объяснение.

Знание самого фреймворка micro не требуется. Начнём с того, что он добавляет к обычному обработчику, и будем двигаться дальше.

Сервис ничего не хранит: отвечает на запрос и не оставляет о нём записи. Такова доставка не более одного раза при обмене запросами и ответами. Если работа должна пережить перезапуск или повторяться при сбое, нужен слой долговременного хранения из подробной главы о JetStream. По ходу главы мы будем обозначать эту границу.

Как читать главу​

Каждая страница вводит не более двух новых понятий и продолжает тот же сеанс Acme ORDERS. Вы оставляете сервис OrderInventory работающим и по ходу главы добавляете конечную точку, второй сервис, запрос обнаружения, запрос статистики и второй экземпляр. Один терминал можно держать открытым на протяжении всей главы.

Фреймворк предоставляет множество полей конфигурации: все параметры конечных точек, наборы метаданных, полный сетевой формат обнаружения. Если у возможности длинный список параметров, страница объясняет только необходимое поведение и направляет в справочник за полным перечнем.

Содержание​

СтраницаЧто вы узнаете
Первый сервисСоздание OrderInventory с одной конечной точкой и контракт обработчика
Конечные точки и группыНесколько конечных точек в одном сервисе и их объединение префиксом субъектов
ОбнаружениеТри команды $SRV (PING, INFO, STATS) и почему обнаружение широковещательное
НаблюдаемостьЧтение статистики конечных точек и возврат ошибки сервиса
МасштабированиеЗапуск N экземпляров и балансировка нагрузки группой очереди
Куда двигаться дальшеВозможности за пределами этой главы

Предварительные требования​

Вам понадобятся:

  • Один локальный nats-server. Фреймворк сервисов не требует специальных настроек: он использует обычные запросы и ответы, поэтому достаточно стандартного nats-server. Топология рассматривается отдельно в подробной главе о топологиях.
  • Установленный CLI nats, подключённый к вашему серверу. CLI позволяет напрямую отправлять запросы сервисам, получать их список и просматривать сведения; в примерах он используется для управления работающим сервисом и наблюдения за ним. Создание самого сервиса, добавление конечных точек и написание обработчиков выполняются через клиентскую библиотеку. При разработке используйте библиотеку для JavaScript, Go, Python, Java, Rust или C#.
  • Знакомство с запросами и ответами и группами очередей. Фреймворк опирается на оба механизма.

Откройте терминал, запустите nats-server и переходите к следующей странице.

См. также​