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

Объединяем всё

За пять страниц вы изучили четыре формы: сервер, кластер маршрутов, суперкластер шлюзов и листовое подключение периферии. Каждая страница расширяла прежнюю систему.

Новых форм здесь нет: мы покажем, как знакомые складываются в одно развёртывание и что это даёт автоматически.

Две идеи: композиция — формы как совмещаемые слои — и её предел: границы доступа требуют отдельного решения листового узла и учётной записи.

Система Acme к этому моменту​

После страницы листовых узлов схема такова.

Два кластера: east (n1-east, n2-east, n3-east) и west (n1-west, n2-west, n3-west), каждый — три сервера с полносвязными маршрутами.

Шлюзы объединяют их в суперкластер. Через шлюз идёт лишь сообщение с интересом на другой стороне.

factory-1 исходящим соединением подключён к east и обслуживает местных клиентов цеха.

ORDERS работает без изменений. Производители публикуют orders.*, потребители читают поток. Код с ноутбука n1 подходит и здесь.

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

Формы — совмещаемые слои​

Ни одна форма не заменила предыдущую. Кластер объединяет отдельные серверы; суперкластер — кластеры; лист добавляет ещё один сервер. Нижние уровни остаются.

Это композиция: новый слой добавляется, когда прежнего недостаточно, а нижний продолжает прежнюю работу.

Связи локальны для слоя: маршруты внутри кластера, шлюзы между кластерами, remotes между листом и центром. Ни один блок конфигурации не обязан знать всю систему.

Сервер может участвовать во всех слоях: n1-east имеет маршруты к соседям, шлюз в west и входящий лист factory-1. В одном файле три блока:

# n1-east.conf — one server, three roles
server_name: n1-east
listen: 127.0.0.1:4222

cluster {
name: east
listen: 127.0.0.1:6222
routes: [
nats://127.0.0.1:6223 # n2-east; gossip fills in the rest
]
}

gateway {
name: east
listen: 127.0.0.1:7222
gateways: [
{ name: west, urls: ["nats://127.0.0.1:7322", "nats://127.0.0.1:7323", "nats://127.0.0.1:7324"] }
]
}

leafnodes {
listen: 127.0.0.1:7422
}

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

cluster взят из первого кластера, gateway — из суперкластеров, leafnodes — из листовых узлов. Их объединение и есть композиция.

Композиция и границы​

По умолчанию получается единое пространство адресов. Маршруты разносят интерес учётной записи по кластеру, шлюз пересылает нужные темы. Они расширяют охват, не разделяя пространство.

Границу способен задать лист, привязанный к отдельной учётной записи: изоляция пространства адресов из Листовых узлов. Для приватности тем используйте этот уровень, а не дополнительный маршрут или шлюз.

Выбор следующего слоя​

Всю систему не обязательно проектировать сразу. Добавляйте слой при конкретном ограничении:

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

Каждый шаг обратим: удаление верхнего слоя оставляет нижний работающим.

Просмотр всей топологии​

Пока мы проверяли систему без аутентификации публикациями через связи. Для общего обзора серверов, кластеров и соединений нужна системная учётная запись $SYS. Настройте её по Безопасности, затем подключитесь с её данными.

nats server list показывает серверы, кластеры и числа маршрутов и шлюзов:

nats server list
╭───────────────────────────────────────────────────────────────────────────╮
│ Server Overview │
├──────────┬─────────┬──────┬─────────┬─────┬───────┬──────┬────────┬─────────┤
│ Name │ Cluster │ Host │ Version │ JS │ Conns │ Subs │ Routes │ GWs │
├──────────┼─────────┼──────┼─────────┼─────┼───────┼──────┼────────┼─────────┤
│ n1-east │ east │ ... │ 2.x.x │ yes │ 4 │ 12 │ 2 │ 1 │
│ n2-east │ east │ ... │ 2.x.x │ yes │ 3 │ 12 │ 2 │ 1 │
│ n3-east │ east │ ... │ 2.x.x │ yes │ 2 │ 12 │ 2 │ 1 │
│ n1-west │ west │ ... │ 2.x.x │ yes │ 2 │ 11 │ 2 │ 1 │
│ n2-west │ west │ ... │ 2.x.x │ yes │ 1 │ 11 │ 2 │ 1 │
│ n3-west │ west │ ... │ 2.x.x │ yes │ 1 │ 11 │ 2 │ 1 │
╰──────────┴─────────┴──────┴─────────┴─────┴───────┴──────┴────────┴─────────╯

У каждого слоя также свой отчёт:

nats server report routes # the mesh inside each cluster
nats server report gateways # the gateways between clusters
nats server report leafnodes # the leaves dialed into the hub

nats server report leafnodes показывает factory-1: имя, учётную запись, адрес и время кругового обмена.

╭──────────────────────────────────────────────────────────────────╮
│ Leafnode Report │
├─────────┬───────────┬─────────┬──────────────────┬──────┬─────────┤
│ Server │ Name │ Account │ Address │ RTT │ Spoke │
├─────────┼───────────┼─────────┼──────────────────┼──────┼─────────┤
│ n1-east │ factory-1 │ $G │ 203.0.113.7:... │ 18ms │ false │
╰─────────┴───────────┴─────────┴──────────────────┴──────┴─────────╯

Account равен $G: отдельная запись не создана, поэтому используется глобальная и границы нет.

Spoke равен false, поскольку отчёт получен от принимающего n1-east. На стороне factory-1, инициировавшего соединение, будет true. Это направление из Листовых узлов.

Три отчёта вместе показывают все слои: маршруты, шлюзы и листы.

Клиентский код остаётся прежним​

Главная мысль главы: клиентская сторона не менялась при добавлении слоёв.

Издатель отправляет в orders.created прежние поля заказа: идентификатор, заказчик, сумма и время.

Потребитель читает ORDERS. Клиент подключается к URL NATS, а серверные связи доставляют сообщение по интересу. Топология относится к эксплуатации.

Поэтому от ноутбука можно вырасти до нескольких регионов и периферии без переписывания бизнес-логики. Растёт развёртывание, приложение прежнее.

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

Главная ловушка — преждевременная сложность.

Создание всех слоёв до реальной необходимости. Каждый добавляет серверы и наблюдаемые соединения. Суперкластер «на всякий случай» требует обслуживать два региона ещё до появления трафика второго.

Добавляйте слой при ограничении, как описано в выборе следующего слоя. Код одинаков, поэтому поздний рост не потребует переделки приложения.

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

Итоговая схема Acme:

  • Два кластера east, west, по три сервера с маршрутами.
  • Шлюзы между ними.
  • Лист factory-1, подключённый к east и обслуживающий местных клиентов.
  • Неизменённая нагрузка ORDERS поверх всей системы.

Две идеи для дальнейшей работы:

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

Теперь схема из введения в топологии собрана на практике.

Что дальше​

Вы умеете соединять формы. Куда двигаться дальше укажет главы о механике кластера, средствах развёртывания и мониторинге.

См. также​