# Сервисы

В главе 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](/learn/core-nats/.md) либо уже знакомы с [запросами и ответами](/learn/core-nats/request-reply.md) и [группами очередей](/learn/core-nats/queue-groups.md). Эта глава не объясняет эти механизмы заново, а непосредственно опирается на них: сервис — обработчик запросов и ответов, а балансировка нагрузки по умолчанию обеспечивается группой очереди. Если речь идёт об одном из этих базовых механизмов, страница называет его и даёт ссылку на объяснение.

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

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

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

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

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

## Содержание

| Страница                                                           | Что вы узнаете                                                                |
| ------------------------------------------------------------------ | ----------------------------------------------------------------------------- |
| [Первый сервис](/learn/services/your-first-service.md)             | Создание `OrderInventory` с одной конечной точкой и контракт обработчика      |
| [Конечные точки и группы](/learn/services/endpoints-and-groups.md) | Несколько конечных точек в одном сервисе и их объединение префиксом субъектов |
| [Обнаружение](/learn/services/discovery.md)                        | Три команды `$SRV` (PING, INFO, STATS) и почему обнаружение широковещательное |
| [Наблюдаемость](/learn/services/observability.md)                  | Чтение статистики конечных точек и возврат ошибки сервиса                     |
| [Масштабирование](/learn/services/scaling.md)                      | Запуск N экземпляров и балансировка нагрузки группой очереди                  |
| [Куда двигаться дальше](/learn/services/where-next.md)             | Возможности за пределами этой главы                                           |

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

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

* Один локальный `nats-server`. Фреймворк сервисов не требует специальных настроек: он использует обычные запросы и ответы, поэтому достаточно стандартного `nats-server`. Топология рассматривается отдельно в [подробной главе о топологиях](/learn/topologies/.md).
* Установленный CLI `nats`, подключённый к вашему серверу. CLI позволяет напрямую отправлять запросы сервисам, получать их список и просматривать сведения; в примерах он используется для управления работающим сервисом и наблюдения за ним. Создание самого сервиса, добавление конечных точек и написание обработчиков выполняются через клиентскую библиотеку. При разработке используйте библиотеку для JavaScript, Go, Python, Java, Rust или C#.
* Знакомство с [запросами и ответами](/learn/core-nats/request-reply.md) и [группами очередей](/learn/core-nats/queue-groups.md). Фреймворк опирается на оба механизма.

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

## См. также

* [Core NATS → Запросы и ответы](/learn/core-nats/request-reply.md) — механизм, на котором построен каждый сервис.
* [Core NATS → Группы очередей](/learn/core-nats/queue-groups.md) — балансировка нагрузки, которую сервис получает автоматически.
* [Концепции → Что такое NATS](/concepts/what-is-nats.md) — пятиминутный обзор всей системы.
