Dockerfile Oluşturucu

Neden çok aşamalı build

Saf bir Dockerfile, derleyici araç zincirinin tamamını son görüntüye kurar. Çok aşamalı build; derlemeyi yapan bir “builder” aşaması ve yalnızca derlenmiş çıktıyı taşıyan bir son aşama sunar:

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

FROM node:20-alpine
WORKDIR /app
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
USER node
EXPOSE 3000
CMD ["node", "dist/index.js"]

Son görüntüde tüm geliştirme bağımlılıkları, kaynak dosyalar ve build önbelleği atılır; görüntü boyutu çoğu zaman yüzde 60-80 oranında küçülür.

Temel görüntü çeşitleri

Şablonlar mümkün olduğunca slim veya alpine görüntüleri kullanır. Temel görüntüyü kendiniz ayarlayacaksanız tipik seçenekler şunlardır:

Katman önbelleği kuralları

Docker her satırı önbelleğe alır; bir katman değiştiğinde altındaki her şey yeniden derlenir. En az değişenden en çok değişene doğru sıra:

1. FROM temel görüntüsü (nadiren değişir).
2. Sistem paketleri (apt-get install), seyrek değişiklikler.
3. Bağımlılık manifestleri (package.json, requirements.txt, composer.json).
4. Bağımlılık kurma adımı. Yalnızca manifest değiştiğinde çalışır.
5. Kaynak kodun kopyalanması. En yoğun katman; sonrasındaki her şey her commit’te yeniden derlenir.
6. Derleme ve son CMD.

Bu sırayı bozmak, CI build’lerinin yavaşlamasının en yaygın nedenidir.

Güvenlik kontrol listesi

• Root olmayan kullanıcıyla çalıştırın. Sona doğru USER appuser (veya USER 1000) yazın.
• Sürümleri sabitleyin. python:3.12.7-slim, python:3.12’den, o da python:latest’ten iyidir.
• / yerine açık bir WORKDIR belirleyin.
• Yerel dosyalar için ADD değil COPY kullanın. ADD otomatik açma yan etkilerine sahiptir.
• Bir HEALTHCHECK ekleyin ki orkestratörler takılan süreci algılayabilsin.
• Paket önbelleklerini aynı RUN satırında temizleyin: apt-get install ... && rm -rf /var/lib/apt/lists/*.