ASP.NET Core 4 dakika okuma

ASP.NET Core N-Tier - Kısmi DLL Deploy Rehberi

ASP.NET Core N-Tier - Kısmi DLL Deploy Rehberi

01 Temmuz 2026 198 görüntülenme
Paylaş:
ASP.NET Core N-Tier - Kısmi DLL Deploy Rehberi

Merhaba Değerli Okuyucularım,

Sizlere kendi sayfamın arka planındaki N-Tier Mimarisine kısaca değinerek bir Deploy Rehberi hazırladım.

1. GENEL YAKLAŞIM

Her değişiklikten sonra tüm projeyi FTP'ye yüklemek zaman kaybıdır. ASP.NET Core uygulamaları derleme sonucunda her katman için ayrı bir .dll dosyası üretir. Yalnızca değişen katmana ait .dll'i sunucuya yüklemek çoğu durumda yeterlidir. Bu yöntem özellikle küçük düzeltmeler ve tek katman üzerindeki geliştirmeler için idealdir.

muhammedaktepe.com web sayfamızın proje katmanları ve üretilen DLL'ler bağlamında konuyu incelemek istersek.

2. PROJE KATMANLARI VE ÜRETTİKLERİ DLL'LER

Proje beş katmandan oluşur ve her biri derleme sırasında kendi .dll'ini üretir: Aşağıdaki tabloda inceleyebilirsiniz.

PROJE KATMANLARI VE ÜRETTİKLERİ DLL'LER
muhammedaktepe_webblog.Core.dll — Entity, DTO, Interface, Enum, Constant
muhammedaktepe_webblog.DataAccess.dll — Repository, DbContext, Migration, Seed
muhammedaktepe_webblog.Business.dll — Service, AutoMapper Profil, Validator
muhammedaktepe_webblog.Infrastructure.dll — Email, Cache, Security
muhammedaktepe_webblog.Web.dll  — Controller, View (.cshtml), Middleware

Publish çıktı klasörü: bin\Release\net10.0\publish\ bu klasördeki .dll dosyaları FTP'de httpdocs/ klasörüne karşılık gelir.

Infrastructure katmanı diğer katmanlar gibi tek yönlü bir referans zincirine dahil değildir. cross-cutting concern yani birden fazla katman tarafından ihtiyaç duyulduğunda çağrılabilen bağımsız bir servis grubu olarak kullanılmaktadır.

Örneğin:

  • Business katmanı bir e-posta göndermek için Infrastructure'ı çağırabilir
  • Web katmanı cache okuma/yazma için doğrudan Infrastructure'ı çağırabilir
  • DataAccess bile loglama/security için Infrastructure'a ihtiyaç duyabilir
İç içe kutu yapısı (Web → Business → DataAccess → Core) tek yönlü bağımlılık zincirini temsil etmektedir. Infrastructure bu zincirin bir parçası değil çünkü herhangi bir katman ondan yararlanabilir — o yüzden yanda, "kullanır" okuyla birden fazla noktaya bağlanabilecek şekilde resimde ayrı gösterdim.

N-Tier Mimarisi
3. HANGİ DEĞİŞİKLİK HANGİ DLL'İ GEREKTİRİR

Yapılan değişikliğe göre yalnızca ilgili .dll'i yüklemek yeterlidir:

Controller veya View (.cshtml) değiştiyse                 → Web.dll

Service, AutoMapper veya Validator değiştiyse          → Business.dll

Repository, DbContext veya Migration değiştiyse       → DataAccess.dll

Entity, DTO, Interface veya Enum değiştiyse             → Core.dll + diğer tüm katman .dll'leri

Email, Cache veya Security değiştiyse                      → Infrastructure.dll

appsettings.json değiştiyse                                     → sadece appsettings.json

wwwroot/ altında css, js veya resim değiştiyse         → sadece o statik dosya

NuGet paketi eklendi veya güncellendiyse                → tüm dosyalar yüklenmelidir

Not: Core katmanı diğer tüm katmanlar tarafından kullanıldığından, Core'da yapılan  herhangi bir değişiklik tüm katmanların yeniden derlenmesine yol açar. Bu durumda beş .dll'in tamamını yüklemek daha güvenlidir.

4. DEPLOY ADIMLARI

IIS çalışan bir uygulamanın .dll dosyasını kilitlediği için doğrudan üzerine yazılamaz. Bu kilidi kaldırmak için app_offline.htm yöntemi kullanılır. Bunun için boş bir .txt dosyası oluşturup içerisine alt kısımdaki Html kodlarını ekleyiniz. Dosyanızın uzantısını .htm yapınız ve FTP'de httpdocs/ klasörüne yükleyiniz. Bu dosyanın içeriği ziyaretçilere görüntülenecek geçici sayfadır.

Bu durumda IIS dosyayı görünce uygulamayı durdurur ve dosya kilidi kalkar.

Bakımda

Bakım çalışması yapılmaktadır, lütfen kısa süre sonra tekrar deneyiniz

Değişen .dll dosyalarını httpdocs/ klasörüne yükleyiniz. app_offline.htm dosyasını FTP'den sildiğinize IIS uygulamayı otomatik olarak yeniden başlatır.

<!DOCTYPE html>
<html lang="tr">
    <head>
        <meta charset="UTF-8">
        <title>Bakımda</title>
    </head>
    <body>Bakım çalışması yapılmaktadır, lütfen kısa süre sonra tekrar deneyiniz</body>
</html>

5. MİGRATION İÇEREN DEĞİŞİKLİKLER

Yeni bir EF Core migration eklendiyse .dll yüklemek tek başına yeterli değildir. Veritabanı şemasının da güncellenmesi gerekir. Bunun için idempotent SQL script üretilip hosting firmasının SQL Manager aracıyla çalıştırılması önerilir:

dotnet ef migrations script --idempotent --output migration.sql
--project ../muhammedaktepe_webblog.DataAccess

--idempotent parametresi sayesinde script, tablo zaten varsa oluşturma adımını atlayarak yalnızca eksik değişiklikleri uygular.

ÖNEMLİ NOTLAR

  • Üçüncü taraf NuGet paketlerine ait .dll dosyaları (AutoMapper, EF Core, ImageSharp vb.) kod değişikliklerinden etkilenmez; her deploy'da yeniden yüklemek gerekmez.
  • Sunucuda çalışan uygulama beklenmedik bir şekilde hata vermeye başlarsa, önce deploy edilen .dll'in doğru publish çıktısından alındığı doğrulanmalıdır. Eski bir .dll'in üzerine yenisi yazılmamış olabilir.
  • app_offline.htm kullanılmadan .dll yüklenmeye çalışılırsa FTP istemcisi "dosya kullanımda" hatası verir ve yükleme başarısız olur. Bu adım atlanmamalıdır.

Tüm Makalelere Dön
Muhammed AKTEPE