Импорт устройств в Netbox с помощью CSV, JSON, YAML

Если у вас есть большое количество серверов, сетевых и других устройств то для управления инфраструктурой, то можно использовать один из самых популярных инструментов - NetBox, он упрощает инвентаризацию и автоматизацию задач. Однако если устройств много ручной их ввод может быть трудоёмким. В этой статье хочу рассмотреть пошаговый процесс импорта устройств в NetBox с помощью файлов форматов .csv, .json и .yaml, чтобы ускорить переход и избежать проблем при заполнении данных.

1.Для начала создаем файл

Поля должны называться согласно страницы импорта в Netbox

Примеры csv файлов

1.devices.csv

2.interface.csv

3.ipaddress.csv

4.cable.csv

Нельзя повторять название устройств в столбце name название AP_01 и AP_01 одинаковы, даже если адреса разные

Если необходимо перед\после во все столбы добавить одно и тоже слово, например "/24"

В Libreoffice можно с помощью "Найти и заменить" выделить нужные ячейки и установить "птички" "Регулярное выражение" и "Только текущее

выделение"\

В поле Найти:^.* карет\циркумфлекс (крышечка, домик), точка, звёздочка

В поле **Заменить на *&/24

2.Сохранить файл xlsx в формат csv

В LibreOffice выбрать Файл - Сохранить как…, с такими параметрами

3.Для конвертации в JSON формат можно выбрать любой онлайн ресурс, например Convert CSV to JSON

https://www.convertcsv.com/csv-to-json.htm

Step 1: Select your input - Choose File - Нажать кнопку обзор

Скачать json файл, нажав Download Result

4.Импорт файла в формате JSON

Переходим на страницу Devices (или другую страницу для которой предназначен файл), выбираем Import, далее нажать Upload file

Внизу видим Field Options:

Field - это название поля в таблице Excel,

Required (если стоит галочка - обязательный параметр, должен быть в таблице)

Остальные поля необязательные

У некоторых строк справа есть знак вопроса, можно узнать какое значение нужно указывать для поля * (например для поля status значение указываем из столбца Import Value)

Если каких то обязательных полей нет в Netbox

Идём в соответствующий раздел и создаём их начиная с шага один. Для примера поле device_type.Переходим на страницу Device Types, далее можно добавить вручную если типов устройств немного или следуя первому шагу.

При успешном импорте появятся добавленная таблица и надпись Imported <кол-во устройств> devices (импортировал сначала по 50, потом решил около 300 импортировать всё прошло успешно, только долго ждать) Если покажет ошибку то смотреть её описание (скорей всего это неправильно названы столбцы, нет такого устройства, возможно пробел в ячейку попал).

Заключение

Импорт данных в NetBox с использованием форматов .csv, .json или .yaml даёт возможность значительно упростить и ускорить администрирование и поддержание актуальности вашего списка оборудования. Следуя приведённым выше шагам, можно без лишних ошибок загрузить устройства, интерфейсы, адреса и другие данные, а также быстро адаптировать данный процесс под собственные нужды.

Остальные изображения по ссылке https://github.com/solizarevich/netbox-import
(больше одного не дает добавить)