◾️ はじめに

プロダクトでプリンター機能を実装する際、プリンターサーバー（Node.jsアプリ）を常時起動し続ける必要がありました。
しかし、普通にNode.jsを起動するだけではターミナルを閉じるとプロセスが死んでしまいます。
そこでPM2を導入しました！

本記事ではPM2の仕組みから導入方法、実際のコマンドまでまとめました。

◾️ PM2とは

PM2（Process Manager 2）はNode.jsのプロセスマネージャーです。

簡単に言うと、Node.jsアプリをバックグラウンドで常時稼働させ、クラッシュしても自動で再起動してくれるツールです。

ターミナルを閉じてもアプリが動き続けます。

アプリがクラッシュすると自動で再起動します。pm2 status の ↺ の数字が再起動回数です。

アプリの標準出力・エラーをファイルに保存します。

~/.pm2/logs/アプリ名-out.log  # 標準出力
~/.pm2/logs/アプリ名-error.log # エラー

同じアプリを複数プロセスで起動してアクセスを分散できます。

pm2 start index.ts -i 4  # 4プロセスで起動

クラスターモード時にサービスを止めずにコードを更新できます。

pm2 reload myapp

1プロセスずつ順番に入れ替えるので、常にサービスが動き続けます。

pm2 start index.ts --max-memory-restart 300M

pm2 monit

プロセスとは実行中のプログラムのことです。

プログラム（ファイル）は設計図で、それを実行したときにメモリ（RAM）上に展開されて動いている状態がプロセスです。

引き出し（SSD）にしまってあるindex.ts
  ↓
作業机（RAM）に広げて実行 = プロセス
  ↓
電源オフ → 机の上が全部消える
  ↓
でもSSDのindex.tsは残ってる

PM2は親プロセスとして動き、アプリを子プロセスとして起動します。

【普通の起動】
ターミナル → node index.ts
ターミナルを閉じる → index.tsも死ぬ

【PM2経由の起動】
ターミナル → PM2（デーモン） → index.ts
ターミナルを閉じる → PM2は生きてる → index.tsも生きてる

ポーリング（定期監視）ではなく、OSのイベント駆動で検知しています。

PM2はNode.jsのAPIを使って子プロセスにイベントリスナーを登録します。

child.on('exit', (code) => {
    // プロセスが死んだら再起動する
})

プロセスが終了するとOSが即座にPM2に通知し、PM2がほぼ瞬時に再起動します。

index.tsがクラッシュ
  ↓
OSが終了シグナルを検知（即座）
  ↓
PM2に通知（即座）
  ↓
PM2が再起動（ほぼ瞬時）

プロセスが終了するときOSは終了コードを返します。

終了コード	意味
0	正常終了
1以上	エラーで終了

PM2は終了コードを見て再起動するか判断します。

PCの電源が切れるとRAM上のプロセスは全て消えます。

pm2 save    # 現在のプロセス情報をdump.pm2に保存
PC再起動    # 全プロセスが死ぬ
pm2 resurrect  # dump.pm2を読み込んで同じプロセスを再起動

保存場所：~/.pm2/dump.pm2

npm install -g pm2

pm2 start index.ts --name myapp

pm2 start src/index.ts --name myapp --interpreter node --interpreter-args "--import tsx"

pm2 save

タスクスケジューラー（Windows）でPC起動時に以下を実行するよう設定します。

pm2 resurrect

PM2を導入することで、プリンターサーバーをターミナルを閉じても、クラッシュしても安定して稼働させることができました。

特に、今回のユースケースでは以下が重要でした！