📌 Hızlı Özet:
Yeni bir projeye başladığınızda günlerce veritabanı kurmakla, versiyon çakışmalarıyla uğraşmayın. docker-compose up ile tüm altyapı 10 saniyede hazır olsun.


Docker Compose Çoklu Konteyner Mimarisi

Örnek docker-compose.yml Şablonu

PostgreSQL ve Redis içeren temel bir geliştirme ortamı:

version: '3.8'
services:
  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_USER: devuser
      POSTGRES_PASSWORD: secretpassword
      POSTGRES_DB: appdb
    ports:
      - "5432:5432"
    volumes:
      - pgdata:/var/lib/postgresql/data

  cache:
    image: redis:7-alpine
    ports:
      - "6379:6379"

volumes:
  pgdata:

Tek bir docker compose up -d komutuyla tüm bağımlılıklar izole şekilde ayağa kalkar.


📌 Sıradaki İlgili Rehber: GitHub Actions ile Otomatik Test ve Linting İş Akışı
Konteyner ortamını CI/CD otomasyonu ile entegre edin.

“Bende Çalışıyordu” Problemine Karşı Konteyner İzolasyonu

Geliştirme ortamlarında en sık yaşanan kriz, ekibe yeni katılan birinin makinesindeki Python/Node.js sürümünün veya yerel PostgreSQL konfigürasyonunun farklı olmasıdır. Docker Compose tüm bağımlılıkları tek bir bildirgesel dosyada mühürler:

# docker-compose.yml - Tam yığın geliştirme ortamı
version: '3.8'

services:
  web:
    build:
      context: .
      dockerfile: Dockerfile.dev
    ports:
      - "4321:4321"
    volumes:
      - .:/app
      - /app/node_modules
    environment:
      - NODE_ENV=development
    depends_on:
      - db
      - redis

  db:
    image: postgres:16-alpine
    restart: always
    environment:
      POSTGRES_DB: app_development
      POSTGRES_USER: dev_user
      POSTGRES_PASSWORD: dev_secure_password
    volumes:
      - postgres_data:/var/lib/postgresql/data
    ports:
      - "5432:5432"

  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"

volumes:
  postgres_data:

Çok Aşamalı (Multi-Stage) Derleme ile Minimal İmaj Üretimi

Üretim ortamında kaynak kod araçlarını ve SDK derleyicilerini taşımak güvenlik açığı ve yüzlerce megabaytlık gereksiz boyut yaratır:

# 1. Aşama: Derleyici (Builder)
FROM node:22-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

# 2. Aşama: Saf Statik Dağıtıcı (Runner)
FROM caddy:2-alpine
COPY --from=builder /app/dist /usr/share/caddy
EXPOSE 80
CMD ["caddy", "file-server", "--root", "/usr/share/caddy"]

Canlı Yeniden Yükleme (Hot-Reload) ve Volume Bağlantıları

Geliştirme yaparken kodda yaptığınız her değişikliğin konteyneri yeniden derlemeden anında yansıması için doğru volume eşleştirmesi şarttır:

  • Bağlama Noktası (Bind Mount): Bilgisayarınızdaki kaynak kod klasörünü konteyner içine bağlayın.
  • Anonim Volume (Anonymous Volume): node_modules veya .venv gibi işletim sistemine özel derlenmiş ikili dosyaların yerel makineyle ezilmesini önlemek için izole volume tanımlayın:
    volumes:
      - .:/app
      - /app/node_modules

Üretim ve Test Ortamı İçin Çoklu Compose Dosyaları

Aynı ortam konfigürasyonunu kopyalamak yerine dosya kalıtımı (override) kullanın:

  • docker-compose.yml (Temel servisler)
  • docker-compose.override.yml (Geliştirme için açık portlar ve volume mount)
  • docker-compose.prod.yml (Üretim için kısıtlı kaynaklar, log sürücüleri ve restart politikası)

Sıkça Karşılaşılan Sorular ve Sahadan Uzman Yanıtları (FAQ)

1. Bu mimariyi uygularken ilk aşamada en çok yapılan hata nedir?

