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

Межаккаунтный обмен

ORDERS и ANALYTICS изолированы: order-svc публикует внутри первой, analytics-reader подписывается внутри второй.

Иногда нужно намеренное совместное использование.

Аналитике необходимо считать orders.shipped, но одинаковой подписки недостаточно.

Откроем только эту тему, сохранив остальные границы.

Экспорт и импорт​

Нужны согласованные декларации обеих сторон.

Экспорт предлагает тему владельца другим: ORDERS экспортирует orders.shipped.

Импорт выбирает тему и запись владельца и включает в локальное пространство ANALYTICS.

Экспорт без импорта ничего не переносит. Импорт без экспорта отклоняет конфигурацию при запуске.

Тип экспорта​

Stream export — односторонний pub/sub. ORDERS публикует, ANALYTICS читает. С потоками JetStream название не связано: stream здесь означает поток сообщений через границу.

Service export — двусторонний request/reply, например запрос цены ORDERS из ANALYTICS. Здесь не нужен; подробнее в exports.

Экспорт ORDERS​

Добавьте exports к записи. Пользователи, права, SYS и system_account прежние; пример показывает только арендаторов:

accounts {
ORDERS: {
jetstream: enabled
users: [
{ user: order-svc, password: s3cr3t,
permissions: {
publish: { allow: ["orders.>"] }
subscribe: { allow: ["_INBOX.>"] }
}
}
]
exports: [
{ stream: "orders.shipped" }
]
}
ANALYTICS: {
users: [
{ user: analytics-reader, password: an4lytics }
]
}
}

Ключ stream: задаёт одновременно тип и тему. Service использовал бы service:.

Без ограничений экспорт публичный, импорт доступен любой записи сервера. Для выбранных перечислите accounts:

{ stream: "orders.shipped", accounts: [ANALYTICS] }

Здесь достаточно публичного.

Более сложные ограничения есть в режиме оператора.

Импорт ANALYTICS​

Добавьте соответствующий imports:

accounts {
ORDERS: {
jetstream: enabled
users: [
{ user: order-svc, password: s3cr3t,
permissions: {
publish: { allow: ["orders.>"] }
subscribe: { allow: ["_INBOX.>"] }
}
}
]
exports: [
{ stream: "orders.shipped" }
]
}
ANALYTICS: {
users: [
{ user: analytics-reader, password: an4lytics }
]
imports: [
{ stream: { account: ORDERS, subject: "orders.shipped" } }
]
}
}

Stream должен совпадать с типом, account — ORDERS, subject — исходная orders.shipped.

Примените nats-server --signal reload=<pid> или перезапустите. Теперь тема появляется и в ANALYTICS.

По умолчанию имя прежнее. Prefix или to меняют локальное имя против конфликтов; здесь не нужны. См. imports.

Проверка обмена​

Публикация order-svc и подписка analytics-reader связываются только экспортом/импортом.

Анимация также показывает неэкспортированную orders.created внутри ORDERS. Проверьте shipped:

#!/bin/sh
# analytics-reader (in ANALYTICS) subscribes to the imported orders.shipped
# while order-svc (in ORDERS) publishes it. The export/import pair makes the
# message cross the account boundary.
#
# Assumes the server config from this page: ORDERS exports the stream
# "orders.shipped" and ANALYTICS imports it from ORDERS.

# Context for analytics-reader in the ANALYTICS account.
nats context save analytics \
--server nats://localhost:4222 \
--user analytics-reader \
--password an4lytics

# Context for order-svc in the ORDERS account.
nats context save orders \
--server nats://localhost:4222 \
--user order-svc \
--password s3cr3t

# Subscribe as analytics-reader to the imported subject (background).
nats --context analytics sub "orders.shipped" &
SUB_PID=$!
sleep 1

# Publish a shipment as order-svc in ORDERS.
nats --context orders pub orders.shipped \
'{"order_id":"ord_8w2k","customer":"acme-co","total_cents":4200,"ts":"2026-05-22T10:14:22Z"}'

sleep 1
kill "$SUB_PID"

