Перейти к основному содержимому

0.7.0

Совместимость с платформой​

NetBox module в версии 0.7.0 ориентирован на Solar LightHouse 1.7.5 и собран на ModuleSDK 1.7.5.

Что изменилось и зачем​

  • конфигурация разбита на логические группы (netbox-connection, netbox-scope, netbox-filters, netbox-collection) — параметры стало проще читать и заполнять;
  • режимы interface_collection_mode и metadata_mode переведены со строки на тип Enum с фиксированным списком значений;
  • поля «Ответственный» и «Зона» убраны из конфигурации — назначаются платформой из контекста сканирования;
  • MAC интерфейса читается из primary_mac_address / mac_addresses (NetBox 4.2+ и 4.6) с откатом на устаревшее поле mac_address;
  • интерфейсы собираются одним проходом (режим bulk); по IP-адресам создаются сети, а у интерфейса заполняется привязка к сети.

Таблица параметров​

ГруппаИмя параметраОбязательныйЗначение по умолчаниюДля чего параметрПример заполнения
Подключение и аутентификацияURL NetBox (netbox-connection.netbox_url)даhttps://netbox.example.localБазовый адрес NetBox без суффикса /apihttp://10.150.0.35:8000
Подключение и аутентификацияТокен API NetBox (netbox-connection.netbox_token)да[[NETBOX_API_TOKEN]]API-токен NetBox с правами только на чтение DCIM, Virtualization и IPAM. Рекомендуется хранить в Секретах[[NETBOX_API_TOKEN]]
Подключение и аутентификацияПроверять TLS-сертификат (netbox-connection.verify_ssl)нетtrueПроверять доверенность TLS-сертификата NetBoxfalse
Что собираемИмпортировать физические устройства (netbox-scope.include_devices)нетtrueСоздавать хосты на основе dcim/devicestrue
Что собираемИмпортировать виртуальные машины (netbox-scope.include_virtual_machines)нетtrueСоздавать хосты на основе virtualization/virtual-machinestrue
Что собираемИмпортировать сетевые интерфейсы (netbox-scope.include_interfaces)нетtrueДобавлять к хостам сетевые интерфейсы из NetBoxtrue
Что собираемПривязывать IP-адреса к интерфейсам (netbox-scope.collect_ip_addresses)нетtrueЗагружать ipam/ip-addresses и сопоставлять с интерфейсамиtrue
Что собираемИмпортировать префиксы IPAM (netbox-scope.include_prefixes)нетfalseСоздавать сети на основе ipam/prefixesfalse
Фильтры NetBoxСтатус устройств (netbox-filters.device_status)нетactiveФильтр по статусу устройств; пусто — без фильтраactive
Фильтры NetBoxСтатус виртуальных машин (netbox-filters.vm_status)нетactiveФильтр по статусу ВМ; пусто — без фильтраactive
Фильтры NetBoxПлощадка (netbox-filters.site)нет(пусто)Фильтр по slug площадки NetBoxmsk-dc-1
Фильтры NetBoxTenant (netbox-filters.tenant)нет(пусто)Фильтр по slug tenant в NetBoxdunder-mifflin
Фильтры NetBoxТег (netbox-filters.tag)нет(пусто)Фильтр по slug тега NetBoxmonitored
Детали сбораРежим сбора интерфейсов (netbox-collection.interface_collection_mode)нетbulkДопустимые значения: bulk, per_objectbulk
Детали сбораРежим передачи metadata (netbox-collection.metadata_mode)нетnoneДопустимые значения: none, basicnone
Детали сбораРазмер страницы API (netbox-collection.page_size)нет200Количество объектов за один запрос к API NetBox100
Детали сбораТаймаут запроса, сек (netbox-collection.timeout)нет30Таймаут одного HTTP-запроса к NetBox60
Детали сбораКоличество повторов запросов (netbox-collection.max_retries)нет2Сколько раз повторять запрос при ошибке или timeout2
Детали сбораПауза между повторами, сек (netbox-collection.retry_backoff_seconds)нет1.0Базовая пауза между повторными запросами1.0
Детали сбораПропускать endpoint при timeout (netbox-collection.skip_timed_out_endpoints)нетtrueПропустить endpoint после повторов и продолжить импортtrue
Детали сбораПауза между запросами, сек (netbox-collection.request_pause_seconds)нет0.0Дополнительная пауза между запросами к NetBox0.0
Детали сбораОстанавливать при ошибке объекта (netbox-collection.fail_on_object_error)нетfalseОстанавливать весь запуск при ошибке отдельного объектаfalse