Источники конфигурации сервера
Начиная с v.3.19.94 параметры сервера можно загружать не только из текстового файла saymon-server.conf, но и из внешних источников. Это удобно для кластерных и контейнерных развёртываний.
Источники
Поддерживаются:
| Источник | Назначение |
|---|---|
| Текстовый файл на диске | Классический saymon-server.conf / YAML / JSON |
| Документ в MongoDB | Коллекция конфигурации в БД saymon |
| Redis / Valkey | Набор «ключ–значение» |
| Consul | KV-хранилище Consul |
Список можно расширить собственным «транспортным» классом источника.
Форматы
- JSON — основной формат (по умолчанию);
- YAML;
- JavaScript — только для файлов на диске (совместимость со старыми конфигурациями).
Можно одновременно указать любое число источников и форматов. Полученные фрагменты объединяются в один объект конфигурации; при необходимости выполняется автоматическая дешифрация.
Загрузка по умолчанию
Если переменная окружения SERVER_CONFIG не задана, сервер загружает конфигурацию в порядке:
- файл
saymon-server.confиз директории запуска; - файл
/etc/saymon/saymon-server.conf; - первый документ коллекции
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"
}
}
}См. также описание разделов файла в Конфигурация сервера.