Modern uygulama geliştirme süreçleri, özellikle mikroservis mimarileri ve dağıtık sistemler söz konusu olduğunda, karmaşık hale gelebilir. Geliştiriciler, çok sayıda servisi yönetmek, bağımlılıkları koordine etmek ve farklı ortamlarda tutarlı bir deneyim sağlamakla uğraşırken verimlilikleri düşebilir. Peki, bu karmaşıklığı nasıl basitleştirebiliriz? .NET Aspire ve WSL Docker ikilisi, tam da bu noktada devreye girerek Windows ortamında bulut-yerel uygulamalar geliştirmeyi kökten değiştiren güçlü bir sinerji sunuyor. Bu makale, her seviyeden geliştiricinin bu teknolojileri sıfırdan öğrenerek, yüksek performanslı ve yönetilebilir dağıtık uygulamalar geliştirmesine rehberlik edecek.

Günümüz yazılım dünyasında, geleneksel monolitik uygulamaların yerini giderek daha fazla mikroservis mimarisi alıyor. Bu geçiş, ölçeklenebilirlik, esneklik ve bağımsız geliştirme gibi pek çok avantajı beraberinde getirse de, aynı zamanda yeni zorlukları da beraberinde getiriyor. Bir mikroservis uygulamasında birden fazla servis, veritabanı, önbellek ve mesaj kuyruğu gibi farklı bileşenler bulunur. Bu bileşenlerin her biri kendi konteynerinde (genellikle Docker) çalışır ve geliştirme ortamında bile bu karmaşık yapıyı kurmak, yönetmek ve hata ayıklamak oldukça zahmetli olabilir.

İşte tam da bu noktada .NET Aspire, geliştirme deneyimini inanılmaz derecede basitleştiren bir orkestrasyon çerçevesi olarak öne çıkıyor. Aspire, dağıtık uygulamaların temel bileşenlerini tanımlamanıza, yapılandırmanıza ve çalıştırmanıza olanak tanır. Veritabanları, mesaj kuyrukları veya diğer özel servisler olsun, Aspire bunları tek bir komutla ayağa kaldırabilir ve yönetebilir. Böylece, geliştiriciler altyapı detaylarıyla boğuşmak yerine iş mantığına odaklanabilirler. Geleneksel yöntemlerle her bir servisi manuel olarak başlatmak, bağımlılıkları çözmek ve port çakışmalarını gidermek günler alabilecekken, Aspire bu süreyi dakikalara indirme potansiyeli taşır. Bu, özellikle büyük ekiplerde geliştirme ve entegrasyon süreçlerini hızlandırarak proje teslim sürelerini ciddi oranda kısaltır.

Ancak, konteyner tabanlı geliştirme dendiğinde akla ilk gelen araçlardan biri olan Docker’ın Windows üzerinde performansı, özellikle Linux tabanlı konteynerler için bazen tartışma konusu olmuştur. Geleneksel olarak Docker Desktop, Hyper-V sanallaştırma teknolojisini kullanarak Linux konteynerlerini çalıştırırdı. Ancak bu yaklaşım, kaynak tüketimi ve performans açısından bazı kısıtlamalara sahipti. Windows Subsystem for Linux (WSL), bu sorunu kökten çözerek Windows kullanıcılarına Linux çekirdeğinin doğrudan Windows üzerinde çalıştırılması imkanını sundu. Özellikle WSL2 ile birlikte gelen gelişmiş sanallaştırma teknolojisi, Docker Desktop’ın Linux konteynerlerini neredeyse yerel bir Linux ortamında çalışıyormuş gibi hızlı ve verimli bir şekilde yönetmesini sağladı. Bu sayede, Windows kullanıcıları da Mac veya Linux geliştiricileri gibi sorunsuz bir Docker deneyimine sahip oldu.

Dolayısıyla, .NET Aspire’ın dağıtık uygulama orkestrasyon yeteneklerini, WSL Docker’ın sağladığı yüksek performanslı ve sorunsuz konteyner çalıştırma ortamıyla birleştirmek, Windows geliştiricileri için adeta bir oyun değiştirici niteliğindedir. Bu ikili, karmaşık bulut-yerel uygulamaları yerel makinelerinizde hızlı, tutarlı ve verimli bir şekilde geliştirmenizi sağlar. Geliştirme döngüsünü hızlandırır, hata ayıklamayı kolaylaştırır ve nihayetinde daha sağlam ve ölçeklenebilir uygulamalar oluşturmanıza olanak tanır. Bir sonraki adımda, bu teknolojilerin temelini daha derinlemesine inceleyerek nasıl çalıştıklarını anlamaya odaklanacağız.

Temel Kavramlara Hızlı Bir Bakış: .NET Aspire Nedir, WSL Docker Ne İşe Yarar?

Modern yazılım geliştirmenin temel taşları haline gelen bu iki teknolojiyi daha yakından tanımak, onların sunduğu avantajları tam olarak anlamamızı sağlayacaktır. Her ikisi de, geliştiricilerin üretkenliğini artırmak ve karmaşık bulut-yerel uygulamaların yönetimini basitleştirmek için tasarlanmıştır.

.NET Aspire: Dağıtık Uygulamalar İçin Orkestrasyon Çözümü

