Kurumsal .NET Core Mikroservis Dünyasına Giriş
2026 standartlarında monolitik yapılardan mikroservis mimarisine geçiş, sadece bir tercih değil, ölçeklenebilirlik ve sürdürülebilirlik için zorunluluktur. Bu rehberde, .NET Core tabanlı servislerinizi Docker container’ları içinde nasıl koşturacağınızı, servisler arası haberleşmeyi ve veri tutarlılığını en pratik adımlarla ele alacağız.
1. Adım: Modern .NET Core API Projesi Oluşturma
Öncelikle güncel .NET SDK kullanarak temel bir microservice API iskeleti oluşturalım. Terminal ekranınızda aşağıdaki komutu çalıştırarak projeyi ayağa kaldırın:
dotnet new webapi -n OrderService -f net10.0
cd OrderService
Proje içerisindeki Program.cs dosyasında, 2026 en iyi pratiklerine uygun olarak minimal API ve native AOT optimizasyonlarını aktif hale getirdiğinizden emin olun.
2. Adım: Dockerfile Optimizasyonu
Mikroservis mimarisinde imaj boyutunu minimumda tutmak kritik önem taşır. Multi-stage build kullanarak hem güvenliği artıran hem de boyutu küçülten Dockerfile örneği:
FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build
WORKDIR /src
COPY ['OrderService.csproj', './']
RUN dotnet restore 'OrderService.csproj'
COPY . .
RUN dotnet publish -c Release -o /app/publish
FROM mcr.microsoft.com/dotnet/aspnet:10.0 AS final
WORKDIR /app
COPY --from=build /app/publish .
EXPOSE 8080
ENV ASPNETCORE_URLS=http://+:8080
ENTRYPOINT ['dotnet', 'OrderService.dll']
3. Adım: Docker Compose ile Servisleri Ayağa Kaldırma
Gerçek hayatta servisler yalnız çalışmaz; MSSQL, Redis veya RabbitMQ gibi bağımlılıklarla haberleşirler. Tüm sistemi tek komutla yönetmek için docker-compose.yml dosyasını şu şekilde yapılandırın:
version: '3.8'
services:
orderservice:
build: .
ports:
- '5001:8080'
environment:
- ConnectionStrings__DefaultConnection=Server=sqlserver;Database=OrderDb;User=sa;Password=Your_Password123;
depends_on:
- sqlserver
sqlserver:
image: mcr.microsoft.com/mssql/server:2022-latest
environment:
- ACCEPT_EULA=Y
- SA_PASSWORD=Your_Password123
ports:
- '1433:1433'
Kritik Best Practice’ler ve Güvenlik İpuçları
- Health Checks: Kubernetes veya Docker swarm ortamlarında servislerin sağlığını izlemek için
Microsoft.Extensions.Diagnostics.HealthCheckspaketini mutlaka entegre edin. - Secrets Management: Veritabanı şifrelerini asla Dockerfile veya compose dosyalarına düz metin olarak yazmayın. Docker Secrets veya
dotnet user-secretsmekanizmalarını kullanın. - Daha fazla bilgi ve resmi dokümantasyon için Microsoft .NET Docker Dokümantasyonu sayfasını inceleyebilirsiniz.