# Подробно о топологиях

**Топология** — расположение серверов NATS и соединений между ними, форма развёрнутой системы. NATS масштабируется объединением серверов: крупные топологии строятся из меньших.

Глава последовательно рассматривает отдельный сервер, кластер, суперкластер и листовые узлы — в порядке роста реальной системы.

Общая идея: приложение не меняется. На каждой топологии работают тот же серверный исполняемый файл и тот же клиентский код. Меняется развёртывание.

## Растущая система

Мы следим за компанией Acme и системой ORDERS. Приложение публикует события заказов в темах под `orders.`, например `orders.created`, и читает их из потока ORDERS. Во всех примерах одна небольшая полезная нагрузка.

Под этой нагрузкой инфраструктура проходит четыре стадии:

* **Отдельный сервер.** Acme начинает с `nats-server` по имени `n1` на ноутбуке разработчика; клиенты подключаются напрямую.
* **Кластер.** Для переживания отказа сервера создаётся `east` из `n1-east`, `n2-east`, `n3-east`, соединённых **[маршрутами](/reference/protocols/route.md)** в полносвязную сеть. Клиент выбирает любой узел.
* **Суперкластер.** Для второго региона добавляется `west`, связанный с `east` через **[шлюзы](/reference/protocols/gateway.md)**. Суперкластер охватывает регионы и оставляет большую часть трафика локальной.
* **Листовые узлы.** Для цеха с только исходящим сетевым доступом создаётся **[листовой узел](/reference/protocols/leafnode.md)** `factory-1`: он обслуживает местных клиентов и сам подключается к `east`.

Все примеры можно запустить на одной машине.

## Два уровня: обмен сообщениями и JetStream

У каждой топологии две отдельные задачи, которые полезно различать.

Первая — **базовый обмен сообщениями**. Клиент публикует `orders.created`, а маршруты, шлюзы и листовые соединения доставляют сообщение подходящим подписчикам независимо от места подключения. Именно этот уровень показывают анимации перехода между серверами.

Вторая — **JetStream**. Поток сохраняет сообщения на диске, а клиенты читают их через потребителей. JetStream реплицирует данные по серверам топологии, переживая потерю узла. Топология переносит сообщения; JetStream сохраняет и реплицирует их поверх той же сети.

Большинство схем и анимаций посвящено первому уровню. Метаданные и репликация JetStream появляются на странице [JetStream в кластере](/learn/topologies/jetstream-in-a-cluster.md). Доставка подписчику — базовый обмен; сохранение потока после отказа — JetStream.

## Границы главы

Эта глава эксплуатации Learn дополняет введение [Основные понятия → Топологии](/concepts/topologies.md). Там пятиминутный обзор, здесь — готовые конфигурации, локальные процессы `nats-server` и объяснения, когда и зачем переходить к следующей форме.

Глава описывает формы и связи. Протокол Raft, время выборов, репликация журнала и размещение потоков разобраны в [Кластеризации и репликации](/learn/clustering/.md).

## Для кого эта глава

Вы прочитали [основные понятия](/concepts/what-is-nats.md), включая [топологии](/concepts/topologies.md) и [JetStream](/concepts/jetstream.md). Желательно пройти [главу JetStream](/learn/jetstream/.md) и знать потоки и потребителей: `ORDERS` используется повторно.

## Карта главы

| Страница                                                            | Что вы узнаете                                                    |
| ------------------------------------------------------------------- | ----------------------------------------------------------------- |
| [Отдельный сервер](/learn/topologies/single-server.md)              | Простейшее развёртывание, его применимость и единая точка отказа  |
| [Ваш первый кластер](/learn/topologies/your-first-cluster.md)       | Маршруты между серверами, переподключение и переключение клиентов |
| [JetStream в кластере](/learn/topologies/jetstream-in-a-cluster.md) | Слой метаданных и реплицируемые потоки                            |
| [Суперкластеры](/learn/topologies/super-clusters.md)                | Шлюзы между регионами и географическая привязка                   |
| [Листовые узлы](/learn/topologies/leaf-nodes.md)                    | Исходящее подключение листового узла и распространение интереса   |
| [Объединяем всё](/learn/topologies/putting-it-together.md)          | Общая схема кластеров, шлюзов и листовых узлов                    |
| [Куда двигаться дальше](/learn/topologies/where-next.md)            | Дальнейшие темы                                                   |

Откройте терминал и перейдите к [отдельному серверу](/learn/topologies/single-server.md).

## См. также

* [Основные понятия → Топологии](/concepts/topologies.md) — краткий обзор четырёх форм.
* [JetStream](/learn/jetstream/.md) — используемый поток `ORDERS`.
* [Кластеризация и репликация](/learn/clustering/.md) — внутренний механизм кластеров.
