emersonfelipesp/netbox-proxbox v0.0.9

netbox-proxbox v0.0.9

on GitHub

🎉 v0.0.9 Release

New Features

Storage Management

• ProxmoxStorage Model: New data model for tracking Proxmox storage datastores in NetBox
  • Links to virtual disks, backups, and snapshots
  • Storage usage tracking with live updates
  • Enhanced storage detail page with related objects

VM Snapshots & Backups

• VMSnapshot Model: Sync Proxmox VM snapshots into NetBox

  • Timestamp and size tracking
  • Linked to parent VMs and storage
  • CRUD views and list filtering

• VMBackup Model: Sync Proxmox VM backup jobs and restore points

  • Backup metadata and scheduling info
  • Storage location tracking
  • Backup status and size monitoring

Task History

• VMTaskHistory Model: Track Proxmox async tasks and operations
  • Task execution logs and status
  • Detailed error tracking
  • Full CRUD views for audit trails

Sync Enhancements

• Per-VM Sync: Added "Sync Now" action on individual VM detail pages

  • Selective syncing of specific virtual machines
  • Improved UI responsiveness with per-VM actions

• Snapshots in Full Update: Added snapshots to the full synchronization pipeline

  • Complete Proxmox infrastructure discovery
  • Multi-stage sync orchestration

• Configurable Fetch Concurrency: New plugin setting to tune backend sync performance

  • Balance between throughput and resource usage
  • Per-endpoint configuration support

Job UI & Real-time Progress

• Live SSE Streaming: Real-time job progress via Server-Sent Events

  • Live log streaming to NetBox UI
  • Stage-based progress tracking
  • Better visibility into long-running sync operations

• Stage Progress Bar: Visual progress indication for multi-stage sync jobs

  • Clear breakdown of sync phases (Devices → Storage → Snapshots → Backups)
  • Real-time status updates

Improvements & Fixes

UI/UX

• Improved job progress bar layout and styling
• Fixed storage detail page empty Summary card handling
• Added links to all dashboard count values for quick navigation
• Enhanced endpoint status badges with connectivity details
• Removed redundant log message divs from plugin pages

Data Integrity

• Fixed serializer, viewset, and error handling issues
• Improved error handling and backpressure management
• Enhanced thread-safety in job processing
• Better timeout configuration for long-running operations

Backend Integration

• Fixed URL namespace errors in job live polling alerts
• Improved error detection and reporting for backend failures
• Better connection status tracking for endpoints

Code Quality

• Fixed F541 ruff violations (unnecessary f-strings)
• Ruff formatting compliance across codebase
• Enhanced test contracts for frontend/backend parity

Models Added

• ProxmoxStorage - Storage datastore tracking
• VMSnapshot - VM snapshot management
• VMBackup - Backup job and restore point tracking
• VMTaskHistory - Async task and operation logging
• ProxboxPluginSettings - Configurable plugin behavior

API Additions

• New REST endpoints for Storage, Snapshots, Backups, and Task History
• Writable nested serializers for related object assignment
• Bulk import and CSV export for Proxmox endpoints

Migration Notes

• Migration squashing consolidated storage migrations
• Raw SQL used for pstart column timestamp migration
• Fully backwards-compatible with NetBox 4.5.x

Testing

• 124 tests passing
• Enhanced contract tests for frontend/backend alignment
• Improved sync pipeline testing

Full Changelog: v0.0.8...v0.0.9