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

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

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

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

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

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

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

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

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

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

**Движение сообщений — Полная топология Acme (анимация):** Топология Acme целиком: кластеры east и west по три сервера объединены в суперкластер, к периферии подключён листовой узел. Маршруты работают внутри кластеров, шлюзы — между ними, листовое соединение — до периферии. Сообщение достигает любого клиента, хотя ни один отдельный слой не охватывает всю систему.

* n1-east → n2-east
* n1-east → n3-east
* n2-east → n3-east
* n1-west → n2-west
* n1-west → n3-west
* n2-west → n3-west
* n1-east → n1-west
* n3-east → factory-1
* датчик → factory-1

Анимация показывает слой сообщений: заказ проходит маршруты, шлюз и листовую связь к подписчикам. Реплики `ORDERS` здесь не изображены — это отдельный уровень [JetStream в кластере](/learn/topologies/jetstream-in-a-cluster.md).

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

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

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

Связи локальны для слоя: маршруты внутри кластера, шлюзы между кластерами, 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` взят из [первого кластера](/learn/topologies/your-first-cluster.md), `gateway` — из [суперкластеров](/learn/topologies/super-clusters.md), `leafnodes` — из [листовых узлов](/learn/topologies/leaf-nodes.md). Их объединение и есть композиция.

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

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

Границу способен задать лист, привязанный к отдельной учётной записи: **изоляция пространства адресов** из [Листовых узлов](/learn/topologies/leaf-nodes.md). Для приватности тем используйте этот уровень, а не дополнительный маршрут или шлюз.

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

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

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

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

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

Пока мы проверяли систему без аутентификации публикациями через связи. Для общего обзора серверов, кластеров и соединений нужна **системная учётная запись** `$SYS`. Настройте её по [Безопасности](/learn/security/.md), затем подключитесь с её данными.

`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`. Это направление из [Листовых узлов](/learn/topologies/leaf-nodes.md).

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

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

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

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

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

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

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

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

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

Добавляйте слой при ограничении, как описано в [выборе следующего слоя](#picking-the-next-layer). Код одинаков, поэтому поздний рост не потребует переделки приложения.

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

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

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

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

* Композиция складывает слои, сохраняя нижние.
* Она расширяет охват, но не создаёт границ: для изоляции нужен лист со своей учётной записью, как в [Листовых узлах](/learn/topologies/leaf-nodes.md).

Теперь схема из [введения в топологии](/concepts/topologies.md) собрана на практике.

## Что дальше

Вы умеете соединять формы. [Куда двигаться дальше](/learn/topologies/where-next.md) укажет главы о механике кластера, средствах развёртывания и мониторинге.

## См. также

* [Эксплуатация → Кластеризация и репликация](/learn/clustering/scaling-and-peers.md) — безопасное изменение числа серверов.
* [Эксплуатация → Развёртывание](/learn/deployment/kubernetes.md) — Kubernetes и обновления.
* [Справочник → Протокол листовых узлов](/reference/protocols/leafnode.md) — детали связи и изоляции.
