Углублённый курс 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 для проверки доступности.
См. также
- Основные понятия → Публикация и подписка — пятиминутный обзор той же темы.
- Углублённый курс JetStream — слой долговременного хранения, который не рассматривается в этой главе.