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

Углублённый курс Core NATS

Core NATS — основа всех остальных возможностей. Это система публикации и подписки: издатель публикует сообщение в тему, а каждый заинтересованный подписчик получает копию. Здесь нет очереди брокера, хранения и подтверждений. Сообщение получают только те, кто слушает прямо сейчас, и никто другой.

Этой единственной идеи — темы и интереса к ним — достаточно для четырёх шаблонов взаимодействия и общей системы адресации. Глава знакомит с ними так, как вы осваивали бы их при написании кода: сначала один издатель и один подписчик, затем адресация, ответы, балансировка нагрузки и сбор ответов, по одной странице за раз. Начинается глава ещё на шаг раньше — с соединения, которое первым делом открывает каждый клиент. После шаблонов разбираются заголовки сообщений, серверное преобразование тем, жизненный цикл соединения и отладка доставки.

Core NATS не хранит сообщения​

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

Это намеренное поведение. Оно делает Core NATS компактным и быстрым и хорошо подходит, когда каждое сообщение заменяется следующим: текущая цена, температура или уведомление об устаревании кеша.

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

Сквозной сценарий​

Каждая страница развивает один пример: платформу Acme ORDERS на начальном этапе, ещё без долговременного хранения. Сервисы заказов взаимодействуют только через Core NATS.

С заказом происходят три события: создание, отправка и отмена. Каждое представлено сообщением в своей теме:

orders.created
orders.shipped
orders.canceled

Полезная нагрузка — небольшой JSON-объект одинаковой структуры во всех примерах главы:

{
"order_id": "ord_8w2k",
"customer": "acme-co",
"total_cents": 4200,
"ts": "2026-05-22T10:14:22Z"
}

Этими сообщениями интересуются несколько сервисов. Процесс warehouse упаковывает заказ по событию orders.created. Сервис notifications отправляет письмо покупателю при отгрузке. Конвейер analytics подсчитывает все события. Далее появятся региональная аналитика и аудит через шаблоны тем, сервис inventory, отвечающий на запросы, пул packers, распределяющий нагрузку, и три поставщика тарифов доставки, отвечающие на один вопрос.

На протяжении главы используется один локальный nats-server (на двух последующих страницах он перезапускается с флагом или конфигурационным файлом), а подписчики и сервисы добавляются по мере изучения.

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

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

План главы​

СтраницаЧто вы узнаете
ПодключениеОдно долгоживущее соединение на клиента, URL и установление соединения, имена соединений и heartbeat PING/PONG
Публикация и подпискаПубликация без ожидания, подписка и отписка, граф интереса, доставка не более одного раза и лимит полезной нагрузки 1 МБ
Темы и подстановочные символыИерархии тем с точками-разделителями и символы * и > в подписках
Запрос-ответТема ответа _INBOX, тайм-ауты и сигнал отсутствия отвечающих сервисов
Группы очередейБалансировка нагрузки с доставкой каждого сообщения ровно одному участнику группы
Scatter-gatherРассылка одного запроса нескольким сервисам и сбор ответов
Заголовки сообщенийМетаданные «ключ — значение» в формате NATS/1.0, их запись и чтение, коды состояния, передаваемые сервером в том же канале
Преобразование темПерезапись темы на сервере до маршрутизации: переименование, взвешенное разделение трафика и секционирование по хешу сегмента
Жизненный цикл соединенияВлияние разрыва на клиента и сообщения в пути, переподключение силами клиента и обратные вызовы для отслеживания жизненного цикла
Отладка доставкиПоиск причин отсутствия сообщения с помощью перехвата трафика, списка подписок сервера и трассировки
Куда двигаться дальшеПовторение четырёх основных идей и дальнейшие возможности

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

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

  • Один локальный nats-server. Достаточно стандартной сборки: Core NATS не требует флагов. Запустите его командой nats-server.
  • CLI nats, установленный и настроенный на ваш сервер. Каждый пример начинается с CLI; большинство страниц также показывает операции на JavaScript, Go, Python, Java, Rust и C#. Две страницы о серверных возможностях (преобразование тем и отладка доставки) используют только CLI.
  • На странице Преобразование тем сервер запускается с конфигурационным файлом командой nats-server -c server.conf; содержимое файла приведено на странице.
  • Для Отладки доставки нужен порт мониторинга сервера, включаемый командой nats-server -m 8222.

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

Что дальше​

Начните с Подключения: одно долгоживущее соединение, которое клиент открывает перед публикацией или подпиской, обмен сообщениями при его установлении и heartbeat для проверки доступности.

См. также​