.NET Aspire, Microsoft tarafından geliştirilen ve dağıtık uygulamaların geliştirme, test etme ve dağıtım süreçlerini basitleştirmeyi amaçlayan bir çerçevedir. Temelde, bir mikroservis mimarisindeki birden fazla servisin (API’ler, ön uçlar, arka uçlar) yanı sıra destekleyici altyapı bileşenlerinin (veritabanları, mesaj kuyrukları, önbellekler) birlikte nasıl çalışacağını tanımlamanıza ve yönetmenize olanak tanır. Aspire, karmaşık yapıları tek bir orkestrasyon projesi (AppHost) üzerinden yöneterek, her bir servisi ve bağımlılığını manuel olarak yapılandırma derdinden kurtarır.

Aspire’ın en dikkat çekici özelliklerinden biri, Aspire Dashboard‘dur. Bu web tabanlı arayüz, uygulamanızdaki tüm kaynakları (servisler, konteynerler, veritabanları) tek bir yerden izlemenizi sağlar. Servislerin durumunu, loglarını, ortam değişkenlerini ve metriklerini anlık olarak görüntüleyebilirsiniz. Bu, özellikle hata ayıklama ve performans izleme süreçlerinde inanılmaz bir kolaylık sağlar. Ayrıca, Aspire, OpenTelemetry standartlarını kullanarak izleme ve telemetri verilerini toplar, bu da uygulamalarınızın gözlemlenebilirliğini (observability) artırır ve üretim ortamına hazır çözümler geliştirmenize yardımcı olur. Aspire ayrıca, yerel ortamda çalışan konteyner tabanlı servisler ile Azure Container Apps, Kubernetes gibi bulut ortamlarındaki kaynaklar arasında tutarlı bir geliştirme deneyimi sağlamayı hedefler. Geliştiricilerin genellikle karşılaşabileceği “benim makinemde çalışıyordu” sorununu minimize etmeye çalışır. Bu sayede, uygulamanızı geliştirdiğiniz ortam ile dağıtacağınız ortam arasındaki tutarsızlıklar azalır.

Aspire, geliştirme aşamasında Docker konteynerlerini kullanarak servisleri ayağa kaldırır ve birbiriyle konuşturur. Örneğin, AppHost projenizde bir Redis önbelleği veya PostgreSQL veritabanı tanımladığınızda, Aspire otomatik olarak ilgili Docker imajlarını indirir, konteynerlerini başlatır ve bağımlı servislerinize doğru bağlantı bilgilerini sağlar. Bu otomasyon, özellikle yeni bir geliştiricinin projeye başlamasını veya mevcut bir geliştiricinin farklı bir mikroservis üzerinde çalışmaya geçmesini önemli ölçüde hızlandırır.

WSL Docker: Windows’ta Linux Deneyimiyle Kapsayıcı Geliştirme

Windows Subsystem for Linux (WSL), Microsoft’un Windows 10 ve sonrası sürümler için geliştirdiği, geliştiricilerin Windows üzerinde doğrudan bir Linux ortamı çalıştırmasına olanak tanıyan bir uyumluluk katmanıdır. Geleneksel sanal makinelerin aksine, WSL2, hafif bir sanal makine (VM) kullanarak gerçek bir Linux çekirdeğini Windows üzerinde çalıştırır. Bu, tam bir Linux uyumluluğu sağlarken, aynı zamanda Windows uygulamalarıyla neredeyse kusursuz bir entegrasyon sunar. Dosya sistemine erişim, ağ bağlantıları ve çevre birimi kullanımı gibi konularda oldukça verimlidir.

Docker, konteynerleştirme teknolojisinin temelini oluşturur ve uygulamaları bağımlılıklarıyla birlikte izole edilmiş, taşınabilir birimler halinde paketlemeyi sağlar. Windows üzerinde Docker Desktop, uzun süreler boyunca Hyper-V sanallaştırmasını kullanarak Linux konteynerlerini çalıştırmıştır. Ancak, bu yaklaşım bazı performans kısıtlamalarına sahipti. Dosya I/O işlemleri yavaş olabiliyor ve genel olarak konteyner performansı beklentilerin altında kalabiliyordu. WSL2 entegrasyonu, Docker Desktop için bu durumu kökten değiştirdi. Artık Docker Desktop, Linux konteynerlerini çalıştırmak için WSL2’yi varsayılan olarak kullanıyor. Bu, iki temel avantaj sağlıyor:

1. Yüksek Performans: WSL2’nin gerçek Linux çekirdeği sayesinde, Docker konteynerleri neredeyse yerel bir Linux makinesindeki kadar hızlı çalışır. Özellikle dosya I/O performansı önemli ölçüde artar, bu da derleme sürelerini ve uygulama yanıt verme hızını doğrudan etkiler.
2. Sorunsuz Deneyim: WSL2, Windows ile derinlemesine entegre olduğundan, Docker konteynerleriniz Windows dosya sistemine kolayca erişebilir ve Visual Studio, VS Code gibi Windows tabanlı IDE’lerinizle sorunsuz bir şekilde etkileşim kurabilir. Ayrıca, Docker Desktop, WSL2 üzerinden birden fazla Linux dağıtımını (Ubuntu, Debian vb.) yönetmenize de olanak tanır.

