# Подробно о развёртывании и обновлениях

В [главе топологий](/learn/topologies/.md) спроектирован кластер NATS `east` из трёх узлов с потоком `ORDERS`. Здесь мы запускаем именно этот кластер для реальной эксплуатации.

Топологии описывали *формы*: отдельный сервер, кластер, суперкластер, листовые узлы. Здесь рассмотрены *операции*, превращающие схему в работающую систему: выделение ресурсов, манифесты запуска, SIGHUP для перечитывания конфигурации без разрыва соединений, режим плавного вывода для обновления без потери потока и ограничения доступа systemd.

Это практическая инструкция. Каждая страница называет механизм, даёт точную команду или манифест и отправляет за объяснением причин в соответствующую главу.

**Движение сообщений — Завершение работы lame duck при обновлении (анимация):** Корректное завершение одного узла при постепенном обновлении. SIGUSR2 переводит nats-0 в режим lame duck; INFO с ldm:true предупреждает клиентов. Узел передаёт лидерство Raft nats-1, JetStream переносит реплики ORDERS на nats-1 и nats-2 с полной репликацией. После завершения обработки nats-0 корректно закрывает соединения, warehouse переходит на nats-1 без потерь. nats-0 запускается на новой версии и возвращается без роли лидера. Сначала обновляют ведомых, лидера метаданных — последним.

* оператор → nats-2
* nats-2 → warehouse
* nats-2 → nats1
* nats-2 → nats2
* nats-2 → nats1 (тема: реплика ORDERS)
* nats1 → nats2
* warehouse → nats1
* nats1 → nats-2 (тема: возврат (ведомый))

## Что вы получите

Инструкцию эксплуатации того же кластера Acme ORDERS, который проходит через остальные главы Learn:

* **Исходный расчёт ресурсов**: CPU, память, диск, файловые дескрипторы и учёт потока R3 в ограничениях учётной записи `ORDERS`.
* **Кластер Kubernetes** как StatefulSet с тремя репликами и подами `nats-0`, `nats-1`, `nats-2`, соответствующими `n1-east`, `n2-east`, `n3-east` из топологий. Поток `ORDERS` и потребители `shipping`, `analytics` объявлены через CRD.
* **Изменение конфигурации на ходу**: отдельные включаемые файлы учётных записей и регионов, перечитываемые через SIGHUP без простоя и переподключений.
* Безопасное **последовательное обновление** версии на `nats-0..2` с сохранением доступности потока R3 ORDERS и соединений клиентов.
* **Защищённый** кластер: TLS на всех связях, подключённые учётные данные `ACME`, ограниченный модуль systemd и закрытый от интернета порт мониторинга.

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

Вы готовите кластер к реальной эксплуатации, прочитали [топологии](/learn/topologies/.md) и знакомы с [JetStream](/learn/jetstream/.md) и [безопасностью](/learn/security/.md). Здесь повторно используются поток `ORDERS` и оператор `ACME`.

Глава намеренно посвящена процедурам. Остальной материал распределён между четырьмя связанными главами:

* **Выбор топологии** — [Топологии](/learn/topologies/.md). Предполагается, что кластер ORDERS из трёх узлов уже выбран.
* **Устройство Raft и репликации** — [Кластеризация](/learn/clustering/.md). Здесь при обновлении *инициируется* передача лидерства, но не объясняется алгоритм выборов.
* **Модель аутентификации** — [Безопасность](/learn/security/.md): операторы, учётные записи, пользователи, JWT. Здесь мы *подключаем* учётные данные и *включаем* TLS.
* **Наблюдение за системой** — [Мониторинг](/learn/monitoring/.md). Здесь кластер *настраивается*, там — наблюдается.

Если объяснение целиком относится к одной из этих глав, здесь вместо повтора дана ссылка.

## Как читать главу

Каждая страница вводит не больше двух понятий и продолжает работу с тем же кластером. Вы [рассчитываете ресурсы](/learn/deployment/sizing-and-resources.md), [развёртываете кластер](/learn/deployment/kubernetes.md), [меняете конфигурацию без остановки](/learn/deployment/config-management.md), [обновляете](/learn/deployment/rolling-upgrades.md) и [защищаете](/learn/deployment/hardening.md). Имена `n1-east`/`n2-east`/`n3-east`, поток `ORDERS`, издатель `order-svc` и оператор `ACME` остаются прежними: одна система Acme последовательно готовится к эксплуатации.

Здесь разобраны только необходимые этому развёртыванию параметры. Полный список настроек сервера находится в [Справочнике → Конфигурация](/reference/config/.md); страницы ссылаются на него за подробностями.

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

| Страница                                                              | Что вы узнаете                                                                |
| --------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| [Развёртывание и обновления](/learn/deployment/.md)                   | Объекты эксплуатации и порядок процедур                                       |
| [Размер системы и ресурсы](/learn/deployment/sizing-and-resources.md) | Четыре ресурса узла и учёт R3 в ограничениях учётной записи                   |
| [Kubernetes](/learn/deployment/kubernetes.md)                         | StatefulSet через чарт NATS Helm и объявление потоков через CRD               |
| [Управление конфигурацией](/learn/deployment/config-management.md)    | Включаемые файлы и SIGHUP без простоя и переподключений                       |
| [Последовательные обновления](/learn/deployment/rolling-upgrades.md)  | Плавный вывод узлов и правильный порядок обновления                           |
| [Защита системы](/learn/deployment/hardening.md)                      | TLS на каждой связи, подключение учётных данных и ограниченный модуль systemd |
| [Куда двигаться дальше](/learn/deployment/where-next.md)              | Контрольный список и дальнейшие шаги эксплуатации                             |

## Предварительные условия

Вам понадобятся:

* Работающий кластер ORDERS из трёх узлов или готовность создать его по ходу чтения. [Топологии](/learn/topologies/.md) объясняют создание по шагам.
* CLI `nats`, установленный и настроенный на кластер, для команд проверки `nats account info`, `nats server info`, `nats stream info`.
* Для страниц Kubernetes — доступный через `kubectl` кластер и установленный `helm`. Здесь используется [чарт NATS Helm](/learn/deployment/kubernetes.md) и контроллер NACK.

Откройте терминал и перейдите к [размеру системы и ресурсам](/learn/deployment/sizing-and-resources.md).

## См. также

* [Топологии](/learn/topologies/.md) — устройство развёртываемой системы.
* [Кластеризация и репликация](/learn/clustering/.md) — механика Raft, используемая в процедурах.
* [Безопасность](/learn/security/.md) — модель подключаемых учётных данных.
