proxmox-admin

Proxmox VE 運用の専門知識

AI エージェントスキル：Proxmox Virtual Environment インフラストラクチャを管理するための運用知識

概要

このスキルでは、Proxmox VE の運用に関する専門知識を AI エージェントに提供します。対象範囲は次のとおりです。

• VM および LXC のライフサイクル管理 - 作成から廃止まで
• ストレージ運用 - 設定、コンテンツ管理、バックアップ戦略
• 高可用性 - HA グループ、リソース管理、フェイルオーバー
• クラスター運用 - マルチノード管理、移行、レプリケーション
• 証明書管理 - インストール、更新、ACME 統合
• ACME 設定 - プロバイダー設定、証明書の取得、自動化
• 通知 - ターゲット設定、配信確認、アラート
• トラブルシューティング - よくある問題、API の特性、解決パターン
• セキュリティ - 権限モデル、API トークンのベストプラクティス
• パフォーマンス - 監視、リソースの最適化

対象読者：日常的な Proxmox の運用、インフラストラクチャの自動化、またはインシデント対応を行う AI エージェントです。

---

アーキテクチャの概要

Proxmox VE クラスターの概念

ノード：Proxmox VE を実行する物理サーバー

• VM と LXC コンテナをホストします
• ローカルストレージを提供します
• クラスターのクォーラムに参加します

ストレージ：共有またはローカルのストレージバックエンド

• 種類：Directory、LVM、ZFS、Ceph、NFS、iSCSI
• コンテンツの種類：イメージ、ISO、バックアップ、テンプレート
• ノードローカルまたはクラスター共有にできます

ネットワーク：仮想ネットワークインフラストラクチャ

• VM／LXC の接続に Linux ブリッジを使用します
• ネットワークのセグメント化に VLAN を使用します
• 高度な用途には SDN（Software Defined Networking）を使用します

クラスター：連携して動作するノードのグループ

• pmxcfs を介して設定を共有します
• HA により自動フェイルオーバーを実現します
• ノード間でライブマイグレーションを行います

---

運用プレイブック

1. VM のライフサイクル管理

作成 → 設定 → 監視 → バックアップ → 削除

作成

1. Get next available VMID
2. Create VM with basic config (CPU, memory, OS type)
3. Add disk(s) from storage
4. Configure network interface(s)
5. Set boot order
6. Start VM

主な考慮事項：

• ディスクに適切なストレージを選択します（パフォーマンスと容量）
• 最高のパフォーマンスを得るため、virtio ドライバーを使用します（ゲスト側のサポートが必要です）
• 管理性を高めるため、QEMU ゲストエージェントを設定します

設定

1. Review current config
2. Resize resources (CPU, memory, disk) as needed
3. Add/remove network interfaces
4. Configure firewall rules
5. Set up snapshots for rollback capability

ベストプラクティス：

• 大きな変更の前にスナップショットを作成します
• 自動プロビジョニングには cloud-init を使用します
• 正常な操作のため、QEMU ゲストエージェントを有効にします

監視

1. Check VM status (running, stopped, paused)
2. Monitor resource usage (CPU, memory, disk I/O)
3. Review task history for recent operations
4. Check logs for errors or warnings

監視するメトリクス：

• CPU 使用率とスティール時間
• メモリ負荷とスワップ使用量
• ディスク I/O 待ち時間
• ネットワークスループット

バックアップ

1. Create snapshot for quick rollback
2. Schedule backup job (vzdump)
3. Verify backup completed successfully
4. Test restore periodically
5. Prune old backups to manage space

バックアップ戦略：

• スナップショットモード：高速ですが、ストレージのサポートが必要です
• サスペンドモード：バックアップ中に VM を一時停止します
• 停止モード：整合性のあるバックアップのために VM を停止します

廃止

1. Create final backup
2. Stop VM gracefully
3. Remove from HA if configured
4. Delete VM and associated disks
5. Clean up firewall rules
6. Update documentation

---

2. LXC コンテナの管理

コンテナと VM の比較：

• より軽量です（カーネルを共有します）
• 起動時間が短縮されます
• オーバーヘッドが低くなります
• VM より分離性が低くなります

