starred/ProxmoxScripts
1
0
Fork 0
mirror of https://github.com/coelacant1/ProxmoxScripts.git synced 2026-04-26 17:35:49 +03:00
Code Issues 6 Projects Releases 5 Packages Wiki Activity
5 releases 55 tags
  • v2.1.4 918e79fe6f

    v2.1.4 Stable

    kerem released this 2025-11-25 08:18:59 +03:00 | 9 commits to main since this release

    📅 Originally published on GitHub: Tue, 25 Nov 2025 05:21:54 GMT
    🏷️ Git tag created: Tue, 25 Nov 2025 05:18:59 GMT

    Release v2.1.4

    Version 2.0 is an architectural refactor that provides comprehensive utility frameworks, standardizes script behavior across the entire codebase, and adds remote cluster management capabilities.

    Key Improvements:

    Unified Utility Framework

    • ArgumentParser.sh - Standardized argument parsing with built-in validation, automatic help text generation, and support for common types (vmid, string, integer, boolean, range)
    • BulkOperations.sh - Unified framework for bulk VM/LXC operations with consistent error handling, progress reporting, and operation summaries
    • Operations.sh (formerly ProxmoxAPI.sh) - Centralized Proxmox API wrapper functions for VM/LXC operations, disk management, and pool operations
    • Network.sh - Network utility functions for IP validation, manipulation, and network configuration
    • TestFramework.sh - Comprehensive testing framework with unit testing, integration testing, and automated testing

    Remote Cluster Management

    • Execute scripts on single or multiple Proxmox nodes without re-downloading the repository
    • Temporary multi-remote mode supporting IP ranges (192.168.1.100-200) or VMID ranges
    • Dual log output with separate .log and .debug.log files for structured logging (local and remote)
    • Debug flag support (./GUI.sh -d) for detailed remote execution logging
    • Interrupt handling (Ctrl+C) cleanly cancels remaining nodes during remote operations

    Comprehensive Testing System

    • Test suites for all major utility frameworks (_TestArgumentParser.sh, _TestBulkOperations.sh, _TestNetwork.sh, _TestOperations.sh, _TestStateManager.sh)
    • RunAllTests.sh for automated test execution across all utilities
    • Integration test examples demonstrating proper framework usage
    • Unit testing capabilities with assertion functions and result reporting

    Script Compliance Standards

    • All scripts refactored with consistent headers: shebang -> documentation -> Function Index -> set -euo pipefail -> code
    • Standardized set -euo pipefail for robust error handling (fixed duplicates and misplaced commands)
    • All bulk operation scripts (80+ files) migrated to use ArgumentParser and BulkOperations frameworks
    • Consistent error handling and user feedback across entire codebase
    • Automated source dependency verification with VerifySourceCalls.py

    Quality Assurance Tools

    • Enhanced .check/_RunChecks.sh with better validation and reporting
    • UpdateUtilityDocumentation.py for automatic utility function documentation
    • VerifySourceCalls.py with fix mode for adding/removing dependencies and shellcheck directives
    • _ScriptComplianceChecklist.md for code quality verification

    Cross-Platform GUI Improvements

    • Auto-detects package manager (apt, dnf, yum, zypper, pacman) for any Linux distribution
    • Polymorphic menu system with centralized common operations (settings, help, back, exit)
    • Branch management accessible from all menus
    • Simplified navigation with consistent input prompts
    • Parameter history with readline shortcuts

    New Utility Scripts

    • VirtualMachines/Operations/BulkHibernate.sh, BulkSuspend.sh, BulkResume.sh
    • VirtualMachines/Hardware/BulkToggleTabletPointer.sh
    • VirtualMachines/Storage/BulkConfigureDisk.sh
    • Storage/AddStorage.sh (NFS, SMB/CIFS, PBS support)
    • Storage/RemoveStorage.sh (safe removal with usage checks)

    Commit: 918e79fe6f

    Downloads