Bu iki teknolojinin birleşimi, geliştiricilere güçlü, verimli ve sorunsuz bir dağıtık uygulama geliştirme ortamı sunar. Aspire, karmaşık mimarileri basitleştirirken, WSL Docker da bu mimarilerin temelini oluşturan konteynerleri en iyi performansta çalıştırmayı garantiler. Artık bu teorik bilgileri pratiğe dökmeye ve adım adım kurulum ve uygulama geliştirme süreçlerine geçebiliriz.

Adım Adım Kurulum ve Ortam Hazırlığı: Başlangıç Noktanız

Başarılı bir geliştirme ortamı kurmak, .NET Aspire ve WSL Docker ikilisinin tüm potansiyelini ortaya çıkarmak için atılacak ilk ve en kritik adımdır. Bu bölümde, gerekli tüm bileşenleri nasıl kuracağınızı ve yapılandıracağınızı adım adım inceleyeceğiz. Endişelenmeyin, bu süreç düşündüğünüzden çok daha kolay ve Microsoft’un araçları sayesinde oldukça otomatikleştirilmiştir.

WSL2 ve Docker Desktop Kurulumu Nasıl Yapılır?

Öncelikle, Docker konteynerlerinizi yüksek performansla çalıştırabilmek için Windows üzerinde WSL2’nin kurulu ve etkin olduğundan emin olmalıyız.

1. WSL2 Kurulumu:

   Windows 10 sürüm 2004 ve üzeri (derleme 19041+) veya Windows 11 kullanıyorsanız, kurulum işlemi oldukça basittir. Yönetici olarak açtığınız bir PowerShell veya Komut İstemi penceresinde aşağıdaki komutu çalıştırın:

   wsl --install

   Bu komut, WSL'yi otomatik olarak etkinleştirecek, varsayılan bir Linux dağıtımı (genellikle Ubuntu) kuracak ve WSL2'yi varsayılan sürüm olarak ayarlayacaktır. Bilgisayarınızı yeniden başlatmanız istenirse, bu adımı mutlaka yapın. Kurulum tamamlandıktan sonra, yüklü dağıtımları kontrol etmek için:

   wsl -l -v

   Çıktıda Ubuntu'nun durumunun Running ve sürümünün 2 olduğundan emin olun.

2. Docker Desktop Kurulumu:

   WSL2 hazır olduğunda, Docker Desktop resmi web sitesinden indirip kurun. Kurulum sihirbazını takip edin. Kurulum sırasında veya ilk çalıştırmada, Docker Desktop'ın WSL2 entegrasyonunu otomatik olarak etkinleştirmesi gerekir. Eğer otomatik olarak etkinleşmezse veya emin olmak isterseniz:

   • Docker Desktop uygulamasını açın.
   • Ayarlar (Settings) ikonuna tıklayın.
   • Sol menüden "Resources" altında "WSL Integration" seçeneğine gidin.
   • Burada "Enable WSL 2 features" kutucuğunun işaretli olduğundan ve kullanmak istediğiniz Linux dağıtımlarının (örneğin Ubuntu) da etkinleştirildiğinden emin olun.

   Docker Desktop'ın başarıyla çalıştığından ve WSL2 ile entegre olduğundan emin olmak için bir terminal açıp aşağıdaki komutu çalıştırabilirsiniz:

   docker run hello-world

   Eğer bir "Hello from Docker!" mesajı görürseniz, her şey yolunda demektir. Artık yüksek performanslı Linux konteynerlerini Windows'ta çalıştırabilirsiniz.

.NET Aspire Geliştirme Ortamı Hazırlığı

Şimdi sıra .NET Aspire için gerekli araçları kurmaya geldi. Bu adımlar da oldukça basittir ve sizi hızlıca kod yazmaya hazır hale getirecektir.

1. .NET SDK Kurulumu:

   .NET Aspire, .NET 8 veya üzeri bir .NET SDK'sı gerektirir. Eğer henüz kurulu değilse, resmi .NET web sitesinden en son sürümü indirip kurun. Kurulumu tamamladıktan sonra terminalde sürümü kontrol edebilirsiniz:

   dotnet --version

   Çıktının 8.x.x veya daha yeni bir sürüm olduğundan emin olun.

2. Aspire Workload Kurulumu:

   .NET SDK'sına Aspire şablonlarını ve araçlarını eklemek için aşağıdaki komutu kullanın:

   dotnet workload install aspire

   Bu komut, Aspire projeleri oluşturmak ve çalıştırmak için gereken tüm bileşenleri yükleyecektir. Bu işlem biraz zaman alabilir, internet hızınıza bağlı olarak değişir.

3. Geliştirme Ortamı Seçimi:

   Visual Studio (2022 v17.9 veya üzeri) veya Visual Studio Code kullanabilirsiniz. Visual Studio Code kullanıyorsanız, C# geliştirme için önerilen eklentileri (C#, Docker, Dev Containers) kurduğunuzdan emin olun. Visual Studio 2022 içinse, "ASP.NET ve web geliştirme" iş yükünün yüklü olduğundan emin olun, Aspire desteği bu iş yüküyle birlikte gelir.

   Uzman İpucu: Visual Studio 2022 kullanıyorsanız, Aspire projenizi açtığınızda otomatik olarak gerekli ayarlar yapılacaktır. VS Code kullanıyorsanız, terminalden dotnet run komutunu AppHost projenizin dizininde çalıştırarak uygulamanızı başlatabilirsiniz.

