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.HealthChecks paketini mutlaka entegre edin.
  • Secrets Management: Veritabanı şifrelerini asla Dockerfile veya compose dosyalarına düz metin olarak yazmayın. Docker Secrets veya dotnet user-secrets mekanizmalarını kullanın.
  • Daha fazla bilgi ve resmi dokümantasyon için Microsoft .NET Docker Dokümantasyonu sayfasını inceleyebilirsiniz.