Куда двигаться дальше
В начале ничего не было запущено. Теперь три сервера n1-east, n2-east, n3-east обнаружили друг друга через один начальный маршрут, выбрали лидеров групп RAFT и хранят ORDERS с R=3. Запись order-svc приходит лидеру, фиксируется кворумом и переживает отказ одного сервера.
Эта страница собирает механизм целиком и указывает главы и справочник для дальнейшего изучения.
Пять основных идей
Все страницы опирались на пять идей.
Маршруты — соединения серверов, формирующие кластер. Вы задаёте начальный явный маршрут, а gossip распространяет известные адреса через INFO и достраивает полносвязную сеть.
Группы RAFT обеспечивают согласование: общая группа метаданных и отдельная у каждого потока. Выборы назначают единственного лидера, принимающего записи; ведомые реплицируют их.
Кворум — большинство: два из трёх для R=3. Лидер фиксирует запись, когда она есть у кворума. Так группа продвигается при недоступном меньшинстве и синхронизирует его после возвращения.
Размещение определяет серверы реплик. Ограничьте поток кластером и метками, а лидер метаданных выберет подходящие узлы.
Управление участниками меняет состав. После увеличения числа реплик ждите синхронизации нового узла; переносите реплики по очереди, сохраняя большинство.
Маршруты, RAFT, кворум, размещение и участники — всё остальное, включая сроки, выборы, append entry, применение и миграцию, уточняет эти идеи.
Где искать подробности
Глава объясняет понятия и не привязана к версии. Точные таймеры выборов, формат WAL, поля cluster {} и StreamConfig находятся в версионируемом справочнике. Там ищите типы настроек и сетевой формат маршрутов.
Начните с корня справочника. Все ссылки главы на полные описания ведут туда. Чаще всего нужны:
- Конфигурация
cluster {}и протокол маршрутов — поля формирования кластера. - API потоков и метки серверов — реплики и размещение.
/jszи/raftz— конечные точки мониторинга для показателей CLI.
Связанные главы
Эта глава объясняет механизм под двумя другими: зависимости взаимны.
Топологии выбирают форму: один сервер, кластер, суперкластер или листовые узлы. Оттуда взят east. Там решается, что строить; здесь — как оно согласует и реплицирует данные.
JetStream создал реплицируемый ORDERS. Его Отказ узла кратко вводит R=3, а здесь подробно разобраны выборы и фиксация кворумом. Для копий между кластерами и аварийного восстановления читайте зеркала и источники.
Развёртывание объясняет эксплуатацию на реальной инфраструктуре: Kubernetes, последовательные обновления и расчёт серверов.
Резервное копирование и восстановление защищает данные снимками перед рискованной сменой состава и восстанавливает после неудачной миграции.
Что уже готово
Глава завершена; новых изменений сценария нет. east, избранные лидеры и ORDERS с R=3 продолжают работать. Можно экспериментировать с отказом сервера, пятым участником и размещением либо удалить ORDERS через nats stream rm ORDERS и остановить серверы после работы.
Основная модель освоена: маршруты строят сеть, RAFT согласует, кворум фиксирует записи, размещение выбирает узлы, управление меняет состав без потери согласованности. Это минимум для эксплуатации кластера NATS.
Контрольный список перед эксплуатацией
Здесь собраны действия из типичных ошибок для последней проверки перед реальными заказами. Каждая группа ссылается на объяснение причин.
Формирование кластера — см. Типичные ошибки
- Задайте одинаковый
cluster.nameвсем серверам: несовпадение разделяет систему на кластеры. - Направляйте
routesна маршрутный 6222, а не клиентский 4222. - Укажите два-три начальных адреса, чтобы запуск переживал недоступность одного; gossip достаточно одного доступного.
RAFT и лидеры — см. Типичные ошибки
- Считайте короткую паузу «нет лидера» нормальной: таймер выборов составляет 4–9 секунд, клиент должен повторить запрос.
- Используйте
nats stream cluster step-downдля освобождения роли; победителя выбирает кворум. Читайтеnats stream infoпосле команды. - Различайте группы лидера метаданных и лидера потока: проверяйте
nats server report jetstreamиnats stream info ORDERSсоответственно.
Репликация и R=3 — см. Типичные ошибки
- Для рабочих заказов используйте
R≥3: единственная копияR=1теряется вместе с диском. - Для чтения после записи обращайтесь к лидеру: Direct Get ведомого может вернуть ещё не обновлённые данные.
- Понимайте
PubAckкак наличие кворума, а не всех копий. Перед плановой остановкой проверяйтеcurrentкаждой реплики.
Размещение — см. Типичные ошибки
- Сначала прочитайте фактические метки серверов: пересечение с отсутствующей меткой даёт
no suitable peers for placement. - Проверяйте написание:
ssdиSSDэквивалентны,sdd— другая метка. - Размещение не назначает лидера. Используйте
nats stream cluster step-down --preferredна NATS Server 2.11+, понимая, что выборы могут отклонить пожелание.
Масштабирование и управление участниками — см. Типичные ошибки
- Дождитесь
currentнового участника до опоры на его данные; не останавливайте другой сервер во время синхронизации. -
peer remap failedотnats stream cluster evacuateозначает отсутствие переноса. Исправьте размещение или добавьте место и повторите. - Меняйте число копий через
nats stream edit --replicas: эвакуация меняет только расположение.
Желаемое состояние и эвакуация — см. Типичные ошибки
- Сравнивайте
Desired PeersиReplicaперед отменой: откат почти завершённого переноса требует лишней синхронизации. - Сначала запускайте
nats stream cluster cancel-moveбез--force, чтобы узнать об уже завершённой операции черезstream is not busy moving. - Не начинайте переносы и масштабирование до обновления всех узлов до 2.15. Обновляйтесь с 2.14.7 или новее: старые узлы сохраняют цель, но не завершают её.
- После
nats server cluster evacuateпроверяйте важные потоки: при отсутствии замены они могут остаться с недостатком реплик.
См. также
- Справочник — полный версионируемый набор параметров, флагов, значений и ошибок.
- Топологии — формы системы, включая
east. - JetStream → Отказ узла — краткое введение в реплики.