Перейти к основному содержимому
Нормативная версия документации - английская

Эта страница переведена с английского языковой моделью. При любом расхождении верен английский оригинал.

Брокеры

Обработчики, роутеры, кодеки и middleware не зависят от брокера. Перевести сервис на другой брокер вы можете, изменив одну строку в with_broker.

В составе фреймворка идёт полноценный in-memory брокер для очередей внутри одного приложения. Для внешнего брокера очереди вы добавляете в зависимости отдельный крейт - адаптацию его клиентской библиотеки.

У каждой адаптации библиотеки брокера свой сайт документации: ссылки собраны в столбце «Документация» и в меню Брокеры.

БрокерКрейтТранспортДокументация
Memoryruststream (фича memory)очередь внутри процесса, без сервера и без зависимостейэтот сайт
NATSruststream-natsCore NATS и JetStreampowersemmi.github.io/ruststream-nats
Redisruststream-fredRedis Streams (standalone, кластер, sentinel)powersemmi.github.io/ruststream-fred
RabbitMQruststream-lapinAMQP 0.9.1 (очереди, обменники, подтверждения издателя, direct reply-to)powersemmi.github.io/ruststream-lapin
Kafkaruststream-rdkafkaApache Kafka (группы консьюмеров, отслеживаемая фиксация смещений, транзакции, конвейеры exactly-once)powersemmi.github.io/ruststream-rdkafka
AMQP 1.0ruststream-amqpActiveMQ Artemis, RabbitMQ 4.x, Azure Service Bus и остальное семейство AMQP 1.0 (request-reply, транзакции)powersemmi.github.io/ruststream-amqp
Google Cloud Pub/Subruststream-gcp-pubsubPub/Sub через официальную клиентскую библиотеку (ключи упорядочивания, подтверждение exactly-once, политики DLQ)powersemmi.github.io/ruststream-gcp-pubsub
AWS SQS / SNSruststream-sqs-snsОчереди SQS с доставкой через SNS всем подписчикам разом (FIFO-группы, управление видимостью, встроенная отложенная повторная доставка)powersemmi.github.io/ruststream-sqs-sns
Apache Pulsarruststream-pulsarТемы и шаблоны Pulsar (режимы подписки, политики DLQ, перемотка)powersemmi.github.io/ruststream-pulsar
MQTT 5ruststream-rumqttcMQTT v5 (уровни QoS, shared-группы, retained-сообщения)powersemmi.github.io/ruststream-rumqttc
ZeroMQruststream-zeromqБез брокера очереди: PUSH/PULL, PUB/SUB и request-reply на DEALER/ROUTER поверх TCP и IPCpowersemmi.github.io/ruststream-zeromq
Файлы потоков / stdioruststream-sea-fileДолговечные воспроизводимые файлы потоков и конвейеры оболочки; нулевая инфраструктура, перемотка на любую позициюpowersemmi.github.io/ruststream-sea-file
AWS Kinesisruststream-kinesisПотоки данных Kinesis (аренда шардов, контрольные точки, перемотка)powersemmi.github.io/ruststream-kinesis
SQL-базы данныхruststream-sqlxОчереди задач в собственных таблицах сервиса (Postgres, MySQL/MariaDB, SQLite) и транзакционный outbox поверх любого брокера; SQL-запросы проверяются при запуске или на этапе компиляцииpowersemmi.github.io/ruststream-sqlx

Как написать адаптацию библиотеки брокера для другого транспорта, объясняет документация трейта Broker: в ней описан контракт крейта брокера и проверки соответствия ему.

Переключение брокеров​

Чтобы перейти на другой брокер, замените импорт его типа и строку, которая его создаёт. Остальной код в примерах ниже одинаков. Любой брокер создаётся синхронно, а подключает его рантайм на старте приложения.

use ruststream::memory::MemoryBroker;
use ruststream::runtime::{AppInfo, RustStream};

#[ruststream::app]
fn app() -> RustStream {
RustStream::new(AppInfo::new("orders", "0.1.0"))
.with_broker(MemoryBroker::new(), |b| b.include_router(routes::orders()))
}

Параметры подключения каждая адаптация библиотеки брокера документирует сама.

Если подписке нужны опции конкретного брокера очереди (группы консьюмеров, durable-имена), вы можете передать его дескриптор аргументом макроса #[subscriber(..)]. Об этом рассказывает раздел дескрипторы конкретных брокеров.