# git clone https://github.com/netboxlabs/netbox-proxmox-automation/
# cd netbox-proxmox-automation
# python3 -m venv venv
# source venv/bin/activate
(venv) # pip install -r requirements.txt
(venv) # mkdocs serve
INFO - Building documentation...
INFO - Cleaning site directory
INFO - The following pages exist in the docs directory, but are not included in the "nav" configuration:
- Administration Console/console-overview.md
- NetBox Cloud/getting-started-with-nbc.md
INFO - Documentation built in 0.75 seconds
INFO - [13:37:39] Watching paths for changes: 'docs', 'mkdocs.yml'
INFO - [13:37:39] Serving on http://127.0.0.1:8000/
If you see errors like this...
ERROR - Config value 'theme': Unrecognised theme name: 'material'. The available installed themes are: mkdocs, readthedocs ERROR - Config value 'markdown_extensions': Failed to load extension 'pymdownx.tabbed'. ModuleNotFoundError: No module named 'pymdownx'
Try uninstalling mkdocs from your package manager, (e.g. brew uninstall mkdocs) and just using the version installed by pip. It seems that mkdocs doesn't like it when you've installed it using different methods.
- Switches to calendar (as opposed to semantic) versioning
- Adds Proxmox cluster and node(s) discovery through a new convenience script
- Adds Proxmox VM migration to alternate Proxmox node(s) through events
- Adds NetBox Branching support for Proxmox node and VM discovery
- Nate Patwardhan <[email protected]>
- Only supports SCSI disk types (this is possibly fine as Proxmox predomininantly provisions disks as SCSI)
- LXC migration is not supported for myriad reasons
- Proxmox "tags" are not supported (seeking community feedback around use cases)
- Use of NetBox Custom Objects for NetBox > 4.4
- DNS update support via gss-tsig (requires NetBox
netbox-dnsplugin) - Integration with NetBox Discovery/Assurance