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

Файл конфигурации

Файл конфигурации InfraVision содержит все важные параметры, которые управляют работой InfraVision: настройки базы данных, элементы управления безопасностью, пользовательские настройки и так далее. Хотя конфигурация по умолчанию подходит для большинства случаев использования сразу после установки, есть несколько обязательных параметров, которые должны быть определены во время установки.

Файл конфигурации загружается из $INSTALL_ROOT/netbox/netbox/configuration.py по умолчанию. Пример конфигурации предоставлен в configuration_example.py, который вы можете скопировать для использования в качестве конфигурации по умолчанию. Обратите внимание, что файл конфигурации должен быть определён; InfraVision не запустится без него.

Информация

Пользовательский модуль конфигурации может быть указан путём установки переменной окружения NETBOX_CONFIGURATION. Это должен быть путь с точками к желаемому Python-модулю. Например, файл с именем my_config.py в том же каталоге, что и settings.py, будет указан как netbox.my_config.

Для простоты документация InfraVision называет файл конфигурации просто configuration.py.

Некоторые параметры конфигурации могут быть определены либо в configuration.py, либо в административном разделе пользовательского интерфейса. Настройки, которые "жёстко закодированы" в файле конфигурации, имеют приоритет над определёнными через интерфейс.

Динамические параметры конфигурации

Некоторые параметры конфигурации в основном управляются через административный интерфейс InfraVision (в разделе Администрирование > Дополнительно > Ревизии конфигурации). Они отмечены там, где это применимо, в документации. Эти настройки также могут быть переопределены в configuration.py, чтобы предотвратить их изменение через интерфейс. Полный список поддерживаемых параметров приведён ниже:

• ALLOWED_URL_SCHEMES
• BANNER_BOTTOM
• BANNER_LOGIN
• BANNER_TOP
• CHANGELOG_RETENTION
• CUSTOM_VALIDATORS
• DEFAULT_USER_PREFERENCES
• ENFORCE_GLOBAL_UNIQUE
• GRAPHQL_ENABLED
• JOB_RETENTION
• MAINTENANCE_MODE
• MAPS_URL
• MAX_PAGE_SIZE
• PAGINATE_COUNT
• POWERFEED_DEFAULT_AMPERAGE
• POWERFEED_DEFAULT_MAX_UTILIZATION
• POWERFEED_DEFAULT_VOLTAGE
• PREFER_IPV4
• RACK_ELEVATION_DEFAULT_UNIT_HEIGHT
• RACK_ELEVATION_DEFAULT_UNIT_WIDTH

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

Файл конфигурации может быть изменён в любое время. Однако WSGI-сервис (например, Gunicorn) должен быть перезапущен, прежде чем эти изменения вступят в силу:

$ sudo systemctl restart netbox

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