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.
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_ |
— Entity, DTO, Interface, Enum, Constant |
|
muhammedaktepe_ |
— Repository, DbContext, Migration, Seed |
|
muhammedaktepe_ |
— Service, AutoMapper Profil, Validator |
|
muhammedaktepe_ |
— Email, Cache, Security |
|
muhammedaktepe_ |
— Controller, View (.cshtml), Middleware |
Publish çıktı klasörü: bin\
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
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.
appsettings.
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ı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.