proxmox-infrastructure

The proxmox-infrastructure skill provides comprehensive management for a high-availability 3-node Proxmox VE cluster (nodes Foxtrot, Golf, Hotel). It is designed for homelab administrators and infrastructure engineers tasked with maintaining complex virtualized environments. This skill streamlines operations for the Matrix/Virgo-Core cluster, offering robust tools for storage, networking, and lifecycle management.

• Full cluster health monitoring including CEPH OSD diagnostics and node status reporting via dedicated Python scripts.

• Automated VM lifecycle management using Terraform modules for multi-node deployments and cloud-init template cloning.

• Advanced network infrastructure configuration covering VLAN-aware bridging, 802.3ad LACP bonding, and high-performance MTU 9000 settings for CEPH public and private networks.

• Seamless integration with infrastructure-as-code pipelines, including Ansible playbooks for repeatable template creation and VLAN bridging setup.

• Standardized deployment workflows for Debian and Ubuntu images, featuring virtio-scsi support, serial console access, and automated cloud-init CD-ROM (ide2) configuration.

• Utilize the provided Python toolset (via uv run) for real-time validation of template health and comprehensive cluster diagnostics.

• Follow the defined architectural patterns for node hardware (MINISFORUM MS-A2, AMD Ryzen 9 9955HX) and storage separation.

• Refer to the workflows/ and examples/ directories for specific configurations regarding Corosync management (VLAN 9) and storage network isolation.

• Ensure all cloud-init templates are pre-configured with virtio-scsi to maintain compatibility with the cluster environment.

• Always consult the provided anti-patterns documentation before modifying network bridges or storage pools to prevent cluster-wide connectivity issues.