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

Отдельный сервер

Любая топология главы состоит из соединённых процессов nats-server. Прежде чем их соединять, рассмотрим один строительный блок.

Сервер — один процесс nats-server. Он принимает соединения, маршрутизирует сообщения и при включённом JetStream хранит их в потоках. На этапе разработки одного процесса достаточно для всей ORDERS.

Здесь мы запустим локальный сервер разработки n1, затем рассмотрим, когда его достаточно и какие ограничения заставят Acme добавить другие.

Простейшее развёртывание​

Связей между серверами пока нет: в центре один сервер, к нему напрямую подключены издатель заказов order-svc и подписчик warehouse.

Клиенты не знают друг друга, только один адрес. Издатель отправляет orders.created, сервер передаёт сообщение подходящим подписчикам. Это вся топология.

Именно так вы работали в главах JetStream и безопасности. Это полноценный допустимый способ запуска NATS.

Запустите сервер разработки​

Создайте конфигурационный файл. Настроек почти не нужно, но несколько полезны с самого начала.

# n1.conf — the development server
server_name: n1
port: 4222
http_port: 8222

jetstream {
store_dir: "./js/n1"
}

server_name — понятное человеку имя. Задайте n1, чтобы узнавать сервер в журналах и мониторинге.

port — клиентский порт. Стандартный 4222 указан явно; адрес клиента — nats://localhost:4222.

http_port включает выключенный по умолчанию мониторинг. Сразу задайте 8222; показатели рассмотрены в Мониторинге.

jetstream включает JetStream и задаёт store_dir. Так n1 сможет хранить ORDERS из предыдущей главы.

Запустите n1 с этой конфигурацией:

nats-server -c n1.conf

В журнале появятся слушатели клиентов 4222 и мониторинга 8222. Один процесс составляет всю систему.

Проверьте доступность:

nats server check connection --server nats://localhost:4222

Исправный сервер отвечает, проверка показывает OK.

Подключитесь и опубликуйте заказ​

При работающем n1 подпишитесь на orders.> в одном терминале:

nats sub "orders.>" --server nats://localhost:4222

В другом подключитесь и опубликуйте заказ ORDERS:

nats pub orders.created '{"order_id":"ord_8w2k","customer":"acme-co","total_cents":4200,"ts":"2026-05-22T10:14:22Z"}' --server nats://localhost:4222

Подписчик выводит заказ:

[#1] Received on "orders.created"
{"order_id":"ord_8w2k","customer":"acme-co","total_cents":4200,"ts":"2026-05-22T10:14:22Z"}

Здесь нет особого кода топологии. Клиент задаёт URL и публикует; та же публикация работает с кластером, суперкластером и листовым узлом.

Установление соединения и аутентификация на уровне протокола описаны в Справочнике → Клиентский протокол. Здесь нужен только URL.

Когда достаточно одного сервера​

Для ряда задач отдельный сервер — правильный выбор.

Прежде всего разработка на ноутбуке или в CI: ничего не нужно согласовывать и ждать.

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

Третий случай — небольшой сервис в одном экземпляре, например внутренняя панель или ночное задание. Если сам сервис — самая уязвимая часть функции, кластеризация брокера не повысит доступность функции без второго экземпляра приложения.

В этих случаях один сервер — соразмерная инфраструктура.

Ограничения одного сервера​

Acme перерастает n1 из-за доступности и вместимости: единственный сервер может отказать и имеет предел ресурсов.

Это единая точка отказа. При завершении процесса или перезапуске машины отключаются все клиенты. Переключаться некуда; маршрутизация ждёт возвращения n1.

Для перечисленных задач это допустимо, но не для системы, где перезапуск при развёртывании не должен прерывать все заказы.

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

Второй предел — ресурсы. Вертикальное масштабирование даёт более мощный CPU, больше RAM и быстрый диск, но предел есть у любой машины. Дальше нужны дополнительные серверы.

Оба ограничения снимает кластер: клиент может перейти на другой сервер, а поток хранит копии на нескольких машинах. Следующая страница создаёт первый кластер Acme east.

Типичные ошибки​

Одна ловушка превращает теоретический предел доступности в конкретную ошибку.

Слишком поздно задуматься об избыточности. Репликацию нельзя просто включить на одном сервере. Запрос трёх реплик ORDERS на n1 отклоняется, поскольку им нужны три сервера:

nats stream add ORDERS --subjects 'orders.*' --storage file --replicas 3 --defaults

Ответ — replicas > 1 not supported in non-clustered mode. Это ограничение топологии, не опечатка. На одном сервере задавайте --replicas 1, понимая, что R1 переживает перезапуск процесса, но не потерю n1. Когда нужно больше, переходите к первому кластеру. Механика R3 описана в Кластеризации и репликации.

Что уже готово​

Текущее развёртывание Acme:

  • Один сервер разработки n1 на 4222, мониторинг на 8222.
  • order-svc публикует orders.* напрямую, а включённый JetStream хранит ORDERS на n1.

Что дальше​

Объединим n1-east, n2-east, n3-east, чтобы при отказе сервера клиент переподключался и продолжал работу: Ваш первый кластер.

См. также​