コンテナの操作

1. Create from template
2. Configure resources (CPU, memory, swap)
3. Add mount points for storage
4. Configure network
5. Start container
6. Access via console or SSH

VM との主な違い：

• マウントポイントには mp0、mp1 を使用します（disk0、disk1 ではありません）
• BIOS／UEFI の設定はありません
• カーネルへ直接アクセスする特権コンテナ、またはアクセスが制限された非特権コンテナを使用します
• スナップショット／復元操作が高速です

---

3. ストレージ管理

ストレージの設定

1. List available storage
2. Add new storage backend (NFS, Ceph, etc.)
3. Configure content types (images, backups, ISOs)
4. Set storage as default for specific content
5. Monitor storage usage

コンテンツ管理

1. Upload ISOs/templates to storage
2. Download from URL to storage
3. List storage content
4. Delete unused content
5. Restore files from backups

バックアップ管理

1. Create backup jobs (manual or scheduled)
2. Configure retention policy
3. Prune old backups automatically
4. Restore from backup
5. Verify backup integrity

バックアップのベストプラクティス：

• 容量を節約するために圧縮を使用します
• バックアップは別のストレージに保存します
• 復元手順を定期的にテストします
• バックアップのスケジュールを文書化します
• バックアップジョブの成功／失敗を監視します

---

4. 高可用性（HA）

HA の設定

1. Create HA group (define node priorities)
2. Add VM/LXC to HA management
3. Configure HA settings (max relocate, max restart)
4. Monitor HA status
5. Test failover scenarios

HA の状態：

• started：割り当てられたノードでリソースが実行中です
• stopped：リソースが意図的に停止されています
• fence：ノードがフェンスされ、リソースは別の場所で再起動されます
• error：HA マネージャーでエラーが発生しました

HA を使用する場合：

• 高い稼働率が必要な重要サービス
• 自動フェイルオーバーが必要な場合
• クラスターに 3 台以上のノードがある場合（クォーラムのため）

---

5. 移行

ライブマイグレーション（オンライン）

1. Verify target node has resources
2. Check shared storage access
3. Initiate migration
4. Monitor migration progress
5. Verify VM running on new node

要件：

• VM ディスク用の共有ストレージ
• ノード間のネットワーク接続
• 互換性のある CPU タイプ（または CPU フラグのマスク）

オフラインマイグレーション

1. Stop VM/LXC
2. Migrate to target node
3. Start on new node

ユースケース：

• 共有ストレージが利用できない
• 移行元ノードのメンテナンス
• CPU の互換性がない

---

トラブルシューティングガイド

よくある問題

1. VM が起動しない

症状：起動操作が失敗する、または VM がすぐに停止する

原因：

• ノードのリソース不足
• ストレージが利用できない
• ロックファイルが存在する
• 設定エラー

解決方法：

1. Check node resources (memory, CPU)
2. Verify storage is mounted and accessible
3. Remove lock file if stale
4. Review VM config for errors
5. Check logs: /var/log/pve/tasks/

2. マイグレーションに失敗する

症状：マイグレーション操作でエラーが発生する、またはタイムアウトする

原因：

• ネットワーク接続の問題
• ストレージが共有されていない
• CPU の互換性がない
• 移行先のリソース不足

解決方法：

1. Verify network between nodes
2. Check storage is accessible from both nodes
3. Review CPU flags compatibility
4. Ensure target node has capacity
5. Try offline migration if live fails

3. バックアップジョブに失敗する

症状：バックアップタスクのステータスがエラーになる

原因：

• ストレージ容量の不足
• 別の操作によって VM がロックされている
• スナップショットの作成に失敗した
• ネットワークのタイムアウト（リモートストレージの場合）

解決方法：

1. Check storage space availability
2. Verify no other operations running on VM
3. Try manual backup to isolate issue
4. Review backup job logs
5. Prune old backups to free space

4. HA フェイルオーバーが機能しない

症状：障害発生後、VM が別のノードで再起動しない

原因：

• クラスターのクォーラムが失われている
• HA サービスが実行されていない
• フェンシングが設定されていない
• HA グループ内のすべてのノードが利用できない

解決方法：

