Exports vCenter objects using the VMware pyVmomi SDK, transforms them into NetBox objects, and syncs them.
The NetBox documentation makes it clear the tool is intended to act as a "Source of Truth". The automated import of live network state is strongly discouraged. While this is sound logic we've aimed to provide a middle-ground solution for those who desire the functionality.
All objects collected from vCenter have a "lifecycle". Upon import, for supported object types, they are tagged "Synced" and "vCenter" to note their origin and distinguish them from other objects. Using this tagging system also allows for the orphaning of objects which are no longer detected in vCenter. This ensures stale objects are removed from NetBox keeping an accurate current state. Note, adding the tag Manual to synced objects will ensure they are not pruned even if they become orphaned.
The following objects are tracked and synced between vCenter and NetBox. Object types which support tags are also eligible to be pruned.
| vCenter | NetBox | Supports Tags |
|---|---|---|
| Datacenters | Cluster Groups | No |
| Clusters | Clusters | Yes |
| Hosts | Manufacturers | No |
| Hosts | Device Types, Devices, Interfaces | Yes |
| Virtual Machines | Platforms | No |
| Virtual Machines | Interfaces, IP Addresses, Virtual Machines | Yes |
The following minimum software versions have been tested for compatibility.
- VMware vCenter 6
- NetBox v2.6.7
The following permissions are required for this script to function.
- VMware vCenter - User account with "Read-only" role on vCenter root scope. The "Propogate to children" setting must also be checked.
- NetBox - API token with "write enabled" permissions. Instructions are available in the NetBox documentation.
- Clone the repository.
- Create a Python Virtual Environment (venv) and activate it.
- Install the package requirements by running
pip install -r requirements.txt. - Copy the
settings.example.pytosettings.pyand fill in the values. - Execute
run.py. - [optional] Schedule a cron job to execute the script on a regular basis.
$ run.py -h
usage: run.py [-h] [-c] [-v]
optional arguments:
-h, --help show this help message and exit
-c, --cleanup Remove all vCenter synced objects which support tagging. This
is helpful if you want to start fresh or stop using this
script.
-v, --verbose Enable verbose output. This overrides the log level in the
settings file. Intended for debugging purposes only.
The following job runs every 4 hours at minute 15. The full paths to python and the script are provided so that the virtual environment instance and packages are used.
# vCenter to NetBox Sync
15 */4 * * * /opt/vcenter-netbox-sync/bin/python /opt/vcenter-netbox-sync/run.py >/dev/null 2>&1