En sık karşılaşılan tuzak, konfigürasyon parametrelerini ve sistem sınırlarını test etmeden doğrudan varsayılan değerlerle (default values) üretime almaktır. Özellikle yüksek eşzamanlılık (concurrency) ve bellek kısıtlı ortamlarda varsayılan ayarlar ani gecikme artışlarına ve soket tükenmesine (socket exhaustion) yol açar. Sistem her zaman kademeli yük testleriyle doğrulanmalıdır.

2. Performansı optimize ederken hangi metrikler izlenmelidir?

Sistemin sağlığını izlerken tek başına CPU kullanımına bakmak yanıltıcıdır. P95 ve P99 gecikme süreleri (latency percentiles), bellek tahsis hızları (heap allocation rate), I/O bekleme süreleri (iowait) ve hata oranları (error rate) birincil göstergeler olmalıdır. Grafana veya Prometheus gibi araçlarla bu metrikler anlık olarak takip edilmelidir.

3. Geriye dönük uyumluluk (Backward Compatibility) nasıl garanti edilir?

API ve veri formatı güncellemelerinde anlamsal sürümleme (SemVer) kurallarına sıkı sıkıya bağlı kalınmalıdır. Protokol veya şema değişikliklerinde eski versiyon en az iki ara sürüm boyunca desteklenmeli ve geçiş köprüleri (adapter layer) tanımlanmalıdır.

Üretime Alma ve Güvenlik Doğrulama Kontrol Listesi

Sistemi canlıya almadan veya sahaya çıkarmadan önce şu adımları tamamlayın:

  • Hata Yakalama ve Loglama: Tüm kritik akışlarda yapılandırılmış loglama (JSON formatında) ve panik/crash kurtarma mekanizmaları kuruldu.
  • Giriş Doğrulama (Sanitization): Dış dünyadan veya istemciden gelen tüm parametreler sıkı tip ve sınır denetiminden geçirildi.
  • Kaynak Sınırları (Resource Limits): Süreç bazında bellek (cgroups/RAM) ve dosya tanımlayıcı (ulimit -n) sınırları tanımlandı.
  • Otomatik Yedekleme ve Kurtarma: Sistem çökmesi durumunda otomatik yeniden başlama (systemd / restart: always) politikası test edildi.

Uzun Vadeli Bakım ve Mimari Yol Haritası (Long-Term Maintenance)

Bir yazılım sisteminin veya teknik altyapının gerçek maliyeti ilk geliştirme anında değil, sonraki 2-3 yıllık bakım ve işletim evresinde ortaya çıkar. Sürdürülebilir bir mühendislik disiplini için şu prensipler uygulanmalıdır:

  1. Teknik Borç Yönetimi: Her geliştirme sprintinin veya proje döngüsünün en az %15-20’lik bölümü refactoring, kütüphane bağımlılık güncellemeleri ve teknik borçların temizlenmesine ayrılmalıdır.
  2. Otomatik Regresyon Testleri: Kod tabanına eklenen her yeni özellik veya hata düzeltmesi, gelecekte aynı hatanın tekrar etmesini engelleyen otomatik regresyon testleriyle mühürlenmelidir.
  3. Şeffaf Ekip İletişimi: Mimari değişiklikler kişisel kararlarla değil, ekip içi ortak tasarım dokümanları ve RFC tartışmalarıyla olgunlaştırılmalıdır.

Sonuç ve Temel Çıkarımlar

Bu rehberde incelenen yaklaşımlar, modern mühendislik standartlarında yüksek ölçeklenebilirlik, veri bütünlüğü ve sıfır-kesinti hedeflerine ulaşmanın temel adımlarıdır. Geliştirme sürecinde teorik prensipleri pratik saha deneyimleriyle birleştirmek, sistemin beklenmedik uç senaryolarda dahi kararlı kalmasını sağlar. İlgili diğer başlıklar ve derinlemesine teknik analizler için kütüphanemizdeki bağlantılı rehberleri incelemeye devam edebilirsiniz.

Güvenlik ve Sürekli İzleme Notu

Üretim ortamında çalışan tüm servislerin ve derleme zincirlerinin periyodik güvenlik taramalarından geçirilmesi, güncel zafiyet veritabanlarının (CVE) takip edilmesi ve logların merkezi SIEM araçlarına aktarılması kesintisiz çalışma güvenliği açısından tavsiye edilir.