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

Куда двигаться дальше

Вы начали с одного соединения и публикации orders.created без уверенности в наличии подписчиков. Теперь notifications и analytics читают orders.created, региональная аналитика — orders.*.created, аудит — orders.>, сервис inventory отвечает на orders.inventory.check, группа packers делит работу orders.created, а три поставщика shipping.quote отвечают на запрос scatter-gather. Вся платформа Acme ORDERS построена только на Core NATS.

Здесь нет новых понятий: страница собирает освоенную модель и направляет к следующим главам и справочнику.

Четыре основные идеи​

Все шаблоны главы опираются на четыре идеи.

Тема — адрес. Издатель публикует в тему, не называя получателя. Тема — единственное соглашение издателя и подписчика, а подстановочные символы позволяют подписке охватить всю иерархию.

Интерес приводит сообщение в движение. Сервер хранит в памяти граф нужных подписчикам тем; публикация направляется всем заинтересованным либо отбрасывается, если их нет. Без интереса копий и записей не создаётся.

Тема ответа превращает одностороннюю публикацию в двусторонний обмен. Клиент подписывается на уникальную _INBOX, передаёт её с запросом, а сервис публикует туда ответ. Тот же механизм возвращает no responders при отсутствии отвечающего подписчика.

Группа очереди распределяет нагрузку одной темы между подписчиками. Сервер выбирает ровно одного участника на сообщение без отдельного брокера очередей или координатора.

Четыре идеи — тема, интерес, тема ответа и группа очереди. Scatter-gather не является пятой: это тема ответа без остановки на первом результате, со сбором всех ответов. Все шаблоны Core NATS — разные сочетания этих механизмов.

Что Core NATS не хранит​

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

Углублённый курс JetStream добавляет серверное хранилище поверх тех же тем. Начните с Зачем нужен поток: там история Acme ORDERS продолжается с этого места.

Где искать точные сведения​

Глава не привязана к версии и объясняет понятия. Точные флаги, значения по умолчанию и кадры PUB/SUB/MSG см. в Справочник → Клиентский протокол и основном справочнике.

Смежные углублённые курсы​

Core NATS — фундамент. Другие главы напрямую используют четыре освоенных механизма.

Курс по сервисам объединяет запрос-ответ и группы очередей во фреймворк с обнаружением, версиями и встроенными метриками. Если вы вручную создаёте много отвечающих приложений, читайте его следующим. Начните с первого сервиса.

Курс по устойчивым клиентам продолжает Жизненный цикл соединения. Он настраивает восстановление для промышленной эксплуатации: интервалы и лимиты повторов, размер буфера, корректный drain и работу с медленным потребителем. Страницы о переподключении и медленных потребителях важны сразу после выхода за пределы одного локального сервера.

Курс по топологиям объясняет распространение графа интереса из публикации и подписки между кластерными и географически разделёнными серверами. Сюда входит предпочтение локального участника группы между регионами — см. Суперкластеры.

Курс по безопасности определяет, кому разрешено публиковать и подписываться на темы. Иерархия из Тем и подстановочных символов также служит единицей разрешений: вы защищаете ту же адресацию, которую проектируете.

Что уже сделано​

Это конец главы; новых изменений сценария здесь нет. Локальный nats-server, подписчики notifications и analytics, региональная аналитика, аудит, сервис inventory, группа packers и поставщики shipping.quote остаются в прежнем состоянии. Экспериментируйте дальше или остановите сервер: Core NATS ничего не сохранял на диск, очищать нечего.

Что дальше​

Главный следующий раздел — углублённый курс JetStream: возможности поверх Core NATS, когда сообщения должны сохраняться. История Acme ORDERS продолжается с текущего места.

Проверка перед промышленной эксплуатацией​

Подводные камни главы сведены в один список. Проверьте его до подключения сервиса Core NATS к реальному трафику. Каждая группа ссылается на объяснение.

Подключение — см. Подводные камни​

  • Открывайте одно соединение на процесс и используйте совместно; не подключайтесь для каждого сообщения или запроса.
  • Заранее определите echo: публикующий и подписанный на тему сервис получает собственные сообщения, если не отключить echo при подключении.

Публикация и подписка — см. Подводные камни​

  • Узнайте серверный max_payload и соблюдайте лимит; большие данные передавайте ссылкой.
  • Перед завершением короткоживущего издателя выполняйте flush или drain, чтобы буфер дошёл до сервера.
  • Обрабатывайте сообщения достаточно быстро или передавайте обработчику, чтобы медленный подписчик не отключался.

Темы и подстановочные символы — см. Подводные камни​

  • Ставьте > только последним сегментом; для произвольного среднего используйте *.
  • Публикуйте в полную конкретную тему, никогда «в шаблон».
  • Подписывайтесь на самый узкий подходящий шаблон вместо общего orders.>.
  • Исключайте пробельные символы и избегайте префиксов $ и _INBOX.

Запрос-ответ — см. Подводные камни​

  • Задавайте каждому запросу тайм-аут с учётом обработки и сетевого обмена.
  • Отличайте no responders от тайм-аута.
  • Явно собирайте ответы, если их может быть несколько.
  • Держите путь ответа быстрым или распределяйте сервисы через группу очереди.

Группы очередей — см. Подводные камни​

  • Используйте побайтно одинаковое имя группы у всех участников.
  • Не ожидайте порядка и равного распределения; строго последовательную работу оставляйте одному подписчику.
  • Обеспечьте безопасную повторную обработку: Core NATS не повторяет доставку после передачи участнику.

Scatter-gather — см. Подводные камни​

  • Собирайте ответы циклом вместо получения первого.
  • Ограничивайте сбор сроком, чтобы отсутствие сервиса стоило лишь тайм-аута.
  • Рассматривайте результат как неупорядоченный набор; оценивайте содержание, а не порядок прихода.

Заголовки сообщений — см. Подводные камни​

  • Учитывайте регистр ключей и читайте в точности заданное написание.
  • Включайте размер заголовков в max_payload; большие данные храните в теле.

Преобразование тем — см. Подводные камни​

  • Проверяйте каждое правило через nats server mappings перед применением.
  • Сводите сумму весов назначений к 100, если не планируете отбрасывать долю.
  • Считайте число секций частью контракта: его изменение перераспределяет ключи.

Жизненный цикл соединения — см. Подводные камни​

  • Сначала подключайте callbacks disconnect, reconnect и async error; ограничивайте их записью в журнал или сигналом.
  • Записывайте разрыв в disconnect handler и каждую неудачную попытку в callback ошибок переподключения.
  • Рассматривайте буфер как временную память клиента, а не гарантию доставки.

Отладка доставки — см. Подводные камни​

  • Не оставляйте перехват > работающим на промышленном трафике.
  • Помните: nats trace отправляет собственное тестовое сообщение и не доказывает доставку прежнего.
  • Не открывайте порт мониторинга в публичной сети: он отвечает без аутентификации.

См. также​