Источники конфигурации сервера

Источники конфигурации сервера

Источники конфигурации сервера ​

Начиная с v.3.19.94 параметры сервера можно загружать не только из текстового файла saymon-server.conf, но и из внешних источников. Это удобно для кластерных и контейнерных развёртываний.

Источники ​

Поддерживаются:

ИсточникНазначение
Текстовый файл на дискеКлассический saymon-server.conf / YAML / JSON
Документ в MongoDBКоллекция конфигурации в БД saymon
Redis / ValkeyНабор «ключ–значение»
ConsulKV-хранилище Consul

Список можно расширить собственным «транспортным» классом источника.

Форматы ​

  • JSON — основной формат (по умолчанию);
  • YAML;
  • JavaScript — только для файлов на диске (совместимость со старыми конфигурациями).

Можно одновременно указать любое число источников и форматов. Полученные фрагменты объединяются в один объект конфигурации; при необходимости выполняется автоматическая дешифрация.

Загрузка по умолчанию ​

Если переменная окружения SERVER_CONFIG не задана, сервер загружает конфигурацию в порядке:

  1. файл saymon-server.conf из директории запуска;
  2. файл /etc/saymon/saymon-server.conf;
  3. первый документ коллекции configuration базы saymon локальной MongoDB (пользовательская конфигурация).

Явное указание источников (SERVER_CONFIG) ​

Перед запуском можно задать список URL источников (через пробел):

bash
export SERVER_CONFIG='file:///home/user/test.yaml redis://?key=config consul:///v1/kv/config mongo:///saymon/configuration'

Если SERVER_CONFIG задана, загрузка идёт только из указанных URL.

Дополнительно можно задать переменные с префиксом SERVER_CONFIG_. Их значения подставляются в маркеры {{...}} внутри URL. Например, SERVER_CONFIG_login подставляет значение в {{login}}.

Пользовательская конфигурация ​

После основных источников загружается пользовательская конфигурация:

  • по умолчанию — URL формируется из db.mongodb.url серверной конфигурации;
  • явно — в серверной конфигурации задаётся db.userConfiguration.url.

Пример явного указания документа MongoDB:

json
{
  "db": {
    "mongodb": {
      "url": "mongodb://localhost:27017/saymon?w=1"
    },
    "userConfiguration": {
      "url": "mongo://192.168.100.134:27017/saymon/configuration/?filter={\"_id\":1}&field=parameters"
    }
  }
}

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