Docker ile Production-Ready Deployment

Neden Docker?

Geliştirme ortamında çalışan bir uygulama, production'da neden çalışmıyor? Bu sorunun cevabı çoğu zaman basit: ortam farklılıkları. Docker, uygulamanızı bağımlılıklarıyla birlikte paketleyerek "benim makinemde çalışıyordu" sorununu ortadan kaldırır.

Multi-Stage Build ile Optimize Dockerfile

Production için imaj boyutunu minimumda tutmak kritik önem taşır. Multi-stage build ile build araçlarını final imajınıza taşımaktan kaçınırsınız:

# Stage 1: Build
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production

COPY . .
RUN npm run build

# Stage 2: Production
FROM nginx:alpine AS production
COPY --from=builder /app/dist /usr/share/nginx/html
COPY nginx.conf /etc/nginx/conf.d/default.conf
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

Nginx Konfigürasyonu

Statik dosyaları servis ederken Nginx'in doğru yapılandırılması, hem performans hem de güvenlik açısından kritiktir:

server {
    listen 80;
    server_name _;
    root /usr/share/nginx/html;
    index index.html;

    # Gzip sıkıştırma
    gzip on;
    gzip_types text/css application/javascript image/svg+xml;
    gzip_min_length 256;

    # Cache kontrolü
    location ~* \.(js|css|png|jpg|gif|ico|svg)$ {
        expires 1y;
        add_header Cache-Control "public, immutable";
    }

    # SPA routing
    location / {
        try_files $uri $uri/ /index.html;
    }

    # Güvenlik başlıkları
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header Referrer-Policy "no-referrer-when-downgrade" always;
}

Health Check ve Logging

Production'da container'ınızın sağlığını izlemek için HEALTHCHECK direktifini mutlaka ekleyin:

HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
    CMD curl -f http://localhost/health || exit 1

Sonuç

Docker ile production deployment yaparken: multi-stage build kullanın, non-root kullanıcı çalıştırın, health check ekleyin ve secretları environment variable olarak yönetin. Bu dört kural sizi 90%'lık production sorunlarından korur.