İçeriğe geç
deploy

Release + symlink ile kesintisiz deploy: pm2 ve Next.js

Four Software
31 Temmuz 2026
5 Dk Okuma

Sunucuda git pull && npm install && npm run build çalıştıran bir deploy akışının iki sorunu var. Birincisi, build süresince site yarım durumda; .next klasörü silinip yeniden yazılırken gelen istekler eksik dosya buluyor. İkincisi, bir şey ters giderse geri dönüş yolu yok — elinizde yalnızca bozuk çalışma dizini var.

Dizin düzeni

/opt/uygulama/
  releases/
    20260731-021243/
    20260731-014756/
    ...
  current -> releases/20260731-021243
  shared/
    dev.db
    public-uploads/

Her deploy releases/ altında yeni bir klasöre kuruluyor. current ise canlıdaki sürümü gösteren bir symlink. Veritabanı ve kullanıcı yüklemeleri shared/ altında duruyor; sürümler arasında paylaşılıyor ve hiçbir deploy onlara dokunmuyor.

Kritik ayrıntı: pm2 symlink'in kendisini göstermeli

pmp2 process'ini kurarken çalışma dizini olarak çözülmüş yolu değil, symlink'in kendisini vermek gerekiyor:

# doğru
cd /opt/uygulama/current
pm2 start ./node_modules/next/dist/bin/next -- start -p 4000

# yanlış: pm2 bu yolu çözüp releases/20260731-.../ olarak saklar
cd /opt/uygulama/releases/20260731-021243

Doğru kurulduğunda deploy şuna indirgeniyor: symlink'i yeni release'e çevir, pm2 restart. Process'i silip yeniden kurmak gerekmiyor.

Sıra önemli

Yeni release tamamen hazır olana kadar symlink'e dokunulmuyor:

  1. Yeni release dizini oluştur
  2. Takip edilen dosyaları rsync'le (git ls-files — çalışma dizinindeki commit'lenmemiş değişiklikler gitmesin)
  3. .env'i önceki release'den kopyala
  4. npm ci
  5. prisma generate + migrate deploy
  6. npm run build
  7. Symlink'i çevir + pm2 restart ← kesinti yalnızca burada, saniyeler
  8. Sağlık kontrolü — başarısızsa symlink'i geri al

Build 1-6 arasında, yani canlı site eski release'den hizmet vermeye devam ederken yapılıyor. Kesinti restart süresiyle sınırlı.

Otomatik geri alma

Deploy script'inin sonunda bir sağlık kontrolü olmalı ve başarısız olursa symlink eski release'e dönmeli:

if ! curl -fsS -o /dev/null "$HEALTH_URL"; then
    ln -sfn "$PREVIOUS_RELEASE" "$APP_ROOT/current"
    pm2 restart "$PROCESS_NAME"
    exit 1
fi

Bu birkaç satır, "deploy ettim ve site öldü, ne yapacağım" durumunu tamamen ortadan kaldırıyor.

Eski release'leri temizleme

Her deploy node_modules dahil yeni bir kopya bırakıyor; disk hızla doluyor. Son 8 release tutup gerisini silmek pratikte yeterli — geriye dönmek isteyeceğiniz mesafe zaten bundan kısa.

Neden bir kaynak kontrol aracı değil

Sunucuda git deposu tutmamanın somut bir faydası var: gönderilen dosya kümesi git ls-files ile açıkça belirleniyor. Sunucuda yanlışlıkla düzenlenmiş bir dosya bir sonraki deploy'da sessizce geri geliyor, çakışma üretmiyor.

#deploy#pm2#nginx#Next.js#DevOps