# Expected (subscriber terminal): the message arrives even though it was
# published in a different account, because ORDERS exports orders.shipped
# and ANALYTICS imports it.
# [#1] Received on "orders.shipped"
# {"order_id":"ord_8w2k","customer":"acme-co","total_cents":4200,"ts":"2026-05-22T10:14:22Z"}

Вывод подписчика:

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

Заказ ord_8w2k поступает с тем же именем. Издатель не знает импортёра и выводит обычное Published 91 bytes to "orders.shipped". Связь полностью в серверной конфигурации.

Остальная изоляция​

Orders.created и orders.canceled по-прежнему не видны ANALYTICS.

Exports перечисляет всё, что разрешено вынести из записи.

Третья запись тоже должна импортировать, возможно под другим именем без влияния на существующих.

Та же связь у оператора​

В режиме оператора декларации находятся в JWT: nats auth account exports add Shipments "orders.shipped" ORDERS и nats auth account imports add Shipments "orders.shipped" ANALYTICS --source <ORDERS-public-key> --local orders.shipped. Обе записи нужно push. До этого связи нет без проверки запуска. В nats auth нет activation tokens: --token-position ограничивает wildcard-тему открытым ключом импортирующей записи.

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

Несовпадения сторон:

Экспорт без импорта молчит, обратное останавливает сервер. Проверьте account импорта. Отсутствующий экспорт даёт при запуске:

nats-server: nats.conf:2:1: Error adding stream import "orders.shipped": stream import not authorized

В JWT-режиме непереданный импорт молча не действует. Проверяйте публикацией и подпиской.

Типы не взаимозаменяемы. Если импорт service orders.price существует, но отвечающего в ORDERS нет, приходит No responders are available:

#!/bin/sh
# A service export is request/reply, not publish/subscribe. If ANALYTICS calls
# a service subject that ORDERS exports but no responder is running, the
# request comes back as "No responders are available" right away.
#
# This demo starts its own server on the default port, so stop the chapter's
# server first.

# 1. ORDERS exports a service "orders.price"; ANALYTICS imports it.
# No responder is started in ORDERS, so nothing can answer yet.
cat > cross-account-service.conf <<'EOF'
accounts {
ORDERS {
users: [
{ user: order-svc, password: s3cr3t }
]
exports: [
{ service: "orders.price" }
]
}
ANALYTICS {
users: [
{ user: analytics-reader, password: an4lytics }
]
imports: [
{ service: { account: ORDERS, subject: "orders.price" } }
]
}
}
EOF

# 2. Start the server.
nats-server -c cross-account-service.conf &
SERVER_PID=$!
sleep 1

# 3. analytics-reader requests the imported service. No responder is running
# in ORDERS, so the server answers immediately instead of letting the
# request wait out the full timeout.
nats --server nats://localhost:4222 \
--user analytics-reader --password an4lytics \
request orders.price '{"order_id":"ord_8w2k"}' --timeout 2s
# Expected (the CLI exits 0):
# 14:19:42 Sending request on "orders.price"
# 14:19:42 No responders are available

# "No responders" means the import matched the service export but nothing
# answered: start a responder in ORDERS. A request with no import at all gets
# the same immediate answer, because it never leaves ANALYTICS. An import that
# doesn't match any export fails earlier, when the server starts.

kill "$SERVER_PID"
14:19:42 Sending request on "orders.price"
14:19:42 No responders are available

CLI выводит статус и код 0 без ожидания. Запустите responder. Без импорта ответ такой же, поскольку запрос остаётся ANALYTICS. Несовпавший с экспортом импорт отвергается раньше, при запуске.

Переименованный импорт требует нового имени подписки. Prefix/to меняет локальную тему, а не публикацию владельца.

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

Одна явная связь:

  • ORDERS публично экспортирует stream orders.shipped.
  • ANALYTICS импортирует её.
  • Analytics-reader получает отправки.
  • Остальные события изолированы.

Что дальше​

Конфигурационная модель завершена: вход, права, записи, обмен. Теперь уберём список пользователей с сервера.

Перейдите к Режиму оператора.

См. также​