Storage (st)

Содержание

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

Описание

Универсальное хранилище сайта. Используется различными ролями как внутренний сервис.

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

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

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

Ограничения

Присутствует в начальной конфигурации.
Должна присутствовать на каждом сайте.
При недоступности роли большинство сервисов не функционируют, в том числе невозможна загрузка системы.

Параметры

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

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

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

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

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

Пример узла

{
  "st1": {
    "name": "store1",
    "roletype": "st",

    "group": "11080",
    "order": "1"
  }
}

См. также

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