Version 0.0.18
Summary
Version 0.0.18 adds full Proxmox VE 9.2 support to the plugin, including
persisted Django models for SDN fabrics, route maps, prefix lists, and custom
datacenter CPU models; automated sync services for these new objects; completed
node-level firewall sync; and HA arm/disarm action views. It pairs with
backend proxbox-api 0.0.14,
which ships the SDN, CPU-model, and datacenter-options endpoints that power
the new sync services.
The NetBox compatibility range remains 4.5.8 – 4.6.99 (min_version /
max_version unchanged). Django migration 0041_pve_9_2.py adds four tables
and one new column; run manage.py migrate netbox_proxbox after upgrade.
What's New In The Plugin
- SDN model scaffolding. Three new Django models persist Proxmox VE SDN
objects:ProxmoxSdnFabric(WireGuard / BGP / VXLAN / OSPF fabrics),
ProxmoxSdnRouteMap, andProxmoxSdnPrefixList. Full CRUD views, REST API
viewsets, and a new SDN navigation group are included. - Datacenter CPU model scaffolding. New
ProxmoxDatacenterCpuModelmodel
with full CRUD and REST API; listed under the Infrastructure navigation
group. - SDN and CPU-model sync services.
services/sync_sdn.pycalls
GET /proxmox/sdn/fabrics,/sdn/route-maps, and/sdn/prefix-lists.
services/sync_datacenter.pycallsGET /proxmox/datacenter/cpu-models.
Both upsert records and mark removed rows stale. - Completed node-level firewall sync.
services/sync_firewall.pygains
sync_node_firewall()(callsGET /proxmox/firewall/nodes/{node}/rules)
so per-nodeProxmoxFirewallRulerows are populated automatically during
the sync job.sync_vm_firewall()is also implemented and available for
per-VM rule ingestion, but is not yet wired into the automatic sync job. - HA arm/disarm action views.
HaArmViewandHaDisarmViewproxy to
POST /proxmox/cluster/ha/armandPOST /proxmox/cluster/ha/disarmon
the backend. Both requirechange_proxmoxendpointpermission and return
JSON for AJAX callers. ProxmoxNode.locationfield. Stores the geographic or physical location
of a node as reported by PVE 9.2+.
What's New In The Backend (proxbox-api 0.0.14)
The plugin requires proxbox-api >= 0.0.14. The backend release adds:
GET /proxmox/sdn/fabrics,GET /proxmox/sdn/route-maps,
GET /proxmox/sdn/prefix-lists— per-cluster SDN topology reads.GET /proxmox/datacenter/cpu-models— custom CPU model enumeration.GET /proxmox/datacenter/options— datacenter-level options including
CRS (Cluster Resource Scheduling) settings.POST /proxmox/cluster/ha/armandPOST /proxmox/cluster/ha/disarm—
cluster HA arm/disarm verbs (write-gated byallow_writes).GET /proxmox/cluster/ha/manager-status— HA manager state endpoint.- Extended node config:
locationfield in node config responses. - Access token management endpoints.
Compatibility
| NetBox | netbox-proxbox | proxbox-api | netbox-sdk | proxmox-sdk |
|---|---|---|---|---|
| >=4.5.8 | v0.0.18 | v0.0.14 | v0.0.8.post1 | v0.0.3.post1 |
| >=4.5.8 | v0.0.17 | v0.0.13 | v0.0.8.post1 | v0.0.3.post1 |
NetBox compatibility range: 4.5.8 – 4.6.99 (unchanged). Certified
simultaneously against NetBox v4.5.8, v4.5.9, v4.6.0, and v4.6.1.
Upgrade Notes
- Run
manage.py migrate netbox_proxbox— migration0041_pve_9_2.py
creates theproxmoxsdnfabric,proxmoxsdnroutemap,proxmoxsdnprefixlist,
andproxmoxdatacentercpumodeltables and adds thelocationcolumn to
proxmoxnode. - Upgrade the backend to
proxbox-api 0.0.14before the plugin so the
/proxmox/sdn/*and/proxmox/datacenter/cpu-modelsroutes are available. - Restart the NetBox WSGI process after migration and static-file collection.
- The read-only reflection path for existing objects is unchanged.