The Proxmox Cluster Tasks repository is designed to simplify and automate daily administrative tasks within a Proxmox Virtual Environment (VE) cluster. The project focuses on enhancing the efficiency of cluster management by providing tools and wrappers for interacting with Proxmox through various backends and APIs.
Inspired by the principles of Terraform actions, this project emphasizes modularity, repeatability, and declarative configuration management. It allows administrators to define and execute cluster tasks in a structured and consistent manner, reducing the complexity and potential for errors in day-to-day operations.
- Clone VMs from Templates: Easily create virtual machines based on predefined templates.
- Distribute Cloned VMs Across Nodes: Automatically balance VM distribution across cluster nodes.
- Configure VM Settings:
- Replication: Set up replication policies for high availability.
- Backup: Automate backup configurations.
- Networking: Configure network interfaces and firewall rules.
- High Availability (HA) Settings:
- Define HA groups and priorities for VMs.
- For example, deploy
instance_02on nodec02, configure replication to nodesc01andc03, and assign HA settings prioritizingc02.
- HTTPS: Direct API interaction using an HTTPS wrapper.
- CLI: Programmatic execution of Proxmox CLI commands.
- SSH: Manage clusters securely over SSH.
- Asynchronous Mode: Perform non-blocking, concurrent operations for time-sensitive tasks.
- Synchronous Mode: Sequential execution for straightforward tasks.
The primary goal of this project is to streamline Proxmox VE cluster management, reduce manual effort, and improve operational consistency.
- API Reference
- Setup Instructions
- Scenarios
- NodeTasks Class
- ProxmoxAPI Class
- Configuration
- Testing
Special thanks to the proxmoxer project for providing inspiration and solutions that influenced the development of this library.