Skip to content

Latest commit

 

History

History
82 lines (56 loc) · 2.23 KB

README.md

File metadata and controls

82 lines (56 loc) · 2.23 KB
Raw

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.