States & Subscriptions Storage (sts)

Содержание

Описание
Ограничения
Параметры
Пример конфигурации
См. также

Описание

Хранилище состояний и подписок на изменения состояний пользователей системы и SIP-пользователей.
Уведомляет подписчиков о смене интегральных состояний учетных записей. Каждая запись регистрируется на время и периодически продляется.

Разделена на микросервисы по доменам. Данные автоматически синхронизируются между сайтами, обслуживающими домен.
Резервируется в режиме Active-Passive. Масштабируется разделением доменного дерева.

Table 1. Системные характеристики

Код	`sts`
Режим работы	`Хранилище, сервис`
Режим резервирования	`Active-Passive`
Типы сайтов	`Любые`
Слой	`Бизнес-логика`
Размещение	`Внутренний`
Сохранение и восстановление состояния при перезагрузке	`Да`
Приложение	`era_state`
Собственное хранилище	`ODB Mnesia`

Ограничения

События о смене состояний, генерируемые ролью для брокеров сообщений, дублируют данные на всех сайтах, где обслуживается домен. В тот момент, когда сайты недоступны друг для друга, данные по домену в хранилищах разных сайтов могут различаться. Это также приводит к дублям в БД, куда события складываются получателями сообщений с разных сайтов, при условии их одинаковых настроек подключения.
Отправку событий о смене состояний подписчику производит экземпляр того сайта, который принял и обработал подписку.

Параметры

Описание столбцов в таблице

Table 2. Параметры
Имя	Тип	Умолчание	Описание
`name`	`str`	required	Имя. Может состоять из латинских букв и цифр, должно начинаться с буквы.
`roletype`	`str`	required	Тип роли. Возможные значения: `"sts"`.
`iface`	`str`	required	Алиас сетевого интерфейса сервера, на котором будет происходить внутреннее взаимодействие ролей между собой.
`ext`	`json`	empty	Дополнительные опции роли. Содержит json объект или список.
`enabled`	`bool`	empty	Флаг активности роли. При установке в false роль не участвует в валидации и не запускается.
`group`	`int`	required	Номер группы. В рамках горизонтального масштабирования роль может быть разделена на несколько групп на сайте, в каждой из которых активен только один экземпляр, а остальные зарезервированы. Ответственность между группами разделяется по доменным множествам. Вместе все группы обслуживают полное доменное множество. Все роли одной группы должны иметь одинаковую ответственность. Целое число от `1` до `9999999`.
`order`	`int`	required	Порядок экземпляра роли в рамках группы. Определяет в каком порядке будет происходить перетекание в режиме Active-Passive.
`include_domains`	`array<str>`	empty	Список имен доменов, которые обслуживает данная группа. Может быть указан любой домен любого уровня. Указание домена приводит к тому, что дерево его поддоменов будет обслуживаться на этой группе и не будет обслуживаться на других группах роли, исключая только те ветви, которые упомянуты в других группах. В совокупности все группы роли на сайте обслуживают полное дерево доменов.
`mnesia_storage_mode`	`str`	`disc` "Режим работы объектного хранилища.	Возможные варианты:
`* disc - полный режим`	`в оперативной памяти с сохранением на диск на всех экземплярах группы.`	ram - только в оперативной памяти (с поддержкой распределенности	транзакций). При одновременной перезагрузке/выключении всех экземпляров группы данные теряются.

Пример конфигурации

Управление конфигурацией производится в приложении, доступном для администраторов мастер-домена. Приложение скрывает полное содержание конфигурации, однако тем не менее оно доступно через API.

Конфигурация содержит раздел для описания всех экземпляров всех ролей. Параметры определяются для каждого конкретного экземпляра роли.

Пример узла

{
  "name": "statestore1",
  "roletype": "sts",
  "iface": "eth0",

  "group": 11070,
  "order": 2,

  "include_domains": [
    "dev.rootdomain.ru"
  ]
}

См. также

Конфигурация