majiayu000 PM2 Ecosystem Configuration スキル
概要
PM2エコシステム設定の設計と最適化を専門とするスキル。ecosystem.config.jsの構成、実行モード選択、環境設定、監視設定を体系的に設計し、Node.jsアプリケーションのプロセス管理を最適化します。
このスキルは以下のタスクに対応します：
- ecosystem.config.jsの新規作成と既存設定の最適化
- forkモードとclusterモードの選択と実装
- 環境変数管理と本番環境構築
- プロセス監視とエラーハンドリング設定
- パフォーマンスチューニングとリソース最適化
ワークフロー
Phase 1: 要件確認と初期設計
目的: アプリケーション特性を分析し、PM2設定の方針を決定
アクション:
references/basics.mdでPM2の基本を確認- アプリケーション種別（Web API、バッチ、WebSocket等）を特定
- 負荷特性（I/O bound、CPU bound）を判断
- 実行モード（fork/cluster）の初期選択
Task: agents/design-config.mdを参照
Phase 2: 設定ファイル作成
目的: ecosystem.config.jsを作成し、基本設定を実装
アクション:
assets/ecosystem.config.template.jsをベースに作成references/config-reference.mdで設定オプションを確認- 必須項目（name、script、instances）を設定
- ログ設定と再起動戦略を実装
scripts/validate-ecosystem.mjsで検証
Task: agents/design-config.mdを参照
Phase 3: 最適化と調整
目的: パフォーマンスを最適化し、運用要件を満たす
アクション:
references/patterns.mdで最適化パターンを確認- instances数の調整とクラスタモード最適化
- メモリ制限と再起動戦略の調整
- 環境変数の階層設計と機密情報の外部化
- 負荷テストと監視設定の検証
Task: agents/optimize-performance.mdを参照
ベストプラクティス
すべきこと
- PM2でNode.jsアプリケーションを管理する時
- ecosystem.config.jsを新規作成する時
- 既存PM2設定を最適化する時
- 本番環境でのプロセス管理設定を設計する時
- クラスタモードでパフォーマンスを向上させる時
避けるべきこと
- 実行モードを検討せずにデフォルト設定を使用する
- CPU数を超えるinstances数を設定する
- 本番環境でwatchモードを有効にする
- 機密情報を設定ファイルに直接記述する
- メモリリーク対策（max_memory_restart）を設定しない
Task仕様ナビ
| Task | 起動タイミング | 入力 | 出力 |
|---|---|---|---|
| design-config | Phase 1-2 | アプリケーション情報 | ecosystem.config.js |
| optimize-performance | Phase 3 | 既存設定、パフォーマンス要件 | 最適化済み設定 |
詳細仕様: 各Taskの詳細はagents/ディレクトリの対応ファイルを参照
リソース参照
references/（詳細知識）
| リソース | パス | 内容 |
|---|---|---|
| 基礎知識 | references/basics.md |
PM2基本、ecosystem.config.js構造、基本操作 |
| 設定パターン | references/patterns.md |
実行モード選択、環境変数、再起動戦略 |
| 設定リファレンス | references/config-reference.md |
全オプションの完全リファレンス |
scripts/（決定論的処理）
| スクリプト | 用途 | 使用例 |
|---|---|---|
validate-ecosystem.mjs |
ecosystem.config.js検証 | node scripts/validate-ecosystem.mjs ecosystem.config.js |
log_usage.mjs |
スキル使用記録 | node scripts/log_usage.mjs --result success --phase "Phase 2" |
assets/（テンプレート）
| テンプレート | 用途 |
|---|---|
ecosystem.config.template.js |
ecosystem.config.js雛形 |
変更履歴
| Version | Date | Changes |
|---|---|---|
| 2.0.0 | 2025-01-02 | 18-skills.md仕様完全準拠。agents統合、references再編 |
| 1.0.0 | 2025-12-31 | 初版リリース |