Process Lifecycle Management

概要

プロセスライフサイクル管理は、Node.js アプリケーションの起動から終了までの 全フェーズを制御し、システムリソースの適切な利用と安定稼働を保証します。

主要な価値:

• 予測可能なプロセス動作
• シグナルによる優雅な制御
• リソースリークの防止
• 高可用性の実現

リソース構造

process-lifecycle-management/
├── SKILL.md
├── resources/
│   ├── process-states.md
│   ├── signal-handling.md
│   └── child-process-patterns.md
├── scripts/
│   └── check-process-health.mjs
└── templates/
    └── signal-handler.template.ts

コマンドリファレンス

リソース読み取り

# プロセス状態ガイド
cat .claude/skills/process-lifecycle-management/resources/process-states.md

# シグナル処理ガイド
cat .claude/skills/process-lifecycle-management/resources/signal-handling.md

# 子プロセスパターン
cat .claude/skills/process-lifecycle-management/resources/child-process-patterns.md

スクリプト実行

# プロセスヘルスチェック
node .claude/skills/process-lifecycle-management/scripts/check-process-health.mjs <pid>

テンプレート参照

# シグナルハンドラーテンプレート
cat .claude/skills/process-lifecycle-management/templates/signal-handler.template.ts

ワークフロー

Phase 1: プロセス起動

起動シーケンス:

1. 環境変数の読み込み
2. 設定ファイルの解析
3. 依存サービスへの接続確認
4. ポートのバインド（必要に応じて）
5. ready 状態の通知

PM2 との連携:

// PM2にready状態を通知
process.send && process.send("ready");

判断基準:

• 必須環境変数は設定されているか？
• 依存サービスへの接続は成功するか？
• 起動タイムアウトは適切か？

リソース: resources/process-states.md

Phase 2: プロセス実行

実行中の監視項目:

• メモリ使用量
• CPU 使用率
• イベントループの遅延
• アクティブな接続数

ヘルスチェック設計:

// シンプルなヘルスチェック
const healthCheck = () => ({
  status: "healthy",
  uptime: process.uptime(),
  memory: process.memoryUsage(),
  pid: process.pid,
});

判断基準:

• 定期的なヘルスチェックを実施しているか？
• メモリリークの兆候はないか？
• イベントループは正常か？

Phase 3: シグナル処理

対応すべきシグナル:

シグナルハンドラー設計:

process.on("SIGTERM", async () => {
  console.log("SIGTERM received, shutting down...");
  await gracefulShutdown();
  process.exit(0);
});

リソース: resources/signal-handling.md

Phase 4: プロセス終了

終了シーケンス:

1. 新規リクエストの受付停止
2. 進行中リクエストの完了待機
3. データベース接続のクローズ
4. キャッシュのフラッシュ
5. ログのフラッシュ
6. プロセス終了（exit code 0）

終了コード規約:

判断基準:

• 終了コードは適切に設定されているか？
• すべてのリソースは解放されているか？
• 終了ログは出力されているか？

Phase 5: 子プロセス管理

子プロセスパターン:

• spawn: 長時間実行、ストリーム処理
• fork: Node.js プロセス間通信
• exec: 短時間コマンド実行

ゾンビプロセス回避:

const child = spawn("command", ["args"]);
child.on("exit", (code) => {
  console.log(`Child exited with code ${code}`);
});
// 必ずexitイベントを処理

リソース: resources/child-process-patterns.md

ベストプラクティス

すべきこと

1. シグナルハンドラー実装: SIGTERM/SIGINT は必須
2. タイムアウト設定: 無限待機を避ける
3. 終了コード設定: 意味のある exit code
4. ログ出力: 起動・終了時のログ

避けるべきこと

1. シグナル無視: process.on('SIGTERM', () => {}) は危険
2. 同期ブロッキング: 終了処理での同期 I/O
3. ゾンビ放置: 子プロセスの未回収
4. リソース未解放: DB 接続、ファイルハンドルの放置

PM2 との統合

wait_ready モード

// アプリケーション側
const server = app.listen(port, () => {
  process.send && process.send('ready');
});

// ecosystem.config.js
{
  wait_ready: true,
  listen_timeout: 10000
}

Graceful Shutdown 連携

// PM2からのSIGINTを処理
process.on("SIGINT", async () => {
  await closeConnections();
  process.exit(0);
});

変更履歴

関連スキル

• .claude/skills/pm2-ecosystem-config/SKILL.md (.claude/skills/pm2-ecosystem-config/SKILL.md)
• .claude/skills/graceful-shutdown-patterns/SKILL.md (.claude/skills/graceful-shutdown-patterns/SKILL.md)
• .claude/skills/memory-monitoring-strategies/SKILL.md (.claude/skills/memory-monitoring-strategies/SKILL.md)