Multi-Stage Builds: Από τα 1.5GB στα 85MB με Next.js Standalone

Multi-Stage Builds: Από τα 1.5GB στα 85MB με Next.js Standalone

Ένα τυπικό λάθος των προγραμματιστών είναι η δημιουργία εικόνων Docker που περιέχουν ολόκληρο το Node.js SDK, όλα τα devDependencies, compilers (TypeScript, GCC) και τον source κώδικα. Αυτό οδηγεί σε τεράστια images μεγέθους 1.5GB+ με σοβαρά κενά ασφαλείας.

Σε αυτό το μάθημα θα δούμε πώς να μειώσετε το image μιας εφαρμογής Next.js 16 στα 85MB, εκμεταλλευόμενοι τα Multi-Stage Builds και το Standalone Output.

---

1. Ενεργοποίηση Standalone Output στο Next.js

Στο αρχείο next.config.ts, προσθέστε τη ρύθμιση output: 'standalone':

typescript
Αντιγραφή
import type { NextConfig } from 'next';

const nextConfig: NextConfig = {
  output: 'standalone',
  // ... υπόλοιπες ρυθμίσεις
};

export default nextConfig;

Αυτή η ρύθμιση λέει στο Next.js να εντοπίσει αυτόματα ποιες ακριβώς εξαρτήσεις από το node_modules χρειάζονται στο runtime και να δημιουργήσει ένα αυτόνομο bundle στον φάκελο .next/standalone. Δεν χρειάζεται πλέον να κουβαλάτε ολόκληρο το φάκελο node_modules!

---

2. Το Production Multi-Stage Dockerfile

Δημιουργήστε το αρχείο Dockerfile στη ρίζα του project:

dockerfile
Αντιγραφή
# syntax=docker/dockerfile:1

# -------------------------------------------------------------
# Stage 1: Base & Dependencies
# -------------------------------------------------------------
FROM node:20-alpine AS deps
RUN apk add --no-cache libc6-compat
WORKDIR /app

# Αντιγραφή αρχείων εξαρτήσεων για αξιοποίηση του Docker layer cache
COPY package.json package-lock.json ./
RUN npm ci --frozen-lockfile

# -------------------------------------------------------------
# Stage 2: Builder
# -------------------------------------------------------------
FROM node:20-alpine AS builder
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .

# Απενεργοποίηση Next.js telemetry κατά το build
ENV NEXT_TELEMETRY_DISABLED=1
ENV NODE_ENV=production

# Μεταγλώττιση Next.js
RUN npm run build

# -------------------------------------------------------------
# Stage 3: Runner (Μινιμαλιστική τελική εικόνα)
# -------------------------------------------------------------
FROM node:20-alpine AS runner
WORKDIR /app

ENV NODE_ENV=production
ENV NEXT_TELEMETRY_DISABLED=1
ENV PORT=3000
ENV HOSTNAME="0.0.0.0"

# Δημιουργία μη-προνομιούχου χρήστη συστήματος για ασφάλεια
RUN addgroup --system --gid 1001 nodejs &&     adduser --system --uid 1001 nextjs

# Αντιγραφή static assets και standalone bundle
COPY --from=builder /app/public ./public
COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static

# Εκτέλεση ως μη-root χρήστης
USER nextjs

EXPOSE 3000

CMD ["node", "server.js"]

---

3. Το Απαραίτητο .dockerignore

Χωρίς σωστό .dockerignore, το Docker θα στέλνει γιγαντιαία άχρηστα αρχεία στο Docker daemon build context:

gitignore
Αντιγραφή
Dockerfile
.dockerignore
node_modules
npm-debug.log
.git
.gitignore
.next
out
.env*.local
.env
.vscode
.idea

---

4. Build & Σύγκριση Μεγεθών

Εκτελέστε το build με το BuildKit ενεργοποιημένο:

bash
Αντιγραφή
docker build -t roboschool-app:latest .

Ελέγξτε το μέγεθος της τελικής εικόνας:

bash
Αντιγραφή
docker images | grep roboschool-app
# roboschool-app   latest   85.4MB

Η εικόνα περιλαμβάνει μόνο τα απολύτως απαραίτητα αρχεία runtime, ξεκινά σε κλάσματα δευτερολέπτου και έχει ελάχιστη επιφάνεια επίθεσης (attack surface).

---

5. Διαδραστική Εξάσκηση: Active Syntax Recall

Active Syntax: Multi-Stage Standalone Directives
Συμπληρώστε τα κενά σημεία
1COPY --from= /app/public ./public
2COPY --from= --chown=nextjs:nodejs /app/.next/standalone ./
3USER 
Token Bank (Κάντε κλικ σε ένα token για αυτόματη εισαγωγή):
buildernextjsrunnerrootdepsbuildnode
Επικύρωση Απαντήσεων