pve-infra¶
Proxmox VE 上の VM / LXC を Terraform（プロバイダ: bpg/proxmox）で管理する。
このドキュメントについて
この docs/ は Zensical 向けのコンテンツツリーである。
集約リポジトリ（docs-hub）はフォルダ構成からナビを自動生成する。
ページの追加と移動は、このリポジトリの docs/ だけ直せば足りる。
読み方（4系統）¶
| 系統 | 問い | 入口 |
|---|---|---|
| 使い方 | 何が動いているか | 管理中の VM / LXC |
| アーキテクチャ | どう管理しているか | Terraform、ネットワーク、CI/CD |
| 運用 | 何をすればいいか | 追加、import、DDNS |
| 参照 | 外部 URL はどこか | Terraform / プロバイダ |
よく使うページ¶
| 用途 | ページ |
|---|---|
| 管理対象一覧 | インベントリ |
| モジュール変数 | Terraform |
| 手元での plan / apply | ローカル環境の準備 |
| VM / LXC の追加 | 新規 VM / 新規 LXC |
ディレクトリ構成¶
.
├── .github/workflows/ # GitHub Actions（plan / apply、docs-hub 通知）
├── terraform/ # Terraform ルートモジュール
│ ├── backend.tf
│ ├── provider.tf
│ ├── variables.tf
│ ├── vms.tf
│ ├── lxcs.tf
│ └── modules/
├── ddns/ # Cloudflare DDNS スクリプト
├── nw/router-conf/ # IX2106 設定
├── docs/
│ ├── guide/ # 使い方（インベントリ）
│ ├── architecture/ # 仕組み
│ ├── ops/ # 手順
│ └── reference/ # 外部リンク
└── aqua/aqua.yaml