Куда двигаться дальше
В начале у клиентов был один URL без имени и плана отказа. Теперь order-svc использует пул, backoff/jitter, drain, ограничение памяти, безопасные запросы и проверенный TLS с creds.
Нового материала нет: соберём модель и дальнейшие ссылки.
Основная модель
Все страницы безопасно переводили один объект — соединение — между состояниями.
Это автомат DISCONNECTED, CONNECTING, CONNECTED, RECONNECTING, DRAINING, CLOSED. Отказ сервера ведёт к восстановлению, SIGTERM — drain/close, зависший dial ждёт тайм-аут CONNECTING.
Подключение научило CONNECTING → CONNECTED, восстановление — CONNECTED → RECONNECTING → CONNECTED. События сделали переходы наблюдаемыми. Drain — безопасный выход. Медленные потребители ограничили память, request/reply — неудачные ответы, TLS/Auth — защищённый вход.
Шесть механизмов действуют на одном автомате, события делают его видимым. Имена опций и стандарты уточняют эти переходы.
Где искать подробности
Версионируемый справочник описывает протокол, -ERR и сервер. Типы, имена и значения клиентских опций — в API библиотеки.
Здесь лишь поведение при сбоях; полные ошибки сервера и клиентские параметры смотрите соответственно там.
Связанные главы
За границей клиента материал разделён:
Топологии объясняют n1/n2/n3, в исходной главе n1-east/n2-east/n3-east, причины отказов и серверный взгляд.
JetStream и Подтверждения сохраняют позицию и определяют повторы после восстановленной подписки.
Безопасность выпускает загружаемые creds и CA.
Сервисы формализуют responder через имена, обнаружение, метрики endpoints и очереди.
Мониторинг наблюдает серверные slow_consumers, уведомления и здоровье.
Что уже готово
Прежние order-svc, warehouse, notifications, analytics и потребители продолжают работу с настроенными соединениями. Новых изменений здесь нет.
Соединение — автомат, сбой — переход, настройка управляет им. Это основа эксплуатации клиентов NATS.
Контрольный список перед эксплуатацией
Последняя проверка перед реальными заказами:
Подключение — см. Типичные ошибки
- Несколько URL или IP вместо единственной точки.
- Обязательные адреса заданы явно; discovery — дополнение при достижимом объявлении.
- Осознанный connect timeout.
- Сообщения меньше max_payload, большие данные отдельно; это не ошибка связи.
Переподключение — см. Типичные ошибки
- MaxReconnect=-1 для длительных Go/Java/Python/JS; Rust/C# уже бесконечны.
- Журнал reconnect error.
- При повторе первого входа тревога на длительный RECONNECTING после развёртывания.
- Ненулевая задержка и jitter.
- Обрабатывайте заполнение: стандарт Go/Java 8 МБ, Python 2 МБ; Go ErrReconnectBufExceeded, Rust обратное давление.
- При необходимости уменьшите PING: стандарт обнаруживает до шести минут, Rust до трёх.
События — см. Типичные ошибки
- Опрос для панелей, метрик, readiness; события для реакции.
- Closed-наблюдатель даже с бесконечными повторами.
- Отдельные метрики разрывов и async-ошибок.
Плавное завершение — см. Типичные ошибки
- Drain после остановки производства, иначе гонка и ErrConnectionDraining.
- Срок длиннее медленного обработчика.
- Явные ack JetStream до закрытия: drain не управляет позицией.
Медленные потребители — см. Типичные ошибки
- Свои пределы настоящим подпискам; Go 500 000/64 МБ — лишь запасная защита.
- Расчёт по задержке и пику.
- Async callback и заметный журнал потерь.
- Различайте локальный drop и серверный disconnect.
Request/reply — см. Типичные ошибки
- Тайм-аут в два-три p99 отвечающего.
- Отдельные реакции на no responders и тайм-аут.
- Идемпотентность order_id с устранением дублей.
- Предел попыток и jitter.
TLS и аутентификация — см. Типичные ошибки
- Creds из файла/окружения, вне git.
- Всегда проверяйте CA.
- Продлевайте JWT до срока и наблюдайте auth-ошибки: сервер закрывает живое соединение, повторный отказ может завершить клиент.
- Ротация новым соединением с drain старого.
См. также
- Справочник — протокол, -ERR, сервер.
- Топологии — устройство пула.
- Безопасность — выпуск creds и CA.