💻 Nginx と PM2 が解決！Python と Node.js を安定稼働させるマルチプロセス環境構築術

導入：異なる技術スタックの統合という課題

これまでの記事で、フロントエンドに Next.js (TypeScript/Node.js)、バックエンドに Django (Python) を採用し、API 連携で型安全なモダンな Web アプリケーションを構築する道筋を解説してきました。

しかし、ここで一つの大きな課題が残ります。それは、**「Python と Node.js という、動作環境が全く異なる 2 つのプロセスを、どのように一つのサーバーで安定稼働させるか」**という点です。

独自 PHP MVC 時代は Apache が全てを処理していましたが、モダンな Full-Stack では、それぞれ専用のプロセス管理が必要になります。本記事では、この課題を解決するために導入した Nginx と PM2 を核とするマルチプロセス環境の構築方法を解説します。

第1章：なぜプロセス管理が必要なのか？

1. サーバーの役割の分離

旧 PHP システムでは、Web サーバー（Apache）が静的ファイル配信、リクエスト受付、PHP 実行環境との連携を全て担っていました。しかし、モダンな構成では役割を分離します。

フロントエンド（Next.js）: サーバーサイドレンダリング (SSR) や API ルーティングを担う Node.js プロセス。
バックエンド（Django）: データ処理と API 配信を担う Python プロセス。

これらのプロセスは、それぞれが独立したアプリケーションとして動作するため、プロセスがダウンした場合の再起動や、リソースの効率的な分配を行うための「管理人」が必要になります。

2. Nginx と PM2 の採用理由

この管理役として、私たちは以下の 2 つのツールを採用しました。

Nginx (リバースプロキシ/静的ファイル配信):
- 外部からのリクエストを最初に受け付け、適切なバックエンドプロセス（Next.js または Django）へ振り分ける交通整理役（リバースプロキシ）。
- CSS や画像などの静的ファイル配信を高速に行い、バックエンドの負荷を軽減。
PM2 (プロセス管理マネージャー):
- Node.js プロセス（Next.js）を監視し、クラッシュした際に自動で再起動させる。
- マルチコア CPU を効率よく使うための**クラスタリング（多重起動）**を容易に実現。

Python 側の Django プロセスも同様に Gunicorn のような WSGI サーバーで管理しますが、この二つ（Nginx と PM2）が、異なる技術スタックの安定稼働の鍵となります。

第2章：実践！マルチプロセス環境の構築手順

1. Next.js (Node.js) プロセスの永続化とクラスタリング（PM2）

Next.js アプリケーションを本番環境で起動する際は、単に npm start するのではなく、PM2 を用いて管理します。

インストールと設定: サーバーに PM2 をインストールし、ecosystem.config.js のような設定ファイルを作成します。
クラスタモードでの起動:
自動再起動の確保: PM2 は上記の設定により、プロセスがメモリ不足などでダウンした場合に、即座に新しいプロセスを立ち上げます。これにより、サービスの中断を最小限に抑えることが可能になりました。

# Next.jsアプリの起動設定（例）
module.exports = {
    apps : [{
        name: "next-app",
        script: "node_modules/next/dist/bin/next",
        args: "start",
        instances: "max", # CPUコア数に応じて自動でプロセス数を最大化
        exec_mode: "cluster", # クラスタモードで起動し、負荷分散をPM2に任せる
        watch: false
    }]
};
pm2 start ecosystem.config.js

2. Nginx によるリクエストの交通整理（リバースプロキシ）

次に、外部からのリクエストを PM2 で管理されている Next.js や、Python 側の Django へ適切に振り分ける Nginx の設定を行います。

Nginx は、サーバーのポート 80（HTTP）でリクエストを受け付け、以下の振り分けを行います。

Next.js へのルーティング:
- 全ての Web ページの表示リクエスト（例: / や /about）は、Next.js が待機しているポートへ転送（プロキシ）します。Next.js が HTML を生成し、その結果を Nginx がクライアントに返します。
Django へのルーティング:
- 特定の API パス（例: /api/v1/data）へのリクエストは、Python 側の Django が待機しているポート（通常は Gunicorn 経由）へ転送します。Django はデータ処理を行い、JSON を返します。

Nginx

server {
    listen 80;
    server_name example.com;

    # Django APIへのルーティング設定
    location /api/ {
        proxy_pass http://127.0.0.1:8000; # Django/Gunicornのポート
        # その他のプロキシ設定...
    }

    # Next.jsへのルーティング設定 (APIパス以外)
    location / {
        proxy_pass http://127.0.0.1:3000; # Next.js/PM2のポート
        # その他のプロキシ設定...
    }
}

この設定により、ユーザーは単一の URL にアクセスするだけで、裏側で異なる 2 つのプロセスが協調して動作する安定したサービスを利用できるようになります。

まとめ：安定稼働こそが信頼の基盤

1. Nginx と PM2 導入の成果

Nginx と PM2 の導入は、このモダンな Full-Stack 移行プロジェクトに決定的な安定性をもたらしました。

耐障害性の向上: PM2 の自動再起動とクラスタリング機能により、Node.js プロセスが一時的に不安定になってもサービス全体のダウンを防げるようになりました。
パフォーマンスの向上: Nginx が静的ファイル配信を高速で担い、バックエンドの CPU を業務ロジックの実行に集中させることが可能になりました。
シンプルな拡張性: フロントエンドとバックエンドのポート番号を変更するだけで、Nginx の設定ファイル内でルーティングを変更でき、拡張性が担保されました。