Управление конфигурацией сервиса
Для получения конфигурации сервисы Атомкод используют стандартные механизмы .NET, а именно:
- провайдеры источников конфигурации;
- интерфейс
IConfigurationдля доступа к параметрам конфигурации.
Базовые классы сервиса Атомкод подключают предопределенный список провайдеров конфигурации в порядке, указанном в следующей таблице.
| № п/п | Источник | Комментарии |
|---|---|---|
| 1 | Файл appsettings.json | Используется с учетом типа среды, например, Development |
| 2 | Переменные окружения | Используется для задания параметров, используемых при запуске сервиса до доступа к сервису конфигураций |
| 3 | Сервис конфигураций Атомкод | Управлять этим источником можно с помощью свойства UseDiscoveryConfiguration класса StartParameters |
| 4 | Дополнительные файлы конфигурации | Необязательный источник. Список дополнительных файлов конфигурации можно задать с помощью свойства AdditionalConfigurationFilesNames класса StartParameters |
| 5 | Переменные окружения (повторно) | Используется последним с целью переопределить параметры с помощью переменных окружения, указанных в любом предыдущем источнике |
Если сервис конфигураций Атомкод включен в список источников конфигурации с помощью параметра класса StartParameters, при запуске разрабатываемый сервис будет ожидать доступности сервиса конфигураций и продолжит запуск только после получения конфигурации из этого источника.
При локальной отладке разрабатываемого сервиса удобнее использовать файл(ы) конфигурации appsettings.json, appsettings.Development.json или указывать параметры через переменные окружения, например, используя файл launchSettings.json. Сервис конфигураций можно отключить.
В эксплуатационной среде рекомендуется задавать большинство параметров через сервис конфигураций. Такой подход позволяет централизованно управлять конфигурированием, поддерживать версии конфигураций и связывать их с версиями сервисов, а также настраивать сервисы при горизонтальном масштабировании.
Не рекомендуется включать файлы конфигурации appsettings.json, appsettings.Development.json в образ Docker-контейнера.