Github Actions pm2: command not foundの解決方法【2025年最新版】

エラーの概要・症状

Github Actionsでの開発環境において、pm2: command not foundというエラーメッセージが表示されることがあります。このエラーは、CI/CDパイプラインの実行中にpm2コマンドが見つからないために発生します。具体的には、Github Actionsがジョブを実行する際に、必要なコマンドやツールがインストールされていないか、パスが設定されていない場合にこのエラーが発生します。

このエラーが発生すると、デプロイやテストの自動化が失敗し、開発フローが中断されてしまいます。特に、pm2はNode.jsアプリケーションのプロセスマネージャとして広く使用されているため、その利用が前提となっているプロジェクトでは大きな問題となります。

このエラーが発生する原因

pm2: command not foundエラーの原因は主に以下の3つです。

1. pm2がインストールされていない: Github Actionsの環境にpm2がインストールされていない場合、当然コマンドが見つからずエラーが発生します。

2. パスが設定されていない: pm2がインストールされていても、その実行ファイルのパスが環境変数PATHに含まれていない場合、コマンドが見つからないというエラーになります。

3. working-directoryの設定ミス: Github Actionsでは、ジョブを実行するディレクトリをworking-directoryで指定できます。この設定が誤っていると、pm2が正しく参照できず、エラーが発生します。

これらの原因を理解することで、適切な対策を講じることができます。