mcpField
P
proxmox-infrastructure

proxmox-infrastructure

github.com/basher83クラウド・DevOps23115 回インストール1 週間前に更新
リポジトリ

proxmox-infrastructure について

proxmox-infrastructureは、Proxmox VE運用者向けのインフラ管理スキルです。3ノードのMatrixクラスター向けに、CEPH、ネットワーク、cloud-initテンプレートの確認スクリプトや設定資料、自動化例を提供します。

主な機能

  1. 01クラスターとノードの状態確認
  2. 02CEPHの健全性監視と診断
  3. 03Ubuntu/Debianのcloud-initテンプレート管理
  4. 04VLAN、ブリッジ、LACPの設定
  5. 05AnsibleとTerraformの自動化例

活用シーン

  1. 01クラスターとCEPHストレージの健全性確認
  2. 02VMテンプレートの作成と仮想マシンの複製
  3. 03VLANブリッジとマルチノード構成の設定

インストール

コマンドをコピーしてターミナルで実行します。

$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 プレイブック - テンプレートの作成、VLAN ブリッジの設定
  • Terraform モジュール - VM のクローン作成、デュアル NIC を備えたマルチノード展開

設定例については 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 構成（各ノードに 4TB NVMe × 2）
  • ストレージネットワークに MTU 9000 を使用
  • パブリック／プライベートネットワークの分離
  • 正常性の監視と診断

API 自動化：

  • proxmoxer ライブラリを使用した Python
  • community.general.proxmox_* モジュールを使用した Ansible
  • Telmate/proxmox プロバイダーを使用した Terraform

クラスターアーキテクチャ（Matrix）

ハードウェア： MINISFORUM MS-A2 × 3

  • AMD Ryzen 9 9955HX（16C/32T）
  • 64GB DDR5 @ 5600 MT/s
  • NVMe × 3：起動用 1TB × 1、CEPH OSD 用 4TB × 2
  • NIC × 4：10GbE SFP+ × 2、2.5GbE × 2

ノード： 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 プレイブック
  • anti-patterns/ - 実際の展開で発生したよくある誤り

コメント

Markdown 対応