Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/netboxlabs/netbox-proxmox-automation
NetBox event driven automation for Proxmox
https://github.com/netboxlabs/netbox-proxmox-automation
automation awx awx-ansible flask-application netbox network proxmox
Last synced: 10 days ago
JSON representation
NetBox event driven automation for Proxmox
- Host: GitHub
- URL: https://github.com/netboxlabs/netbox-proxmox-automation
- Owner: netboxlabs
- License: apache-2.0
- Created: 2024-06-07T20:21:50.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-01-24T22:10:15.000Z (11 days ago)
- Last Synced: 2025-01-24T22:26:49.218Z (11 days ago)
- Topics: automation, awx, awx-ansible, flask-application, netbox, network, proxmox
- Language: Python
- Homepage:
- Size: 10.6 MB
- Stars: 25
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# netbox-proxmox-automation
## Clone and step into the repo
```
# git clone https://github.com/netboxlabs/netbox-proxmox-automation/
# cd netbox-proxmox-automation
```
## Install required python packages
```
# python3 -m venv venv
# source venv/bin/activate
(venv) # pip install -r requirements.txt
```
## Run mkdocs
```
(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/
```
## :warning:
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.
# Developers
- Nate Patwardhan <[email protected]>
# Known Issues / Roadmap
## Known Issues
- *Only* supports SCSI disk types (this is possibly fine as Proxmox predomininantly provisions disks as SCSI)
- Does not currently support Proxmox VM creation to a Proxmox cluster, but is only node-based
- Needs better reconciliation on the NetBox end when Proxmox->NetBox discovery is used
## Roadmap -- Delivery
- DNS update support (requires NetBox `netbox-dns` plugin)
- Maybe evolve into to a NetBox plugin for Proxmox