Proxmox API a jeho využití pro správu virtuálních počítačů

Abstract

Práce se zabývá návrhem a implementací aplikace pro vzdálenou správu virtuálních strojů prostřednictvím Proxmox REST API. Oficiální nástroje platformy Proxmox VE jsou dostupné pouze lokálně na uzlu a existující komunitní projekty pokrývají vždy jen část potřeb -- buď nabízejí interaktivní rozhraní bez podpory skriptování, nebo příkazový řádek bez správy životního cyklu jednotlivých serverů. Výsledná aplikace, implementovaná v jazyce Python, poskytuje dva režimy práce. Neinteraktivní režim CLI, postavený na knihovně Typer, je určen pro přímé provádění příkazů a skriptování. Interaktivní režim TUI, postavený na knihovně Textual, nabízí terminálové rozhraní s rozděleným pohledem a podporou vícenásobného výběru. Oba režimy sdílejí společné aplikační jádro a komunikují s API prostřednictvím vlastního asynchronního HTTP klienta. Aplikace podporuje práci s více nezávislými Proxmox instancemi, řízení životního cyklu serverů, správu snapshotů a seskupování serverů do logických skupin pomocí Proxmox tagů. Funkčnost byla ověřena manuálním testováním na instanci Proxmox VE provozované na platformě pxvirt.

This thesis describes the design and implementation of an application for remote management of virtual machines via the Proxmox REST API. The official Proxmox VE tools are only available locally on the node, and existing community projects each cover only part of the needed functionality -- they either offer an interactive interface without scripting support or a command line without lifecycle management of individual servers. The resulting application, implemented in Python, provides two modes of operation. The non-interactive CLI mode, built on the Typer library, is designed for direct command execution and scripting. The interactive TUI mode, built on the Textual library, offers a split-view terminal interface with multi-select support. Both modes share a common application core and communicate with the API through a custom asynchronous HTTP client. The application supports working with multiple independent Proxmox instances, server lifecycle management, snapshot management, and grouping servers into logical groups using Proxmox tags. Functionality was verified by manual testing on a Proxmox VE instance running on the pxvirt platform.