Объединяем всё
За пять страниц вы изучили четыре формы: сервер, кластер маршрутов, суперкластер шлюзов и листовое подключение периферии. Каждая страница расширяла прежнюю систему.
Новых форм здесь нет: мы покажем, как знакомые складываются в одно развёртывание и что это даёт автоматически.
Две идеи: композиция — формы как совмещаемые слои — и её предел: границы доступа требуют отдельного решения листового узла и учётной записи.
Система 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 поверх всей системы.
Две идеи для дальнейшей работы:
- Композиция складывает слои, сохраняя нижние.
- Она расширяет охват, но не создаёт границ: для изоляции нужен лист со своей учётной записью, как в Листовых узлах.
Теперь схема из введения в топологии собрана на практике.
Что дальше
Вы умеете соединять формы. Куда двигаться дальше укажет главы о механике кластера, средствах развёртывания и мониторинге.
См. также
- Эксплуатация → Кластеризация и репликация — безопасное изменение числа серверов.
- Эксплуатация → Развёртывание — Kubernetes и обновления.
- Справочник → Протокол листовых узлов — детали связи и изоляции.