Dockerマルチステージビルドでイメージサイズを1/10にする

問題

Node.jsアプリケーションのDockerイメージが 1.2GB を超え、デプロイに時間がかかっていました。

マルチステージビルドとは

1つのDockerfile内で複数の FROM を使い、ビルド用と実行用のステージを分離する手法です。

Before: シングルステージ

FROM node:20
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build
EXPOSE 3000
CMD ["npm", "start"]

イメージサイズ: 1.2GB

After: マルチステージ

# Build stage
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

# Production stage
FROM node:20-alpine AS runner
WORKDIR /app
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/package.json ./
EXPOSE 3000
CMD ["npm", "start"]

イメージサイズ: 120MB

ポイント

• alpine ベースイメージを使う
• ビルドに必要なファイルだけを最終ステージにコピー
• devDependencies は最終イメージに含めない

まとめ

マルチステージビルドは設定が簡単で効果が大きいです。CI/CDのビルド時間やレジストリのストレージコストも削減できます。