mcpField
P
proxmox-infrastructure

proxmox-infrastructure

github.com/basher83云与 DevOps23115 次安装1 周前更新
代码仓库

关于 proxmox-infrastructure

proxmox-infrastructure 是面向 Proxmox VE 运维者的基础设施管理技能，针对 Matrix 三节点集群提供检查脚本、配置参考和自动化示例，覆盖 CEPH、网络与云初始化模板。

主要功能

  1. 01集群与节点状态检查
  2. 02CEPH 健康监控与诊断
  3. 03Ubuntu/Debian 云初始化模板管理
  4. 04VLAN、桥接与 LACP 配置
  5. 05Ansible 与 Terraform 自动化示例

适用场景

  1. 01检查集群及 CEPH 存储健康状况
  2. 02创建虚拟机模板并克隆虚拟机
  3. 03配置 VLAN 桥接和多节点部署

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/proxmox-infrastructure确认已加载。

包含的文件

除 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

详细介绍

Proxmox 基础设施：Matrix/Virgo-Core 集群

管理包含 CEPH 存储、VLAN 网络和 cloud-init 自动化的 3 节点 Proxmox VE 集群。

可用工具

Python 脚本（基于 uv）
  • validate_template.py - 通过 Proxmox API 验证模板状态
  • cluster_status.py - 集群健康指标和节点状态
  • check_ceph_health.py - CEPH 存储池健康监控
  • check_cluster_health.py - 全面的集群诊断

所有脚本都支持使用 --help 查看用法。运行方式：uv run tools/<script>.py

自动化示例
  • Ansible playbooks - 模板创建、VLAN 网桥设置
  • Terraform modules - VM 克隆、带双网卡的多节点部署

可在 examples/ 和 workflows/ 中查看可运行的配置。

核心功能

模板管理：

  • 使用 virtio-scsi 的 Ubuntu/Debian cloud-init 模板
  • 云镜像的串行控制台配置
  • 正确的启动顺序和 cloud-init CD-ROM（ide2）

网络基础设施：

  • vmbr0：管理网络（Corosync 使用 VLAN 9）
  • vmbr1：CEPH 公共网络（192.168.5.0/24，MTU 9000）
  • vmbr2：CEPH 专用网络（192.168.7.0/24，MTU 9000）
  • 支持 VLAN 的网桥（支持 VLAN 2-4094）
  • 802.3ad LACP 绑定

CEPH 存储：

  • 多 OSD 配置（每个节点 2 块 4TB NVMe）
  • 存储网络 MTU 9000
  • 公共/专用网络隔离
  • 健康监控和诊断

API 自动化：

  • 通过 proxmoxer 库使用 Python
  • 通过 community.general.proxmox_* 模块使用 Ansible
  • 通过 Telmate/proxmox 提供程序使用 Terraform

集群架构（Matrix）

硬件： 3 台 MINISFORUM MS-A2

  • AMD Ryzen 9 9955HX（16C/32T）
  • 64GB DDR5 @ 5600 MT/s
  • 3 块 NVMe：1 块 1TB 启动盘，2 块 4TB CEPH OSD
  • 4 个网卡：2 个 10GbE SFP+，2 个 2.5GbE

节点： Foxtrot、Golf、Hotel

快速示例

将模板克隆到 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

检查集群健康状况：

uv run tools/cluster_status.py
uv run tools/check_ceph_health.py

详细信息

  • reference/ - Cloud-init、网络、API、存储、QEMU 客户机代理
  • workflows/ - 集群组建、CEPH 部署自动化
  • examples/ - Terraform 配置、Ansible playbooks
  • anti-patterns/ - 实际部署中常见的错误

评论

支持 Markdown