proxmox-infrastructure

用途：面向单节点 Proxmox VE 环境，提供虚拟机与 LXC 容器管理、cloud-init 模板制作、存储与网络配置，以及 API 自动化能力。主要能力包括：基于 Ubuntu/Debian 云镜像创建 cloud-init 模板（virtio-scsi、串口控制台、启动顺序与 ide2 云初始化 CD-ROM）；Linux 网桥、桥端口映射与可选 VLAN 标记；目录、LVM-thin 与 NFS 存储池用于 VM 磁盘、备份和 ISO；通过 proxmoxer（Python）、community.general.proxmox_*（Ansible）和 Telmate/proxmox provider（Terraform/OpenTofu）进行 API 自动化。使用方式：技能目录内提供 PEP 723 格式的 Python 脚本，用 uv 运行，如 uv run "${CLAUDE_SKILL_DIR}/tools/cluster_status.py"，各脚本支持 --help；另有 validate_template.py、check_cluster_health.py、check_ceph_health.py 分别用于模板校验、节点诊断和 Ceph 诊断。快速示例：克隆模板并配置网络后启动，命令为 qm clone 9000 108 --name web-01、qm set 108 --ipconfig0 ip=192.168.2.100/24,gw=192.168.2.1、qm set 108 --net0 virtio,bridge=vmbr0、qm start 108（需按实际集群替换 ID 与 IP）。参考文档涵盖 inventory、api-reference、cloud-init-patterns、networking、storage-management、qemu-guest-agent；examples 提供 Terraform/OpenTofu 模块与 Ansible playbook，workflows 提供多步流程，anti-patterns 汇总常见错误。限制：仅面向单节点场景，未提供集群规模下的细节；具体版本兼容性、权限要求和完整配置步骤暂未提供。