Установка плагина

Внимание

Приведённые ниже инструкции описывают общий процесс установки и настройки плагина InfraVision. Однако каждый плагин отличается и может требовать дополнительных задач или изменений в описанных ниже шагах. Всегда консультируйтесь с документацией конкретного плагина перед попыткой его установки.

Установка Python-пакета

Скачайте и установите Python-пакет плагина согласно его инструкциям по установке. Плагины, опубликованные через PyPI, обычно устанавливаются с помощью утилиты командной строки pip. Обязательно устанавливайте плагин в виртуальном окружении InfraVision.

$ source /opt/netbox/venv/bin/activate
(venv) $ pip install <package>

В качестве альтернативы вы можете установить плагин вручную, выполнив python setup.py install. Если вы разрабатываете плагин и хотите установить его только временно, выполните вместо этого python setup.py develop.

Включение плагина

В configuration.py добавьте имя плагина в список PLUGINS:

PLUGINS = [
    # ...
    'plugin_name',
]

Настройка плагина

Если плагин требует какой-либо конфигурации, определите её в configuration.py в параметре PLUGINS_CONFIG. Доступные параметры конфигурации должны быть описаны в файле README плагина или другой документации.

PLUGINS_CONFIG = {
    'plugin_name': {
        'foo': 'bar',
        'buzz': 'bazz'
    }
}

Выполнение миграций базы данных

Если плагин вводит новые модели базы данных, выполните предоставленные миграции схемы:

(venv) $ cd /opt/netbox/netbox/
(venv) $ python3 manage.py migrate

Совет

Можно выполнять команду управления migrate, даже если плагин не включает файлы миграций.

Сбор статических файлов

Плагины могут включать статические ресурсы, такие как изображения или скрипты, для прямой отдачи HTTP-сервером. Убедитесь, что они скопированы в каталог статических файлов с помощью команды управления collectstatic:

(venv) $ cd /opt/netbox/netbox/
(venv) $ python3 manage.py collectstatic

Перезапуск службы WSGI

Наконец, перезапустите службу WSGI и RQ workers для загрузки нового плагина:

# sudo systemctl restart netbox netbox-rq