[Docker][構築ファイル] Node.js（フロントエンド）と Python（バックエンド）を 1 つの Docker コンテナにまとめたい

はじめに

開発時などに、Node.js（フロント）と Python（バックエンド）を同じ Docker コンテナ内でまとめて動かしたいことがあります。
この記事では、python:3.11-slim ベースの軽量イメージを用い、1 つの Docker コンテナ内で Node.js + Python を構築・起動する方法を解説します。

Dockerfile のサンプル

FROM python:3.11-slim

# Node.js を追加
RUN apt-get update && apt-get install -y curl gnupg \
    && curl -fsSL https://deb.nodesource.com/setup_20.x | bash - \
    && apt-get install -y nodejs \
    && apt-get clean && rm -rf /var/lib/apt/lists/*

# 作業ディレクトリ
WORKDIR /app

# Python & Node.js の依存ファイルをコピー
COPY requirements.txt .
RUN pip install -r requirements.txt

COPY package.json .
RUN npm install

# アプリ全体をコピー
COPY . .

# start.sh に実行権限を付与
RUN chmod +x start.sh

# 起動コマンド
CMD ["./start.sh"]

2 つのサーバーを実行する方法（フロント + バックエンド）

方法1: シェルファイルで 2 プロセス同時起動

まず start.sh ファイルを作成します：

#!/bin/bash

# フロントエンドをバックグラウンドで起動
cd frontend
npm run start &

# 少し待ってから（任意）
sleep 2

# バックエンドを起動
cd ..
python main.py

このスクリプトにより、Node.js（例: Vite, Next.js）と Python の両方を同時に起動できます。

方法2: Python コードからフロントを起動する

Python の subprocess を使って Node.js をバックグラウンド起動することで、1 ファイルで管理できます。

import subprocess
import time
from fastapi import FastAPI

# Node.js フロントエンドをバックグラウンドで起動
subprocess.Popen(["npm", "run", "start"], cwd="./frontend")

# 少し待機してバックエンド起動（任意）
time.sleep(2)

# FastAPI サーバー起動（例）
app = FastAPI()

@app.get("/")
def read_root():
    return {"message": "Hello from backend"}

この方法では、スレッドを使わずにノンブロッキングに起動可能です。

TL;DR

subprocess.Popen(...) は非同期（ノンブロッキング）でプロセスを起動できます。
エラー処理やログ監視が不要であれば、threading.Thread(...) は基本不要です。
最小構成であれば、以下のコードだけでも起動可能：

subprocess.Popen(["npm", "run", "start"], cwd="./frontend")

まとめ

開発環境であれば、Node.js と Python を 1 つの Docker コンテナでまとめて起動することは現実的かつ便利です。
ただし本番環境では、コンテナを分離して Docker Compose などで連携する構成が推奨されます。