Proxmox Infrastructure: Matrix/Virgo-Core Cluster
Manage 3-node Proxmox VE cluster with CEPH storage, VLAN networking, and cloud-init automation.
Available Tools
Python Scripts (uv-based)
- validate_template.py - Validate template health via Proxmox API
- cluster_status.py - Cluster health metrics and node status
- check_ceph_health.py - CEPH storage pool health monitoring
- check_cluster_health.py - Comprehensive cluster diagnostics
All scripts support --help for usage. Run with: uv run tools/<script>.py
Automation Examples
- Ansible playbooks - Template creation, VLAN bridging setup
- Terraform modules - VM cloning, multi-node deployments with dual NICs
See examples/ and workflows/ for working configurations.
Core Capabilities
Template Management:
- Ubuntu/Debian cloud-init templates with virtio-scsi
- Serial console configuration for cloud images
- Proper boot order and cloud-init CD-ROM (ide2)
Network Infrastructure:
- vmbr0: Management (VLAN 9 for Corosync)
- vmbr1: CEPH Public (192.168.5.0/24, MTU 9000)
- vmbr2: CEPH Private (192.168.7.0/24, MTU 9000)
- VLAN-aware bridging (supports VLANs 2-4094)
- 802.3ad LACP bonding
CEPH Storage:
- Multi-OSD configuration (2× 4TB NVMe per node)
- MTU 9000 for storage networks
- Public/private network separation
- Health monitoring and diagnostics
API Automation:
- Python via proxmoxer library
- Ansible via community.general.proxmox_* modules
- Terraform via Telmate/proxmox provider
Cluster Architecture (Matrix)
Hardware: 3× MINISFORUM MS-A2
- AMD Ryzen 9 9955HX (16C/32T)
- 64GB DDR5 @ 5600 MT/s
- 3× NVMe: 1× 1TB boot, 2× 4TB CEPH OSDs
- 4× NICs: 2× 10GbE SFP+, 2× 2.5GbE
Nodes: Foxtrot, Golf, Hotel
Quick Examples
Clone template to VM:
qm clone 9000 101 --name web-01
qm set 101 --ipconfig0 ip=192.168.3.100/24,gw=192.168.3.1
qm set 101 --net0 virtio,bridge=vmbr0,tag=30
qm start 101
Check cluster health:
uv run tools/cluster_status.py
uv run tools/check_ceph_health.py
For Details
- reference/ - Cloud-init, networking, API, storage, QEMU guest agent
- workflows/ - Cluster formation, CEPH deployment automation
- examples/ - Terraform configs, Ansible playbooks
- anti-patterns/ - Common mistakes from real deployments
1---2name: proxmox-infrastructure3description: Manage the Matrix/Virgo-Core Proxmox VE cluster (nodes Foxtrot, Golf, Hotel - MINISFORUM MS-A2 with AMD Ryzen 9 9955HX). Covers VM provisioning, VLAN networking, CEPH storage, and automation via Python (proxmoxer), Ansible (community.general.proxmox), and Terraform (Telmate/proxmox).4when_to_use: >5 Use when cloning VM templates, checking CEPH storage health, configuring VLAN6 networking for Proxmox VMs, creating cloud-init templates, checking node status7 (Foxtrot, Golf, Hotel), deploying VMs with Terraform, configuring MTU 9000 for CEPH8 networks, troubleshooting VM deployment, using Ansible proxmox modules, or validating9 template configuration via the Proxmox API.10metadata:11 source: https://skillmd.com/skills/basher83/proxmox-infrastructure12---1314# Proxmox Infrastructure: Matrix/Virgo-Core Cluster1516Manage 3-node Proxmox VE cluster with CEPH storage, VLAN networking, and cloud-init automation.1718## Available Tools1920### Python Scripts (uv-based)21- **validate_template.py** - Validate template health via Proxmox API22- **cluster_status.py** - Cluster health metrics and node status23- **check_ceph_health.py** - CEPH storage pool health monitoring24- **check_cluster_health.py** - Comprehensive cluster diagnostics2526All scripts support `--help` for usage. Run with: `uv run tools/<script>.py`2728### Automation Examples29- **Ansible playbooks** - Template creation, VLAN bridging setup30- **Terraform modules** - VM cloning, multi-node deployments with dual NICs3132See examples/ and workflows/ for working configurations.3334## Core Capabilities3536**Template Management:**37- Ubuntu/Debian cloud-init templates with virtio-scsi38- Serial console configuration for cloud images39- Proper boot order and cloud-init CD-ROM (ide2)4041**Network Infrastructure:**42- vmbr0: Management (VLAN 9 for Corosync)43- vmbr1: CEPH Public (192.168.5.0/24, MTU 9000)44- vmbr2: CEPH Private (192.168.7.0/24, MTU 9000)45- VLAN-aware bridging (supports VLANs 2-4094)46- 802.3ad LACP bonding4748**CEPH Storage:**49- Multi-OSD configuration (2× 4TB NVMe per node)50- MTU 9000 for storage networks51- Public/private network separation52- Health monitoring and diagnostics5354**API Automation:**55- Python via proxmoxer library56- Ansible via community.general.proxmox_* modules57- Terraform via Telmate/proxmox provider5859## Cluster Architecture (Matrix)6061**Hardware:** 3× MINISFORUM MS-A262- AMD Ryzen 9 9955HX (16C/32T)63- 64GB DDR5 @ 5600 MT/s64- 3× NVMe: 1× 1TB boot, 2× 4TB CEPH OSDs65- 4× NICs: 2× 10GbE SFP+, 2× 2.5GbE6667**Nodes:** Foxtrot, Golf, Hotel6869## Quick Examples7071**Clone template to VM:**72```bash73qm clone 9000 101 --name web-0174qm set 101 --ipconfig0 ip=192.168.3.100/24,gw=192.168.3.175qm set 101 --net0 virtio,bridge=vmbr0,tag=3076qm start 10177```7879**Check cluster health:**80```bash81uv run tools/cluster_status.py82uv run tools/check_ceph_health.py83```8485## For Details8687- **reference/** - Cloud-init, networking, API, storage, QEMU guest agent88- **workflows/** - Cluster formation, CEPH deployment automation89- **examples/** - Terraform configs, Ansible playbooks90- **anti-patterns/** - Common mistakes from real deployments