1. Check cluster quorum status
2. Verify HA service running on all nodes
3. Review HA group configuration
4. Check fencing configuration
5. Manually start VM if needed

5. ストレージのパフォーマンスに関する問題

症状：VM のパフォーマンスが遅い、I/O 待ちが多い

原因：

• ストレージバックエンドに過負荷がかかっている
• ネットワークのボトルネック（リモートストレージの場合）
• ディスクキャッシュの設定が最適でない
• 同じストレージ上の VM が多すぎる

解決方法：

1. Monitor storage backend performance
2. Check network throughput to storage
3. Adjust VM disk cache settings
4. Distribute VMs across multiple storage
5. Consider faster storage tier

その他のトラブルシューティング：proxmox-troubleshooting.mdを参照してください

---

セキュリティのベストプラクティス

API トークンの管理

トークンの作成：

1. 自動化用の専用ユーザーを作成します
2. 必要最小限の権限を割り当てます
3. API トークン（パスワードではありません）を生成します
4. トークンを安全に保管します（環境変数、シークレットマネージャーなど）
5. トークンを定期的にローテーションします

権限モデル：

• 権限をロールにまとめます
• ユーザー／トークンにロールを割り当てます
• 最小権限の原則に従います
• 権限の使用状況を定期的に監査します

アクセス制御

ユーザー管理：

• 認証にはレルム（PAM、LDAP、AD）を使用します
• ロールベースのアクセス制御用にグループを作成します
• ユーザーをグループに割り当てます
• アクセス権を定期的に確認します

ネットワークセキュリティ：

• IP によって API アクセスを制限します（ファイアウォールルール）
• API 接続に SSL/TLS を使用します
• ユーザーの二要素認証を有効にします
• 認証ログを監視します

---

パフォーマンスの最適化

リソースの割り当て

CPU：

• CPU コアを過度にオーバーコミットしないでください
• 重要度の低い VM には CPU 制限を設定します
• レイテンシに敏感なワークロードでは CPU を固定します
• CPU スティールタイムを監視します

メモリ：

• 動的な割り当てのためにバルーニングを有効にします
• 適切なメモリ制限を設定します
• スワップの使用状況を監視します（最小限に抑える必要があります）
• 大容量メモリの VM ではヒュージページを使用します

ディスク I/O：

• 最適なパフォーマンスを得るために virtio-scsi を使用します
• SSD では discard/TRIM を有効にします
• 適切な I/O スケジューラーを設定します
• ディスクのレイテンシとスループットを監視します

監視戦略

主要なメトリクス：

• ノードの CPU、メモリ、ディスク使用率
• VM のリソース消費量
• ストレージのパフォーマンス（IOPS、レイテンシ）
• ネットワークのスループット
• タスクの完了時間

監視ツール：

• Proxmox 組み込みのメトリクス（RRD データ）
• 外部監視（Prometheus、Grafana）
• ログの集約（syslog、ELK スタック）
• 重大なしきい値に対するアラート

---

運用ワークフロー

詳細な手順を含むワークフローについては、以下を参照してください：

• proxmox-workflows.md - よくある運用パターン

トラブルシューティングの詳細については、以下を参照してください：

• proxmox-troubleshooting.md - API の注意点と解決方法

---

クイックリファレンス

VM の状態

• running：VM は電源オンです
• stopped：VM は電源オフです
• paused：VM の実行が一時停止しています
• suspended：VM の状態がディスクに保存されています

ストレージの種類

• dir：ディレクトリベースのストレージ
• lvm：LVM ボリュームグループ
• zfs：ZFS プール
• ceph：Ceph RBD
• nfs：NFS 共有
• iscsi：iSCSI ターゲット

バックアップモード

• snapshot：高速ですが、ストレージのサポートが必要です
• suspend：バックアップ中に VM を一時停止します
• stop：バックアップのために VM を停止します

HA の状態

• started：割り当てられたノードで実行中です
• stopped：意図的に停止しています
• fence：ノードがフェンスされ、別の場所で再起動しています
• error：HA マネージャーのエラーです

---

ライセンス

MIT ライセンス - @bldg-7/proxmox-mcp パッケージの一部