このファイルは Claude Code がこのリポジトリで作業する際のガイドを提供する。 プロジェクトの概要とセットアップは README.md を参照。
Proxmox VE 3 ノードクラスタ (FYNSV) のインフラ管理リポジトリ。コードプロジェクトではなく、Terraform による IaC とサービス構築・運用ドキュメントの集合体。
| コマンド | 説明 |
|---|---|
terraform init |
プロバイダ初期化 |
terraform plan |
差分確認 |
terraform apply |
適用 |
terraform output |
出力値表示 |
各ドキュメントの管轄範囲が厳密に分かれている。正でないファイルにスペックを転記しない。
| 対象 | 正となるファイル |
|---|---|
| ゲストのリソース定義 (VMID / vCPU / RAM / ディスク / IP) | terraform/containers.tf, terraform/vms.tf |
| ゲスト内部の構築・運用 (個別サービス) | services/*/README.md, services/arona/*/README.md |
| ゲスト内部の共通セットアップ Tips (Tailscale 代理・sudo・systemd 自動起動・Docker 導入) | services/README.md |
| クラスタ基盤 (ノード / Ceph / ストレージ) | services/README.md |
| ネットワーク (ルーター / WAN / LAN / IPv6) | router/ |
- プロバイダ: bpg/proxmox (
~> 0.108) - 認証: API トークン (
terraform@pve!provider)。値はterraform.tfvarsに格納 (gitignore 済み) - state: ローカル (
terraform.tfstate、gitignore 済み) - LXC 定義:
containers.tfのlocal.containersに宣言。local.container_defaultsでデフォルト値 (Debian 13 / 2 vCPU / 2GB RAM / 16GB disk / DHCP / nesting) を補完 - 新規 LXC 払い出し:
containers.tfにエントリ追加 →terraform apply。 - 静的 IP: IX2215 の DHCP プール (
.100–.200) を避けて.201以降を使用。gatewayとnameserversも必須 - プロビジョニング: 払い出し直後に
modules/lxc/provision.shがベースライン (apt / ロケール / TZ) を自動投入。provision = falseで無効化可
- LXC の
vm_idを既存コンテナに後から書くと再作成になる可能性がある。既存と同じ値であれば安全 terraform planの差分 (特に force-replace) は必ず人間が確認してから apply する- Tailscale はコンテナ内に入れず、
arona(VM 100) が Tailscale Service / サブネットルーターとして代理公開する方針