Skip to content

PegaProx Storage Assistant 0.1.1 — Early Community Preview

Pre-release
Pre-release

Choose a tag to compare

@mdobprv-lab mdobprv-lab released this 20 Aug 11:10
· 2 commits to main since this release
420b3ad

Early community preview

PegaProx Storage Assistant 0.1.1 is a definition-only preview intended to validate the plugin architecture and storage safety model before remote execution is implemented.

This release validates and stores storage definitions. It does not discover, connect, mount, format or register storage on PVE, PBS or NAS systems.

Highlights

  • PVE/NFS workflow restricted to technical content: iso, vztmpl, snippets and import
  • PBS/iSCSI workflow designed around one dedicated LUN and one unambiguous PBS owner
  • support for multiple NAS devices, exports, targets, LUNs and network locations
  • NFS export path normalization with traversal protection
  • WWID, target/LUN, datastore and NFS destination collision prevention
  • separate create and update semantics preventing stale-ID or resource-type overwrites
  • persistent, cross-process locked resource registry
  • English and Polish interface catalogs
  • Modern, Corporate Dark/Light and Cloud Dark/Light layout support
  • PegaProx RBAC and audit-log integration for definition changes

Safety boundaries

Remote execution is hard-disabled in version 0.1.1 and cannot be enabled through the plugin UI or config.json.

This release:

  • does not store CHAP secrets, SSH credentials or PVE/PBS API tokens;
  • does not test connectivity to NAS, PVE or PBS;
  • does not modify exports, targets, LUNs, filesystems or datastores;
  • does not authorize future destructive operations based on a successful definition check.

Review SECURITY.md before testing the plugin with infrastructure metadata.

Compatibility and validation

  • PegaProx 1.0.2+
  • Python 3.12
  • 29 automated tests
  • GitHub Actions validation of Python, JSON, shell scripts and embedded JavaScript
  • tested with the official PegaProx Docker deployment model
  • visually verified across all supported PegaProx theme families

Real NAS, PVE and PBS discovery testing is intentionally deferred to later milestones.

Installation

Download both release assets and verify the archive:

sha256sum -c SHA256SUMS
tar -xzf pegaprox-storage-assistant-0.1.1.tar.gz
cd pegaprox-storage-assistant-0.1.1
sudo ./install.sh

For the official PegaProx Docker container, follow the Docker installation instructions in README.md.

Feedback requested

Early feedback is especially welcome regarding:

  • reuse of PegaProx-managed PVE/PBS connections without duplicating credentials;
  • background-task, progress-reporting and cancellation interfaces;
  • canonical RBAC and audit integration for plugin-initiated operations;
  • targeting one PVE node, an entire PVE cluster or one PBS instance;
  • frontend navigation for global and PBS-oriented plugins;
  • community-plugin packaging and marketplace expectations.

The API and registry schema should be treated as preview interfaces until the first execution-capable release.

Release assets

  • pegaprox-storage-assistant-0.1.1.tar.gz
  • SHA256SUMS

SHA-256:

86e0c515cb4e859ccb94582b81713d209eb7738302990b4c679928553adb1c44  pegaprox-storage-assistant-0.1.1.tar.gz