Skip to content

NetBox ACI Plugin#

The NetBox plugin for Cisco ACI allows NetBox to document ACI specific objects like Tenants (TN), Application Profiles (AP), Endpoint Groups (EPG), Bridge Domains (BD) and Contexts (CTX) / Virtual Routing and Forwarding (VRF).

Documentation: https://pheus.github.io/netbox-aci-plugin/

Features#

  • Tenants
  • Application Profiles
  • Endpoint Groups
  • Bridge Domains
  • VRF

Compatibility#

NetBox Version Plugin Version
4.1 0.0.9

Installing#

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

While this is still in development and not yet on pypi, you can install with pip:

pip install git+https://github.com/pheus/netbox-aci-plugin

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

git+https://github.com/pheus/netbox-aci-plugin

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

PLUGINS = [
    'netbox_aci_plugin'
]

PLUGINS_CONFIG = {
    "netbox_aci_plugin": {
        # create default ACI Tenants "common", "infra", "mgmt" during migration
        "create_default_aci_tenants": True,
    },
}

Status#

This project has just started and provides a minimal set of ACI object features. It may contain bugs and it is missing features. At the current stage, the plugin should be used in testing environment only.

Release notes#

See the changelog.

Licensing#

GNU General Public License v3.0 or later.

See LICENSE to see the full text.

Credits#

Based on the NetBox plugin tutorial:

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