/netbox-path

Netbox Path is a plugin for Netbox that lets you draw logical paths between objects

Primary LanguageJavaScript

NetBox Path

This is a plugin for NetBox that allows you to create visual and queryable maps of logical paths within your infrastructure. This allows for impact assessment and monitoring integration.

The models are implemented using Cytoscape JS and built using Vite.

Demo deployment

the demo branch deploys to a gitlab runner on netbox-path.sol1.net pushing to that branch will trigger a new deployment for the demo

Front-end development

  • cd frontend
  • npm install
  • npm run dev

To release

  • cd frontend && ./build.sh && cd $OLDPWD
  • Bump version in netbox_path/__init__.py and setup.py
  • python setup.py sdist writes new tarball to dist/

To deploy to a Netbox

  • cd /srv/netbox/current && source venv-py3/bin/activate
  • Add to Netbox's local_requirements.txt something like

netbox-path @ file:///srv/netbox/current/contrib/netbox_path-0.2.4.tar.gz

  • PYTHON=/usr/bin/python3 ./upgrade.sh

Each user must create an API token with write permissions. The plugin will automatically use it.