/nornir_netbox

NetBox plugin for Nornir

Primary LanguagePythonApache License 2.0Apache-2.0

Python 3.6 Python 3.7 Python 3.8 Code Style

nornir_netbox

NetBox plugin for Nornir

The NetBox plugin exposes 2 inventory classes for usage.

  • NBInventory is deprecated and should not be used anymore, it is still available for backwards compatibility only
  • NetBoxInventory2 is 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.

Install

The recommended way to install nornir_netbox is via pip or poetry.

pip install nornir-netbox
poetry add nornir-netbox

Example usage

Using the Nornir configuration file

---
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"

Using the InitNornir function

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"
        }
    }
)

NBInventory arguments

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

NetBoxInventory2 arguments

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)

Useful Links