proxmox-infrastructure_skill

Overview

This skill manages the Matrix/Virgo-Core Proxmox VE cluster (Foxtrot, Golf, Hotel) including VM provisioning, VLAN networking, CEPH storage, and automation. It provides tools and examples for cloud-init templates, MTU-9000 storage networks, and API-driven workflows using Python, Ansible, and Terraform. Use it to validate templates, monitor cluster and CEPH health, and automate multi-node deployments.

How this skill works

The skill exposes Python uv-run scripts that query the Proxmox API (proxmoxer) to validate templates, report cluster health, and check CEPH status. It also includes Ansible playbooks and Terraform modules to create cloud-init templates, configure VLAN-aware bridges and LACP bonds, and clone or provision VMs with dual NICs. Network and storage best practices (separate CEPH public/private networks, MTU 9000, tagged VLANs) are codified in examples and workflows.

When to use it

• Create or clone Ubuntu/Debian cloud-init templates and validate them via API
• Provision VMs with VLAN tagging, dual NICs, or serial console/cloud-init settings
• Check overall cluster or CEPH pool health and run diagnostics
• Automate repeatable deployments with Ansible or Terraform using provided modules
• Configure or verify MTU 9000 and VLAN-aware bridges for CEPH and VM traffic

Best practices

• Keep CEPH public and private networks on dedicated vmbr interfaces with MTU 9000
• Use virtio-scsi and cloud-init CD-ROM (ide2) for cloud images and set serial console
• Validate templates with validate_template.py before mass cloning
• Use VLAN tags on vmbr bridges for guest segmentation and keep Corosync on VLAN 9
• Automate via Ansible/Terraform for repeatability; prefer API checks in CI

Example use cases

• Clone an Ubuntu template to create web-01, assign VLAN 30 and static IP, then start the VM
• Run cluster health scripts to get node status for Foxtrot, Golf, and Hotel before maintenance
• Deploy a multi-VM application stack with Terraform using the Telmate/proxmox provider
• Configure CEPH OSD networks, verify MTU settings, and monitor pool health with check_ceph_health.py
• Use an Ansible playbook to create VLAN bridging and apply consistent network config across nodes