
Docker Multi-Stage Build: izrada image-a spremnih za produkciju
Standardni Dockerfile-ovi obično u završni image uključuju alate za izgradnju, razvojne zavisnosti i nepotrebne datoteke. To uvećava veličinu image-a i povećava površinu za napad.
Merve Arslan
Stručnjak za WordPress i hosting
Standardni Dockerfile-ovi obično u završni image uključuju alate za izgradnju, razvojne zavisnosti i nepotrebne datoteke. To uvećava veličinu image-a i povećava površinu za napad. Docker multi-stage build omogućava da u jednom Dockerfile-u definišete više faza i u završni image kopirate samo datoteke neophodne za produkciju.
Zašto koristiti multi-stage izgradnju?
Zamislite jednofazni Node.js Dockerfile: devDependencies u node_modules, TypeScript kompajler, okviri za testiranje i izvorne datoteke - sve to završava u završnom image-u. Kod tipične Node.js aplikacije ta razlika može iznositi 800 MB naspram 150 MB.
| Kriterijum | Jedna faza | Više faza |
|---|---|---|
| Veličina image-a | 600-1200 MB | 80-200 MB |
| Alati za izgradnju | Ostaju u image-u | Samo u fazi izgradnje |
| Površina za napad | Velika (nepotrebni paketi) | Minimalna (samo runtime) |
| Vreme preuzimanja/isporuke | Sporo | Brzo |
Primer multi-stage izgradnje za Node.js
Sledeći Dockerfile sastoji se od tri faze: instalacija zavisnosti, izgradnja i produkcija. Svaka faza sledećoj prosleđuje samo potrebne datoteke.
# Stage 1: Install dependencies
FROM node:20-alpine AS deps
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci
# Stage 2: Build the application
FROM node:20-alpine AS builder
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .
RUN npm run build
# Stage 3: Production image
FROM node:20-alpine AS runner
WORKDIR /app
ENV NODE_ENV=production
# Security: non-root user
RUN addgroup -S appgroup && adduser -S appuser -G appgroup
# Production dependencies only
COPY --from=deps /app/package.json ./
RUN npm ci --only=production && npm cache clean --force
# Compiled output
COPY --from=builder /app/dist ./dist
USER appuser
EXPOSE 3000
CMD ["node", "dist/main.js"]
💡 Savet: npm ci se razlikuje od npm install po tome što strogo prati package-lock.json i uklanja postojeći node_modules. U CI/CD okruženjima uvek koristite npm ci radi ponovljivih izgradnji.
Go aplikacija: minimalna izgradnja sa scratch image-om
Pošto Go proizvodi statičke binarne datoteke, kao završni image možete koristiti scratch (potpuno prazan) ili distroless. Time se veličina image-a smanjuje na 10-15 MB, bez dostupnog shell-a.
# Build stage
FROM golang:1.22-alpine AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -ldflags="-s -w" -o /app/server ./cmd/server
# Production: scratch = completely empty image
FROM scratch
COPY --from=builder /app/server /server
COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/
EXPOSE 8080
ENTRYPOINT ["/server"]
Multi-stage izgradnja za Python
Python aplikacije često zahtevaju gcc i build-essential za kompajliranje C ekstenzija tokom faze izgradnje. Multi-stage izgradnja omogućava da ove alate izbacite iz završnog image-a.
# Build: compile C extensions
FROM python:3.12-slim AS builder
RUN apt-get update && apt-get install -y --no-install-recommends \
gcc libpq-dev && rm -rf /var/lib/apt/lists/*
WORKDIR /app
COPY requirements.txt .
RUN pip install --user --no-cache-dir -r requirements.txt
# Production: no gcc, runtime only
FROM python:3.12-slim
WORKDIR /app
COPY --from=builder /root/.local /root/.local
COPY . .
ENV PATH=/root/.local/bin:$PATH
EXPOSE 8000
CMD ["gunicorn", "app:create_app()", "-b", "0.0.0.0:8000"]
Optimizacija keša slojeva
Docker svaku instrukciju iz Dockerfile-a čuva kao zaseban sloj. Kada se sloj promeni, svi sledeći slojevi se ponovo grade. Datoteke koje se često menjaju (izvorni kod) postavite na kraj, a one koje se retko menjaju (zavisnosti) na početak.
-
Kopirajte package.json pre izvornog koda Datoteke zavisnosti kopirajte zasebnom COPY komandom. Kada se izvorni kod promeni, npm ci se neće ponovo izvršavati.
-
Koristite .dockerignore Dodajte node_modules, .git, dist, test i log datoteke u .dockerignore. Tako se smanjuje veličina konteksta izgradnje i čuva keš.
-
Spojite RUN komande Spojite više apt-get ili apk komandi u jednu RUN instrukciju. Svaka RUN instrukcija kreira novi sloj.
# Build targeting a specific stage
docker build --target builder -t myapp:test .
# Parallel build with BuildKit (faster)
DOCKER_BUILDKIT=1 docker build -t myapp:v1.0.0 .
# Check image size after build
docker images myapp
# REPOSITORY TAG SIZE
# myapp v1.0.0 147MB
# Security scan
trivy image --severity CRITICAL,HIGH myapp:v1.0.0
Za bezbednosno skeniranje Docker image-a pogledajte naš vodič za bezbednost kontejnera. Za podešavanje CI/CD pipeline-a pogledajte naš vodič za GitHub Actions. Za isporuku na Kubernetes pročitajte naš uvod u Kubernetes. Zvanična Docker dokumentacija o multi-stage izgradnji i optimizaciji keša izgradnje predstavlja vredan dodatni izvor.
Često postavljana pitanja
Da li multi-stage izgradnja produžava vreme izgradnje?
Prva izgradnja može trajati nešto duže, ali su naredne uglavnom brže zahvaljujući Docker kešu slojeva. Uz BuildKit faze se mogu izvršavati paralelno, što skraćuje ukupno vreme izgradnje.
Koliko faza treba da koristim?
Obično su dovoljne 2-3 faze: instalacija zavisnosti, izgradnja i produkcija. Više faza unosi dodatnu složenost. Svaka faza treba da ima jasnu svrhu.
Da li su Alpine image-i uvek najmanja opcija?
Alpine je uglavnom najmanji, ali koristi musl libc. Neki Python i Node.js paketi zahtevaju glibc. U tim slučajevima koristite Debian slim ili distroless. Za Go aplikacije scratch je najmanja opcija.
Kako da pristupim datotekama iz međufaza?
Koristite COPY --from=stage_name da kopirate datoteke iz bilo koje prethodne faze. Umesto imena možete koristiti i brojeve faza (0, 1, 2), ali imenovane faze su čitljivije.
Šta je BuildKit i zašto ga koristiti?
BuildKit je Dockerov mehanizam za izgradnju nove generacije. Nudi paralelno izvršavanje faza, napredno upravljanje kešom i podršku za secret mount. Podrazumevano je uključen u Docker-u 23.0 i novijim verzijama.
Zaključak
Docker multi-stage izgradnja može smanjiti veličinu image-a za 70-90%, smanjiti površinu za napad i ubrzati isporuke. Odvojite instalaciju zavisnosti od faza izgradnje, koristite .dockerignore i optimizujte keš slojeva. Za svaki jezik izaberite odgovarajući osnovni image kako bi vaše produkciono okruženje ostalo bezbedno i brzo.
Visoke performanse za vašu kontejnersku infrastrukturu
Pokrenite svoje Docker kontejnere brzinom NVMe SSD-a na Hosted Cloud serverima.
Pogledajte pakete cloud servera →Merve Arslan
Stručnjak za WordPress i hosting
Autorka vodiča o optimizaciji performansi WordPress-a, izboru hostinga i infrastrukturi za e-trgovinu.
Komentari uskoro