The NetBox plugin exposes 2 inventory classes for usage.
NBInventoryis deprecated and should not be used anymore, it is still available for backwards compatibility onlyNetBoxInventory2is the recommended NetBox inventory plugin. It provides some extra functionality such as exposing all NetBox device attributes to the Nonir Host through the data attribute. It is the recommended plugin to use. All feature development will only take place on this plugin.
The recommended way to install nornir_netbox is via pip or poetry.
pip install nornir-netboxpoetry add nornir-netbox---
inventory:
plugin: NBInventory
options:
nb_url: "https://netbox.local"
nb_token: "123_NETBOX_API_TOKEN_456"---
inventory:
plugin: NetBoxInventory2
options:
nb_url: "https://netbox.local"
nb_token: "123_NETBOX_API_TOKEN_456"from nornir import InitNornir
nr = InitNornir(
inventory={
"plugin":"NBInventory",
"options": {
"nb_url": "https://netbox.local",
"nb_token": "123_NETBOX_API_TOKEN_456"
}
}
)from nornir import InitNornir
nr = InitNornir(
inventory={
"plugin":"NetBoxInventory2",
"options": {
"nb_url": "https://netbox.local",
"nb_token": "123_NETBOX_API_TOKEN_456"
}
}
)Arguments:
nb_url: NetBox url, defaults to http://localhost:8080.
You can also use env variable NB_URL
nb_token: NetBox token. You can also use env variable NB_TOKEN
use_slugs: Whether to use slugs or not
ssl_verify: Enable/disable certificate validation or provide path to CA bundle file
flatten_custom_fields: Whether to assign custom fields directly to the host or not
filter_parameters: Key-value pairs to filter down hosts
Environment Variables:
* ``NB_URL``: Corresponds to nb_url argument
* ``NB_TOKEN``: Corresponds to nb_token argument
Arguments:
nb_url: NetBox url (defaults to ``http://localhost:8080``)
nb_token: NetBox API token
ssl_verify: Enable/disable certificate validation or provide path to CA bundle file
(defaults to True)
flatten_custom_fields: Assign custom fields directly to the host's data attribute
(defaults to False)
filter_parameters: Key-value pairs that allow you to filter the NetBox inventory.
include_vms: Get virtual machines from NetBox as well as devices.
(defaults to False)
use_platform_slug: Use the NetBox platform slug for the platform attribute of a Host
(defaults to False)
use_platform_napalm_driver: Use the Netbox platform napalm driver setting for the platform attribute of a Host
(defaults to False)
group_file: path to file with groups definition. If it doesn't exist it will be skipped
defaults_file: path to file with defaults definition. If it doesn't exist it will be skipped
Only one of use_platform_slug and use_platform_napalm_driver can be set to true.
This feature allows you to use SimpleInventory groups and defaults file with NetBoxInventory2. NetBoxInventory2 will automatically create groups for specific attributes of NetBox devices or virtual-machines. The following attributes will be used to create groups:
- site
- platform
- device_role
- device_type
- manufacturer (extracted from device_type)
From these attributes we will use the slug property to create the group. Groups will be created using the following format attribute__slug.
For example, assume a device that is part of a site Site 1 for which the slug is site-1. NetBoxInventory2 will create a group with the name site__site-1 and add the device to the group.
These groups can then be used in a groups file and you can add data to them, similar to how the SimpleInventory plugin works. More information on on the defaults and groups file can be found in Nornir's documentation.
from nornir import InitNornir
nr = InitNornir(
inventory={
"plugin":"NBInventory",
"options": {
"nb_url": "https://netbox.local",
"nb_token": "123_NETBOX_API_TOKEN_456",
"group_file": "inventory/groups.yml",
"defaults_file": "inventory/defaults.yml"
}
}
)