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

Экосистема NATS

NATS — это не только исполняемый файл nats-server. Его дополняют официально поддерживаемые клиенты, библиотеки расширений, инструменты командной строки и Kubernetes, средства управления идентификационными данными и интеграции.

Эта страница — карта экосистемы: назначение каждого репозитория, кто его поддерживает и с чего начать.

Если вы хотите просто выбрать клиент и начать разработку, перейдите к клиентам Tier 1.

Сервер​

Единый исполняемый файл выполняет всю маршрутизацию сообщений. Кластеризация, долговременное хранение JetStream, листовые узлы, MQTT и WebSocket включаются в конфигурации того же nats-server: устанавливать отдельные компоненты не нужно.

НазваниеОписание
nats-serverСам сервер NATS

Клиенты​

Клиенты NATS делятся на три категории: Tier 1 (поддерживаются Synadia и реализуют новые возможности к выпуску сервера), Tier 2 (поддерживаются Synadia, но могут отставать в поддержке новых возможностей) и клиенты сообщества (сторонние реализации).

Клиенты Tier 1 — следуют за выпусками сервера​

Эти клиенты команда NATS обновляет в первую очередь при появлении новых возможностей сервера. Если для вашего языка есть клиент Tier 1, предпочтите его.

ЯзыкРепозиторийОписание
Gonats-io/nats.goЭталонная реализация
JavaScript / TypeScriptnats-io/nats.jsNode, Deno, Bun, браузер (WebSocket). Заменяет архивные nats.node, nats.deno, nats.ws, nats.ts
Pythonnats-io/nats.pyНа основе asyncio, только Python 3
Javanats-io/nats.javaJVM; доступен из Kotlin и Scala
Rustnats-io/nats.rsКрейт async-nats
C# / .NETnats-io/nats.net.NET 6+. Современный асинхронный клиент
Cnats-io/nats.cВстраиваемые системы и приложения, использующие FFI

Клиенты Tier 2 — поддерживаются Synadia, возможна задержка новых функций​

Эти клиенты поддерживаются Synadia, но появление каждой новой возможности сервера в день выпуска не гарантируется. Реализованные функции готовы к промышленной эксплуатации; актуальное покрытие возможностей смотрите в README соответствующего репозитория.

ЯзыкРепозиторийОписание
Zignats-io/nats.zigНедавнее пополнение
Swiftnats-io/nats.swiftiOS, macOS и серверный Swift
Rubynats-io/nats-pure.rbНа чистом Ruby — предпочтительный клиент для Ruby
Ruby (устаревший)nats-io/nats.rbНа основе EventMachine; для нового кода используйте nats-pure.rb
Elixirnats-io/nats.exЗаменяет архивный elixir-nats

Клиенты сообщества​

Сторонние реализации существуют, в частности, для Crystal, Dart, Kotlin и PHP. Покрытие возможностей и состояние поддержки различаются — оценивайте каждый проект отдельно. Эта документация не рассматривает клиенты сообщества.

Orbit — расширения и экспериментальные возможности для каждого языка​

Репозитории Orbit находятся в организации synadia-io. Они содержат необязательные высокоуровневые утилиты и экспериментальные возможности поверх соответствующего клиента Tier 1. Подключайте только нужные модули.

В Orbit обычно входят дополнительные инструменты JetStream (запрос нескольких ответов, пакетная публикация, отложенные сообщения), секционированные группы потребителей, кодирование KV и кодеки, распределённые счётчики, утилиты повторных попыток и тестирования отказов. Удачные подходы со временем могут войти в основной клиент. Набор модулей зависит от языка — сверяйтесь с README репозитория Orbit.

ЯзыкРепозиторийОписание
Gosynadia-io/orbit.goРасширения для nats.go
JavaScript / TypeScriptsynadia-io/orbit.jsРасширения для nats.js
Pythonsynadia-io/orbit.pyРасширения для nats.py
Javasynadia-io/orbit.javaРасширения для nats.java
Rustsynadia-io/orbit.rsРасширения для async-nats
C# / .NETsynadia-io/orbit.netРасширения для nats.net
Csynadia-io/orbit.cРасширения для nats.c

Инструменты командной строки​

НазваниеОписание
natscliCLI nats для повседневной работы: публикация, подписка, управление потоками и потребителями, проверка работающего сервера, управление операторами, учётными записями и пользователями через nats auth. Используется в большинстве примеров документации
nats-topПросмотр активности сервера в реальном времени в стиле top
nats-boxОбраз контейнера с распространёнными утилитами NATS (nats, nsc, nk) для временных рабочих оболочек в Kubernetes

Идентификационные данные и аутентификация​

Инструменты и библиотеки для управления операторами, учётными записями, пользователями и ключами подписи с помощью NKeys и JWT.

НазваниеОписание
nscОтдельный CLI для управления операторами, учётными записями и пользователями. Альтернатива командам nats auth, встроенным в CLI nats; использует то же хранилище на диске и поддерживает операции, которых пока нет в nats auth
synadia-io/jwt-auth-builder.goПрограммное создание учётных записей и пользователей (альтернатива вызову nsc из кода)
synadia-io/callout.goGo SDK для написания сервисов auth callout
synadia-io/callout.net.NET SDK для написания сервисов auth callout

Библиотеки NKey​

Реализации базовых операций подписи и работы с ключами NKey для разных языков.

ЯзыкРепозиторий
Gonats-io/nkeys
JavaScript / TypeScriptnats-io/nkeys.js
Javanats-io/nkeys.java
C# / .NETnats-io/nkeys.net
Pythonnats-io/nkeys.py
Rubynats-io/nkeys.rb
Swiftnats-io/nkeys.swift
Elixirnats-io/nkeys.ex

Библиотеки JWT​

Реализации выпуска и проверки утверждений JWT учётных записей и пользователей NATS для разных языков.

ЯзыкРепозиторий
Gonats-io/jwt
JavaScript / TypeScriptnats-io/jwt.js
Javanats-io/jwt.java
C# / .NETnats-io/jwt.net

Kubernetes​

НазваниеОписание
k8sОфициальные Helm-чарты для развёртывания кластеров nats-server, surveyor и связанных компонентов
nackКонтроллеры Kubernetes и CRD для декларативного управления потоками и потребителями JetStream, хранилищами KV и Object Store

Наблюдаемость​

НазваниеОписание
prometheus-nats-exporterЭкспортёр Prometheus для varz, connz, routez и статистики JetStream
nats-surveyorМониторинг всего кластера: собирает статистику с серверов и предоставляет её в виде метрик Prometheus. В сочетании с экспортёром обеспечивает наблюдаемость всего кластера

Схемы и определения API​

НазваниеОписание
jsm.goКанонический источник JSON-схем API JetStream, используемых инструментами и справочником этого сайта. Также содержит библиотеку управления JetStream на Go (альтернативу nats.go с другим API)

Мосты и интеграции​

НазваниеОписание
nats-kafkaМост Kafka ↔ NATS
nats-spark-connectorИсточник для структурированной потоковой обработки Apache Spark
synadia-io/flink-connector-natsКоннектор Apache Flink
nats-java-vertx-clientИнтеграция с Vert.x
terraform-provider-jetstreamУправление ресурсами JetStream как инфраструктурой в коде (IaC)

Следующие шаги​