プロの現場へようこそ。私はこれまで数々の大規模プロダクトのインフラを設計してきましたが、Node.jsとDockerの組み合わせは、まさに「諸刃の剣」です。
何も考えずに書いたDockerfileは、あっという間に1GBを超える肥大化したイメージを生み出し、CI/CDパイプラインを停滞させる「負債の元凶」となります。しかし、適切なマルチステージビルドを理解すれば、実行環境は数十メガバイトまで削ぎ落とせます。
今日は、ただ動かすだけでなく、「なぜその書き方をするのか」というアーキテクトの視点を伝授します。これをマスターすれば、あなたのデプロイ時間は劇的に短縮され、本番環境の安全性は飛躍的に向上します。
—
1. なぜ「マルチステージビルド」が必要なのか？
Node.jsの開発において、私たちは「ビルドに必要なもの（devDependencies）」と「実行に必要なもの（dependencies）」を明確に分ける必要があります。
- 開発時: TypeScriptのコンパイラ、テストツール、Linterなどが必須。
- 実行時: これらは一切不要。むしろ、これらが含まれるとセキュリティリスクになり、イメージサイズを無駄に肥大化させます。
マルチステージビルドは、「ビルド専用の作業場（ステージ1）」を作り、そこから「必要最小限の成果物だけを抽出して本番用コンテナに移す（ステージ2）」という、工場のようなプロセスです。
—
2. 最適化されたDockerfileの構築
以下が、現場のスタンダードと言えるDockerfileの構成です。これをコピペするだけでなく、各行の意味を噛みしめてください。
ステージ1: ビルド環境 (Builder)
軽量なalpine版を選択。nodeのバージョンは固定することで再現性を担保
FROM node:20-alpine AS builder
作業ディレクトリを定義
WORKDIR /app
package.jsonとlockファイルを先にコピー
これにより、依存関係のインストールをキャッシュさせる（ここが高速化の肝）
COPY package.json ./
依存関係をインストール
RUN npm ci
ソースコードをコピー
COPY . .
TypeScriptのビルドなどを実行
RUN npm run build
—
ステージ2: 本番環境 (Runner)
FROM node:20-alpine AS runner
WORKDIR /app
本番環境ではNODE_ENVをproductionに設定（ライブラリの最適化が走る）
ENV NODE_ENV=production
ビルドステージから必要なファイルだけをコピー
実行に必要なdist（成果物）とpackage.jsonのみを抽出
COPY –from=builder /app/dist ./dist
COPY –from=builder /app/package.json ./package.json
COPY –from=builder /app/node_modules ./node_modules
実行ユーザーを非特権化（セキュリティの鉄則）
USER node
アプリケーションを起動
CMD [“node”, “dist/index.js”]
この設定の「魂」とも言えるポイント
1. `npm ci` の使用: `npm install` ではなく `npm ci` を使います。これはロックファイルの内容を厳密に再現するため、CI上で環境差異によるトラブルを完全に排除します。
2. キャッシュの最大活用: `COPY package.json` をソースコードより先に書くことで、依存関係が変わらない限り、重い `npm install` をスキップさせます。
3. `USER node`: コンテナをroot権限で動かすのは危険です。Node.jsイメージには最初から `node` ユーザーが含まれているので、必ずこれを利用しましょう。
—
3. HelloWorldで動作確認する
理論だけでは身につきません。実際に手を動かして、イメージがどれほど軽量化されたか確認しましょう。
手順1: プロジェクトの準備
プロジェクト作成
mkdir my-node-app && cd my-node-app
npm init -y
npm install express
手順2: ビルドと確認
Dockerfileを作成し、以下のコマンドを打ってください。
イメージをビルド
docker build -t my-app .
イメージのサイズを確認
docker images | grep my-app
ここで表示されるサイズに驚くはずです。数MB〜数十MBに収まっていれば、あなたはもう無駄なゴミを本番環境に持ち込まないエンジニアの仲間入りです。
—
4. アーキテクトからのアドバイス：さらなる高みへ
このDockerfileは、あなたの開発効率を劇的に変える第一歩です。ここから先は、以下の技術を積み上げていくと、さらに「震えるほど」楽になります。
- `.dockerignore` の徹底: `node_modules` や `.git` などをコンテナに持ち込まないように必ず作成してください。これがないと、どれだけ工夫してもイメージは肥大化します。
- Docker BuildKitの活用: `DOCKER_BUILDKIT=1` 環境変数を有効にすることで、並列ビルドが可能になり、ビルド速度がさらに向上します。
技術の本質は「いかにシンプルに保つか」です。複雑な設定を追いかける前に、まずはこのマルチステージビルドの構造を体に染み込ませてください。
毎日のコーディングが、Dockerのビルドを待つストレスから解放され、よりクリエイティブな課題解決に向けられるようになることを願っています。何か詰まったら、いつでも戻ってきてくださいね。応援しています。