Tebrikler! .NET Aspire ve WSL Docker için geliştirme ortamınız başarıyla kuruldu. Artık bu güçlü ikiliyi kullanarak ilk dağıtık uygulamanızı geliştirmeye hazırsınız. Bir sonraki bölümde, Aspire şablonlarıyla yeni bir proje oluşturup temel bileşenleri nasıl yapılandıracağımızı adım adım göreceğiz.

İlk .NET Aspire Uygulamanızı WSL Docker ile Geliştirme

Geliştirme ortamımız hazır olduğuna göre, .NET Aspire'ın büyüsünü kullanarak ilk dağıtık uygulamamızı oluşturmaya başlayabiliriz. Bu bölümde, Aspire'ın sunduğu şablonlarla nasıl proje oluşturacağınızı, çeşitli hizmetleri nasıl entegre edeceğinizi ve Aspire Dashboard'un uygulama yaşam döngüsündeki rolünü keşfedeceğiz.

Aspire Şablonu ile Proje Oluşturma ve Yapılandırma

Yeni bir Aspire projesi oluşturmak oldukça basittir. Terminalinizi açın ve projenizi oluşturmak istediğiniz dizine gidin. Ardından aşağıdaki komutu çalıştırın:

dotnet new aspire -n MyFirstAspireApp

Bu komut, MyFirstAspireApp adında yeni bir Aspire çözümü oluşturacaktır. Çözüm dizininin içine baktığınızda, üç ana proje göreceksiniz:

• MyFirstAspireApp.AppHost: Bu, Aspire orkestrasyon projenizin kalbidir. Uygulamanızdaki tüm servisleri, veritabanlarını ve diğer bağımlılıkları burada tanımlarsınız. Aspire, bu projeyi kullanarak kaynakları başlatır ve yönetir.
• MyFirstAspireApp.ServiceA: Genellikle bir HTTP API veya arka uç servisi olarak görev yapar.
• MyFirstAspireApp.Web: Genellikle bir ön uç web uygulamasıdır (örneğin Blazor veya React/Angular için bir proxy).

Bu şablon, Aspire'ın dağıtık bir uygulamanın temel yapısını nasıl oluşturduğunu gösterir. AppHost projesi, diğer servis projelerine referans verir ve onların nasıl konuşlandırılacağını (örneğin konteyner olarak) tanımlar. Örneğin, AppHost/Program.cs dosyasının içeriğine baktığınızda, servislerin nasıl eklendiğini göreceksiniz:

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddRedis("cache"); // Örnek olarak bir Redis önbellek ekliyoruz
var apiservice = builder.AddProject("apiservice");

builder.AddProject("webfrontend")
       .WithReference(apiservice) // Web projesinin apiservice'e bağımlı olduğunu belirtiyoruz
       .WithReference(cache); // Web projesinin cache'e bağımlı olduğunu belirtiyoruz

builder.Build().Run();

Yukarıdaki örnekte, varsayılan şablonun üzerine bir Redis önbelleği (cache) ekledik. AddRedis("cache") komutu, Aspire'a bir Redis konteyneri başlatması talimatını verir. Ayrıca WithReference() metodunu kullanarak, webfrontend projesinin apiservice ve cache servislerine bağımlı olduğunu belirtiyoruz. Aspire, bu bağımlılıkları otomatik olarak çözerek, servislerinize doğru bağlantı dizelerini (connection strings) veya URL'leri sağlayacaktır.

Uygulamayı Çalıştırma ve Aspire Dashboard ile İzleme

Projenizi oluşturup temel yapılandırmayı yaptıktan sonra, uygulamayı çalıştırmak inanılmaz derecede kolaydır. Sadece MyFirstAspireApp.AppHost projesinin dizinine gidin ve aşağıdaki komutu çalıştırın:

dotnet run

Bu komutu çalıştırdığınızda şunlar gerçekleşir:

1. Aspire Orkestrasyonu: Aspire, AppHost projenizi derler ve çalıştırır. Projede tanımladığınız tüm kaynakları (Redis konteyneri, .NET servisleri) analiz eder.
2. Docker ile Konteyner Başlatma: Eğer Redis gibi bir konteyner tabanlı kaynak tanımladıysanız, Aspire Docker CLI'yi kullanarak ilgili Redis imajını çeker ve bir konteyner başlatır. Bu işlem, WSL2'nin sağladığı yüksek performanslı Linux konteyner ortamında gerçekleşir.
3. Servisleri Başlatma: ServiceA ve Web gibi .NET projeleri için Aspire, bu projeleri normal bir .NET uygulaması gibi başlatır. Ancak, Aspire bu servislerin birbirleriyle iletişim kurabilmesi için gerekli ortam değişkenlerini ve bağlantı bilgilerini otomatik olarak enjekte eder.
4. Aspire Dashboard: Uygulama başlatıldığında, terminalde Aspire Dashboard'un bir URL'si görünür (genellikle https://localhost:18888 veya benzeri bir port). Bu URL'yi tarayıcınızda açtığınızda, tüm dağıtık uygulamanızın canlı bir görünümünü elde edersiniz.

Aspire Dashboard, uygulamanızın adeta kontrol merkezi gibidir. Burada şunları görebilirsiniz:

• Kaynaklar (Resources): Tüm .NET servisleriniz, Docker konteynerleriniz (örneğin Redis) ve diğer Aspire kaynakları listelenir. Her bir kaynağın durumunu (Running, Starting vb.) ve atanan portlarını görebilirsiniz.
• Loglar (Logs): Her bir servisin veya konteynerin anlık log çıktılarını izleyebilirsiniz. Bu, özellikle hata ayıklama sırasında paha biçilmezdir. Logları filtreleyebilir ve belirli mesajları arayabilirsiniz.
• Ortam Değişkenleri (Environment Variables): Servislerinize Aspire tarafından enjekte edilen ortam değişkenlerini görüntüleyebilirsiniz. Bu, bağlantı dizelerinin ve yapılandırma ayarlarının doğru bir şekilde iletilip iletilmediğini kontrol etmenizi sağlar.
• Metrikler (Metrics) ve İzleme (Traces): OpenTelemetry entegrasyonu sayesinde, servislerinizin performans metriklerini ve çağrı izlerini (traces) inceleyerek uygulamanızın çalışma zamanındaki davranışını detaylıca analiz edebilirsiniz.

Bu entegre deneyim, bir geliştiricinin birden fazla terminal penceresi, Docker komutu ve manuel yapılandırmayla uğraşmak yerine, tek bir dotnet run komutuyla tüm dağıtık uygulamasını ayağa kaldırmasına ve kapsamlı bir şekilde izlemesine olanak tanır. WSL Docker'ın sağladığı performans sayesinde, bu süreç yerel geliştirme ortamınızda akıcı bir şekilde gerçekleşir. Artık bu temelleri bildiğimize göre, daha karmaşık, gerçek dünya senaryolarına dalabiliriz.

Gerçek Dünya Senaryosu: Mikroservis Mimarisiyle Bir E-ticaret Uygulaması

Şimdiye kadar Aspire ve WSL Docker'ın temel kurulum ve kullanımını öğrendik. Ancak bu teknolojilerin gerçek potansiyelini anlamak için, onları daha karmaşık, gerçek dünya senaryolarında nasıl uygulayacağımıza bakmalıyız. Bir e-ticaret uygulaması, mikroservis mimarisinin sunduğu avantajları ve karşılaştığı zorlukları göstermek için mükemmel bir örnektir. Bu bölümde, bir e-ticaret uygulamasının temel servislerini Aspire ile nasıl entegre edeceğimizi ve mobil uyumluluk gibi pratik ipuçlarını ele alacağız.

Ürün Kataloğu ve Sepet Servislerinin Entegrasyonu

Hayal edelim ki bir e-ticaret uygulaması geliştiriyoruz ve bu uygulama için iki ana mikroservise ihtiyacımız var: ProductCatalogService ve ShoppingCartService.

• ProductCatalogService: Ürün bilgilerini (ad, açıklama, fiyat) bir veritabanından (örneğin PostgreSQL) okur ve API aracılığıyla sunar.
• ShoppingCartService: Kullanıcının sepetindeki ürünleri tutar ve yönetir. Sepet verileri genellikle hızlı erişim için bir önbellekte (örneğin Redis) depolanır.

Aspire, bu iki servisin ve bağımlılıklarının yerel geliştirme ortamımızda sorunsuz bir şekilde çalışmasını sağlamak için harika bir araçtır. MyECommerceApp.AppHost projemizi açalım ve Program.cs dosyamızda gerekli düzenlemeleri yapalım:

var builder = DistributedApplication.CreateBuilder(args);

// 1. PostgreSQL veritabanını Aspire'a ekle
// Bu, bir Docker konteynerinde PostgreSQL sunucusu başlatacak.
var postgres = builder.AddPostgres("ecommercedb")
                      .WithVolume("postgres-data"); // Veri kalıcılığı için bir Docker volume'ü kullan

// PostgreSQL içindeki bir veritabanı örneği oluştur
var productDb = postgres.AddDatabase("products");

// 2. Redis önbelleğini Aspire'a ekle
// Bu, bir Docker konteynerinde Redis sunucusu başlatacak.
var redis = builder.AddRedis("cartcache");

// 3. ProductCatalogService projesini ekle
// Bu servis, ürün bilgilerini productDb'den okuyacak.
var productCatalogService = builder.AddProject("productcatalogservice")
                                   .WithReference(productDb); // productDb'ye bağımlı olduğunu belirt

// 4. ShoppingCartService projesini ekle
// Bu servis, sepet bilgilerini cartcache'de tutacak.
var shoppingCartService = builder.AddProject("shoppingcartservice")
                                    .WithReference(redis); // cartcache'e bağımlı olduğunu belirt

// 5. Bir ön uç web uygulaması (örneğin Blazor) ekleyelim
// Bu uygulama, hem productCatalogService hem de shoppingCartService ile iletişim kuracak.
builder.AddProject("webfrontend")
       .WithReference(productCatalogService)
       .WithReference(shoppingCartService);

builder.Build().Run();

Yukarıdaki kodda yaptığımız şeyleri özetleyelim:

• builder.AddPostgres("ecommercedb").AddDatabase("products"): Aspire'a bir PostgreSQL Docker konteyneri başlatmasını ve içinde products adında bir veritabanı oluşturmasını söylüyoruz. WithVolume("postgres-data") ile veritabanı verilerinin Docker volume'ü üzerinde kalıcı olmasını sağlıyoruz, böylece konteyner yeniden başlatılsa bile verileriniz kaybolmaz.
• builder.AddRedis("cartcache"): Bir Redis Docker konteyneri başlatılacak ve sepet verileri için kullanılacak.
• AddProject().WithReference(): Her iki servis projesini (ProductCatalogService ve ShoppingCartService) Aspire'a ekliyoruz ve hangi kaynaklara (veritabanı, önbellek) bağımlı olduklarını belirtiyoruz. Aspire, bu referanslar sayesinde servislerinize otomatik olarak doğru bağlantı dizelerini (örneğin ConnectionStrings__products veya ConnectionStrings__cartcache adıyla) enjekte edecektir. Servis projelerinizde bu bağlantı dizelerini IConfiguration üzerinden okuyarak ilgili kaynaklara bağlanabilirsiniz.
• MyECommerceApp_WebFrontend projesi de hem ürün kataloğu hem de sepet servislerine bağımlı hale getirilerek, kullanıcının ürünleri görmesi ve sepete eklemesi sağlanıyor.

Bu yapılandırma ile dotnet run komutunu AppHost projesinden çalıştırdığınızda, Aspire ve WSL Docker iş birliği yaparak hem PostgreSQL hem de Redis konteynerlerini başlatacak, ardından .NET servislerinizi ayağa kaldıracak ve her birinin doğru bir şekilde yapılandırıldığından emin olacaktır. Aspire Dashboard üzerinden tüm bu kaynakların durumunu, loglarını ve performanslarını tek bir yerden izleyebileceksiniz.

Mobil Uyumluluk ve Performans İpuçları

E-ticaret uygulamaları genellikle web tabanlı arayüzlere sahiptir ve günümüzde mobil uyumluluk vazgeçilmezdir. Aspire'ın kendisi doğrudan UI katmanını yönetmese de, geliştirdiğiniz web uygulamalarının mobil cihazlarda da düzgün görünmesini sağlamak için CSS media query'lerini kullanmak temel bir yaklaşımdır. İşte basit bir örnek:

    
    
    
    


    
Ürün Kataloğu
    

        

            
Ürün 1
            
Açıklama 1
            100 TL
        
        

            
Ürün 2
            
Açıklama 2
            150 TL
        
        

            
Ürün 3
            
Açıklama 3
            200 TL
        
    

Bu basit HTML yapısında, tarayıcı genişliği 768 pikselin altına düştüğünde ürün listesi tek sütunlu hale gelir ve ürün öğelerinin arka plan rengi değişir. Bu tür responsive tasarım prensiplerini web UI projelerinize uygulayarak uygulamanızın her cihazda kullanıcı dostu olmasını sağlayabilirsiniz.

Performans İpuçları (WSL Docker için):

• Kaynak Tahsisi: Docker Desktop ayarlarında (Resources -> WSL Integration), Docker'ın WSL2 VM'ine ne kadar CPU ve RAM tahsis edeceğini kontrol edebilirsiniz. Geliştirme ortamınızın ihtiyaçlarına göre bu değerleri ayarlamak, performansı artırabilir.
• wsl --shutdown: Bazen WSL2 VM'i gereksiz kaynak tüketmeye devam edebilir. Kullanmadığınız zamanlarda terminalden wsl --shutdown komutunu çalıştırarak WSL2'yi tamamen kapatmak, sistem kaynaklarını boşaltır ve bir sonraki başlatmada temiz bir başlangıç sağlar.
• docker system prune: Kullanılmayan Docker imajları, konteynerleri ve ağları sisteminizde yer kaplayabilir. Düzenli olarak docker system prune -a komutunu çalıştırmak, gereksiz kaynakları temizleyerek disk alanından tasarruf eder ve potansiyel performans sorunlarını önler.

Bu gerçek dünya senaryosu ve performans ipuçları, .NET Aspire ve WSL Docker'ın sadece teorik değil, aynı zamanda pratik ve verimli çözümler sunduğunu göstermektedir. Bu güçlü ikili sayesinde, karmaşık mikroservis uygulamalarını bile yerel geliştirme ortamınızda kolayca tasarlayabilir, geliştirebilir ve test edebilirsiniz.

İleri Düzey Konular ve Uzman İpuçları

Aspire ve WSL Docker'ın temel kullanımına hakim olduktan sonra, şimdi daha deneyimli geliştiriciler için ileri düzey konulara ve optimizasyon püf noktalarına odaklanabiliriz. Bu bölümde, Aspire'ın genişletilebilirliğini, farklı kaynaklarla entegrasyonunu ve performans sorun giderme stratejilerini ele alacağız.

Aspire ile Özel Kaynaklar ve Genişletilebilirlik

Aspire, sadece kendi bünyesindeki veritabanları veya önbellekler gibi yaygın kaynaklarla sınırlı değildir; aynı zamanda özel Docker imajlarını veya harici servisleri de kolayca entegre etmenize olanak tanır. Bu, uygulamanızın benzersiz gereksinimlerini karşılamak için büyük bir esneklik sağlar.

• Özel Docker Konteynerleri Ekleme: Kendi özel Docker imajınızı kullanmak istediğinizde, Aspire'ın AddContainer metodunu kullanabilirsiniz. Örneğin, bir MinIO depolama sunucusunu veya özel bir mesaj kuyruğunu bu şekilde ekleyebilirsiniz:

  
  var builder = DistributedApplication.CreateBuilder(args);
  
  // Özel MinIO konteyneri ekleme
  var minio = builder.AddContainer("minio", "minio/minio")
                     .WithArgs("server", "/data")
                     .WithEnvironment("MINIO_ROOT_USER", "admin")
                     .WithEnvironment("MINIO_ROOT_PASSWORD", "password")
                     .Publish(9000, 9000); // Port eşleştirmesi
  
  // Diğer servisler minio'ya bağlanabilir.
  builder.AddProject("myservice")
         .WithReference(minio);
  
  builder.Build().Run();
          

  Bu sayede, uygulamanızın ihtiyaç duyduğu herhangi bir konteyner tabanlı servisi Aspire orkestrasyonuna dahil edebilirsiniz. WithArgs ile başlangıç argümanları, WithEnvironment ile ortam değişkenleri ve Publish ile port eşleştirmeleri tanımlanabilir.

• Harici Bulut Kaynakları ile Entegrasyon: Aspire, sadece yerel kaynakları değil, aynı zamanda Azure Container Apps, Kubernetes veya diğer bulut servisleri gibi harici kaynakları da temsil edebilir. Bu, yerel geliştirme ortamınızda bir Redis konteyneri kullanırken, üretimde bir Azure Cache for Redis örneğine sorunsuz bir şekilde geçiş yapmanızı sağlar. Bu tür entegrasyonlar için Aspire, farklı dağıtım sağlayıcıları (deployment providers) sunar. AppHost projenizde, AddAzureContainerApp gibi metotları kullanarak Azure kaynaklarını yapılandırabilir ve uygulamanızı doğrudan buluta dağıtabilirsiniz. Bu, CI/CD süreçlerini basitleştirir ve geliştirme ile üretim ortamları arasındaki tutarsızlıkları azaltır.

Optimizasyon ve Sorun Giderme Püf Noktaları

Geliştirme sürecinde zaman zaman performans sorunları veya beklenmedik davranışlarla karşılaşmak doğaldır. İşte Aspire ve WSL Docker ile çalışırken karşılaşabileceğiniz bazı durumlar için optimizasyon ve sorun giderme ipuçları:

• WSL2 Performansı ve Bellek Yönetimi:
  • .wslconfig Dosyası: WSL2'nin sanal makinesine tahsis edilen CPU çekirdeklerini ve belleği özelleştirebilirsiniz. C:\Users\\.wslconfig dosyasını oluşturarak veya düzenleyerek şunları ekleyebilirsiniz:

    
    [wsl2]
    memory=4GB  # WSL2 VM için 4GB RAM tahsis et
    processors=2 # WSL2 VM için 2 CPU çekirdeği tahsis et
    swap=0      # Swap alanı kullanma (performans için bazen daha iyi)
    

    Değişikliklerin etkili olması için wsl --shutdown komutunu çalıştırıp WSL'yi yeniden başlatmanız gerekir. Bu, özellikle WSL2 VM'inin çok fazla sistem kaynağı tüketmesini önleyebilir.

  • Konteyner Kaynak Limitleri: Docker Compose veya AppHost içinde konteynerler için CPU ve bellek limitleri belirleyerek (örneğin WithCpuCount(1) veya WithMemory("512Mi")), kaynak yoğun konteynerlerin tüm sistem kaynaklarını sömürmesini engelleyebilirsiniz.
• Docker Cacheleme Stratejileri:

  Geliştirme sırasında Docker imajlarının yeniden derlenmesi veya çekilmesi zaman alabilir. Dockerfile'larınızı katmanlı olacak şekilde tasarlayarak (örneğin, bağımlılıkları yükleme ve kodu kopyalama adımlarını ayırarak) Docker cache'ini etkili bir şekilde kullanabilirsiniz. Bu, küçük kod değişikliklerinde bile tüm imajın yeniden oluşturulmasını engeller.

• Aspire Logları ve Hata Ayıklama:
  • Aspire Dashboard, servis loglarını ve izlerini görüntülemek için ana merkezdir. Bir sorunla karşılaştığınızda ilk olarak buradaki loglara bakmalısınız.
  • Aspire, .NET uygulamaları için standart hata ayıklama (debugging) deneyimini destekler. Visual Studio'da veya VS Code'da ilgili servislere breakpoint'ler koyarak adım adım çalışmayı izleyebilirsiniz.
  • Eğer bir Aspire kaynağı beklendiği gibi başlamıyorsa, Dashboard'daki "Console Logs" sekmesine bakarak Docker veya ilgili servisin başlangıç hatalarını görebilirsiniz.

Bu ileri düzey konular ve ipuçları, .NET Aspire ve WSL Docker'ı daha verimli ve sorunsuz bir şekilde kullanmanızı sağlayacaktır. Karmaşık senaryolarda karşılaşılan zorlukların üstesinden gelmenize ve güçlü, ölçeklenebilir bulut-yerel uygulamalar geliştirmenize yardımcı olacaktır.

Sonuç: .NET Aspire ve WSL Docker İle Geleceğe Yönelik Geliştirme

.NET Aspire ve WSL Docker, modern dağıtık uygulama geliştirme dünyasında Windows geliştiricileri için devrim niteliğinde bir ikili sunuyor. Bu makale boyunca, bu teknolojilerin neden bu kadar önemli olduğunu, temel kavramlarını, adım adım kurulum süreçlerini ve gerçek dünya senaryolarında nasıl kullanıldıklarını detaylı bir şekilde inceledik. Aspire'ın orkestrasyon yetenekleri, karmaşık mikroservis mimarilerini basitleştirirken, Aspire Dashboard ile uygulamalarınızın tüm bileşenlerini tek bir yerden izleme ve hata ayıklama imkanı sağlıyor. WSL Docker ise, Windows üzerinde Linux konteynerlerini neredeyse yerel bir performansla çalıştırma yeteneğiyle bu sürecin temelini oluşturuyor.

Bu sinerji, geliştiricilerin altyapı detaylarıyla boğuşmak yerine iş mantığına odaklanmasına olanak tanıyarak üretkenliği artırıyor. Tutarlı geliştirme ortamları sayesinde, ekip üyeleri arasındaki entegrasyon sorunları azalıyor ve projelerin teslim süreleri kısalıyor. Bulut-yerel uygulama geliştirme yolculuğunuzda .NET Aspire ve WSL Docker, size güçlü, esnek ve verimli bir başlangıç noktası sunar. Gelecekte, bu araçların bulut entegrasyonlarının ve geliştirici deneyiminin daha da zenginleştiğini göreceğiz. Bu teknolojileri benimseyerek, modern yazılım dünyasının taleplerine uygun, ölçeklenebilir ve yönetilebilir uygulamalar inşa etme konusunda önemli bir avantaj elde edeceksiniz.

Sıkça Sorulan Sorular (SSS)

S1: Aspire sadece Docker ile mi çalışır?

C1: Hayır, Aspire ağırlıklı olarak Docker konteynerlerini yerel geliştirme için kullansa da, genel olarak IDistributedApplicationBuilder arayüzü sayesinde farklı kaynak sağlayıcılarıyla çalışabilir. Örneğin, Kubernetes veya Azure Container Apps gibi platformlarla entegrasyon için dağıtım sağlayıcıları mevcuttur. Aspire'ın amacı, bir uygulamanın tüm bağımlılıklarını soyutlamak ve farklı ortamlar için dağıtım yeteneği sağlamaktır.

S2: WSL2 kullanmak yerine Hyper-V ile Docker çalıştırabilir miyim?

C2: Evet, teknik olarak hala Hyper-V ile Docker Desktop çalıştırabilirsiniz. Ancak, Linux konteynerleri için WSL2 entegrasyonu, dosya G/Ç performansı ve genel kaynak kullanımı açısından önemli avantajlar sunar. Microsoft'un kendisi de Linux konteynerleri için WSL2 kullanımını önermektedir. Eğer Windows konteynerleri ile çalışıyorsanız, Hyper-V bir seçenek olabilir, ancak bu durumda da Docker'ın WSL2 entegrasyonunu devre dışı bırakmanız gerekebilir.

S3: .NET Aspire'ı üretim ortamında kullanabilir miyim?

C3: .NET Aspire, öncelikli olarak geliştirme ve test ortamları için tasarlanmıştır. Amacı, dağıtık uygulamaların yerel geliştirme deneyimini basitleştirmektir. Üretim ortamında genellikle Kubernetes veya Azure Container Apps gibi daha olgun konteyner orkestrasyon platformları kullanılır. Aspire, uygulamanızı bu platformlara dağıtmak için kolaylaştırıcı araçlar ve şablonlar sunar, ancak kendisi doğrudan bir üretim orkestrasyon motoru değildir.

S4: Aspire uygulamam çok yavaş çalışıyor, ne yapmalıyım?

C4: Birkaç olası nedeni olabilir:

1. WSL2 Kaynakları: Docker Desktop ayarlarınızda WSL2 VM'ine yeterli CPU ve RAM tahsis edildiğinden emin olun (bkz. .wslconfig ipucu).
2. Gereksiz Konteynerler: Arka planda çalışan diğer Docker konteynerlerini veya WSL2 dağıtımlarını kapatmayı deneyin (wsl --shutdown).
3. Ağ Gecikmesi: Servisler arası iletişimde veya harici bağımlılıklara (uzak veritabanı vb.) erişimde gecikmeler olabilir. Aspire Dashboard'daki izleme verilerini kontrol edin.
4. Kod Optimizasyonu: Kendi kodunuzdaki performans darboğazlarını (veritabanı sorguları, API çağrıları) kontrol edin.

S5: Aspire ile Kubernetes entegrasyonu mümkün mü?

C5: Evet, kesinlikle mümkün. Aspire, uygulamalarınızı Kubernetes gibi platformlara dağıtmak için geliştirilmiştir. Microsoft, Aspire uygulamalarını Azure Kubernetes Service (AKS) veya diğer Kubernetes kümelerine dağıtmak için kılavuzlar ve araçlar sağlamaktadır. Aspire, OpenTelemetry gibi endüstri standartlarını kullanarak bu dağıtımları kolaylaştırır ve geliştirme ortamınız ile üretim ortamınız arasında tutarlılık sağlamayı hedefler.