proxmox-infrastructure

Name: proxmox-infrastructure
Author: basher83

github.com/basher83Cloud & DevOps23115 installsUpdated 1w ago

About proxmox-infrastructure

proxmox-infrastructure is an infrastructure management skill for Proxmox VE operators. It provides scripts, configuration references, and automation examples for a three-node Matrix cluster, covering CEPH, networking, and cloud-init templates.

Key features

01Cluster and node status checks
02CEPH health monitoring and diagnostics
03Ubuntu/Debian cloud-init template management
04VLAN, bridge, and LACP configuration
05Ansible and Terraform automation examples

Use cases

01Check cluster and CEPH storage health
02Create VM templates and clone virtual machines
03Configure VLAN bridges and multi-node deployments

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/basher83/lunar-claude --skill proxmox-infrastructure

After installing, type/proxmox-infrastructurein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

anti-patterns/

common-mistakes.md

examples/01-basic-vm/

main.tf

README.md

variables.tf

reference/

api-reference.md

cloud-init-patterns.md

networking.md

qemu-guest-agent.md

storage-management.md

tools/

check_ceph_health.py

check_cluster_health.py

cluster_status.py

validate_template.py

workflows/

ceph-deployment.md

cluster-formation.md

Details

From the project README

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

Comments

Markdown supported

Details

Author: basher83
Repository: basher83/lunar-claude
Category: Cloud & DevOps
Installs: 115
GitHub stars: 23

Report

More skills

All skills

lark-apps

open.feishu.cn

732.0k

Develop and host Miaoda (Spark/Miaoda) apps: app creation, local full-stack development, cloud generation and iteration, creative design (UI mockups / interactive prototypes / wireframes / landing pages / dashboards / slide decks / visual exploration), integration of AI-related capabilities, Feishu platform capabilities, or other external capabilities; log/Trace/monitoring metric/PV/UV queries; environment variable management; app collaborators and collaboration permissions; app roles and members; and automation triggers (scheduled / record changes / Webhook / Feishu approvals). Use when users want to develop or create a system, tool, platform, or app; develop locally or in the cloud, modify, deploy, publish, launch, or get a shareable link; create a page or website with HTML and deploy it to Miaoda; design, create a mockup, prototype, wireframe, PPT, deck, or visual exploration; or mention Miaoda/Spark/Miaoda apps (links like `/app/app_xxx` or `/page/<token>`, runtime domains like *.aiforce.cloud), app databases, app file storage, open API Keys, visibility, app collaborators/developer permissions, app roles/role members, production logs, API request volume, error volume, latency, traffic, environment variables, or setting up automation tasks, scheduled triggers, or approval-triggered automation for Miaoda apps. Not for regular cloud drive file uploads (lark-drive), Feishu document editing (lark-doc), or native slide creation (lark-slides).

azure-prepare

github.com/microsoft

571.7k

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up azd infrastructure, modernize app for Azure with azd, deploy with azd, function app, timer trigger, service bus trigger, event-driven function, managed identity, generate Bicep, generate Terraform, create and deploy to Azure.

wizard

github.com/mattpocock

571.5k

Generate an interactive bash wizard that walks a human through steps only they can perform. Use when provisioning infrastructure, setting up credentials or CI secrets, walking an unfamiliar third-party dashboard, or running a one-off migration or cutover. Don't invoke this for steps the agent can perform itself.

azure-ai

github.com/microsoft

571.2k

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.