netbox-cesnet-services-plugin 2.1.0b1

NetBox plugin for CESNET services.

NetBox cesnet_services Plugin

NetBox plugin for CESNET services.

• Free software: MIT
• Documentation: https://kani999.github.io/netbox-cesnet-services-plugin/

Features

Enables CESNET services in Netbox. BGP connections, LLDP Neigbors, LLDP Leafs

Compatibility

NetBox Version	Plugin Version	Notes
4.5.4+	2.1.0	last_seen field, bulk ops, status badges
4.5.4+	2.0.1	GraphQL fix: StrFilterLookup replaces FilterLookup[str]; requires NetBox 4.5.4
4.5.0–4.5.3	2.0.0	Breaking change: Filter system updated, NOT compatible with 4.4.x
4.4.x	1.2.8	Last version compatible with NetBox 4.4.x
4.4.0	1.2.5
4.3.1	1.2.4
4.3.1	1.2.3
4.2.8	1.2.2

Installing

For adding to a NetBox Docker setup see the general instructions for using netbox-docker with plugins.

Prerequisites

• NetBox 4.5.4 or higher (for plugin version 2.1.0)
  • Important: Plugin version 2.1.0 requires NetBox 4.5.4 due to StrFilterLookup (ships with strawberry-graphql-django >= 0.79.0). Starting the plugin on NetBox 4.5.0–4.5.3 will raise an ImportError.
  • For NetBox 4.5.0–4.5.3, use plugin version 2.0.0
  • For NetBox 4.4.x, use plugin version 1.2.8 or earlier

Installation

You can install with pip:

pip install netbox-cesnet-services-plugin

or by adding to your local_requirements.txt or plugin_requirements.txt (netbox-docker):

# For NetBox 4.5.4+
netbox-cesnet-services-plugin==2.1.0

# For NetBox 4.5.0–4.5.3
# netbox-cesnet-services-plugin==2.0.0

# For NetBox 4.4.x (use 1.2.8 or earlier)
# netbox-cesnet-services-plugin==1.2.8

Configuration

Enable the plugin in /opt/netbox/netbox/netbox/configuration.py, or if you use netbox-docker, your /configuration/plugins.py file.

You can optionally set device platforms for filtering choices in LLDPNeighbor form:

PLUGINS = [
    'netbox_cesnet_services_plugin'
]

PLUGINS_CONFIG = {
    "netbox_cesnet_services_plugin": {
        "platforms" : ["ios", "iosxe", "iosxr", "nxos", "nxos_ssh"],
        "bgp_last_seen_warning_days": 2,   # days until last_seen badge turns orange (default: 2)
        "bgp_last_seen_danger_days": 5,    # days until last_seen badge turns red (default: 5)
    },
}

Credits

Based on the NetBox plugin tutorial:

• demo repository
• tutorial

This package was created with Cookiecutter and the netbox-community/cookiecutter-netbox-plugin project template.