Сервисы
В главе 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 и переходите к следующей странице.
См. также
- Core NATS → Запросы и ответы — механизм, на котором построен каждый сервис.
- Core NATS → Группы очередей — балансировка нагрузки, которую сервис получает автоматически.
- Концепции → Что такое NATS — пятиминутный обзор всей системы.