feat: add Active Cluster support and improve plugin stability
## Major Features
### Active Cluster Support (Experimental) (#42)
- Add support for multiple PureStorage arrays in Active Cluster configuration
- Automatic volume connection on all arrays for high availability
- Configure via comma-separated addresses and tokens
### Pod Quota Limit Support (#69)
- Add proper handling of pod quota_limit parameter
- Use quota_limit when set, fall back to array capacity when unlimited
- Fix capacity reporting for pods with quotas
### Session Token Caching
- Implement session token caching in /etc/pve/priv/purestorage/
- Automatic token refresh at 80% of TTL to prevent expiration
- In-memory and file-based caching with jitter to prevent thundering herd
### Debug Logging
- Add configurable debug logging with 4 levels (0-3)
- Support both config parameter and PURESTORAGE_DEBUG environment variable
## Bug Fixes
- Fix volume deletion when connected to multiple hosts
- Query all connections before destroy
- Disconnect from all hosts on all arrays
- Prevents "Cannot destroy volume because it is currently connected" error
## CI/CD Improvements
- Add workflow_dispatch trigger to checks workflow
- Add option to check all files or only changed files
- Add comprehensive markdown linting with markdownlint-cli2
## Testing
- Add token caching tests (tests/token_cache_test.pl)
- Test token validation, expiration, and race conditions
- Test cleanup of expired cache files
## Refactoring (#72)
- Refactor volume removal logic to handle multiple host connections
- Improve device cleanup sequence (LVM, partitions, multipath)
- Extract connection querying logic before volume destruction
- Refactor CI/CD workflows for better maintainability and flexibility
- Improve error handling and logging throughout the plugin
- Enhance Active Cluster support with proper multi-array operations
## Code Formatting
- Format all Perl files with perltidy using .perltidyrc configuration
- Ensure consistent code style across the codebase
- Fix formatting issues in PureStoragePlugin.pm and test files
## Documentation
- Update README with new functionality
The "podname" value (mutually exclusive with "vgname") specifies Purestorage pod name.
The "vnprefix" value is an optional prefix to prepend to volume names.
The "vnprefix" can be used in combination with "podname" or "vgname".
Examples of volume name "vm-100-disk-0" mapping to PureStorage:
"podname mypod" => mypod::vm-100-disk-0
(same as "vnprefix mypod::")
"vgname mypve" => mypve/vm-100-disk-0
(same as "vnprefix mypve/")
"podname mypod", "vnprefix dev-" => mypod::dev-vm-100-disk-0
(same as "vnprefix mypod::dev-")
"vgname mypve", "vnprefix dev-" => mypve/dev-vm-100-disk-0
(same as "vnprefix mypve/dev-")
Also:
* Made "vgname" parameter optional
* Moved array address parameters check to purestorage_api_request()
* Removed volume info caching (#15), eliminated purestorage_volume_info()
* Modified purestorage_list_volumes() to return only disk names we recognize [ $vmid = undef case ]
* Use substr() instead of regex to strip volume name prefix in purestorage_get_volumes()
* Show PVE volume names in "Info ::" messages
* Added description of new parameters to README.md
Brian Gates