Aracılığıyla paylaş

.NET .NET Aspire kurulum ve donanımları

  • Makale

.NET .NET Aspire, bulutta yerel uygulamalar oluşturmanıza ve yapılandırmanıza yardımcı olacak araçlar içerir. Araçlar, .NET Aspire, Visual Studiove CLI iş akışları için Visual Studio Code kullanmaya başlamayı kolaylaştırmak için yararlı başlangıç proje şablonları ve diğer özellikleri içerir. Sonraki bölümlerde, .NET.NET Aspire araçlarıyla çalışmayı ve aşağıdaki görevleri keşfetmeyi öğreneceksiniz:

  • .NET .NET Aspire ve bağımlılıklarını yükleyin
  • Visual Studio, Visual Studio Codeveya .NET CLI kullanarak başlangıç projesi şablonları oluşturma
  • .NET .NET Aspire tümleştirmelerini yükleme
  • .NET .NET Aspire panosuyla çalışma

Yükle .NET.NET Aspire

.NET .NET Aspireile çalışmak için aşağıdakilerin yerel olarak yüklenmesi gerekir:

Visual Studio 2022 17.9 veya üzeri, Web & Cloud iş yükünü yüklediğinizde varsayılan olarak en son .NET.NET Aspire SDK içerir.

Visual Studio 2022'nin önceki bir sürümüne sahipseniz, Visual Studio 2022 17.9 sürümüne yükseltebilir veya aşağıdaki adımları kullanarak .NET Aspire SDK'sını yükleyebilirsiniz:

.NET Aspire 2022'de Visual Studio iş yükünü yüklemek için Visual Studio yükleyicisini kullanın.

  1. Visual Studio Yükleyicisi'ni açın.

  2. 2022Visual Studio Değiştir'i seçin.

  3. ASP.NET ve web geliştirme iş yükünü seçin.

  4. Yükleme ayrıntıları panelinde .NET.NET Aspire SDKöğesini seçin.

  5. .NET tümleştirmesini yüklemek için .NET Aspire Değiştir'i seçin.

    .NET Aspire yükleyicisiyle Visual Studio iş yükünün nasıl yükleneceğini gösteren ekran görüntüsü.

.NET .NET Aspire SDK'sının en son sürümünü yüklediğinizden emin olmak için...

Kapsayıcı yürütme ortamı

.NET .NET Aspire projeleri kapsayıcılarda çalışacak şekilde tasarlanmıştır. Kapsayıcı çalışma zamanı olarak Docker Desktop veya Podman kullanabilirsiniz. Docker Desktop en yaygın kapsayıcı çalışma zamanıdır. Podman, Open Container Initiative (OCI) kapsayıcıları oluşturup çalıştırabilen Dockeriçin açık kaynak bir daemonless alternatifidir. Konak ortamınızda hem Docker hem de Podman yüklüyse, .NET Aspire varsayılan olarak Dockerkullanır. .NET Aspire ortam değişkenini Podmanolarak ayarlayarak DOTNET_ASPIRE_CONTAINER_RUNTIMEpodman kullanmasını sağlayabilirsiniz:

export DOTNET_ASPIRE_CONTAINER_RUNTIME=podman

Daha fazla bilgi için bkz: Podman yükleme Linux.

şablonları .NET.NET Aspire

.NET .NET Aspire bir dizi çözüm ve proje şablonu sağlar. Bu şablonlar, sık kullandığınız .NET geliştirici tümleşik ortamında kullanılabilir. Bu şablonları kullanarak tam .NET Aspire çözümleri oluşturabilir veya mevcut .NET Aspire çözümlerine tek tek projeler ekleyebilirsiniz. Daha fazla bilgi için bkz. şablonları.

.NET .NET Aspire panosu

.NET projesini kullanıma sunan .NET Aspire şablonları, ayrıca, uygulamanızın günlükler, izlemeler ve ortam yapılandırmaları gibi çeşitli yönlerini izlemek ve incelemek için kullanılan geliştirici için yararlı bir kontrol paneli de içerir. Bu pano, yerel geliştirme deneyimini geliştirmek için tasarlanmıştır ve uygulamanızın genel durumuna ve yapısına genel bir bakış sağlar.

.NET .NET Aspire panosu yalnızca uygulama çalışırken görünür ve *.AppHost projesini başlattığınızda otomatik olarak başlar. Visual Studio ve Visual Studio Code hem uygulamanızı hem de .NET Aspire panosunu tarayıcınızda otomatik olarak başlatır. Uygulamayı CLI kullanarak başlatırsanız, çıkıştan pano URL'sini kopyalayıp tarayıcınıza yapıştırın veya Ctrl basılı tutun ve bağlantıyı seçin (terminaliniz köprüleri destekliyorsa).

CLI kullanarak panonun nasıl başlatıldığını gösteren ekran görüntüsü.

Sol gezinti, her biri aşağıdaki bölümlerde inceleyebileceğiniz panonun farklı bölümlerine bağlantılar sağlar.

.NET.NET Aspire panosu Projeleri sayfasının ekran görüntüsü.

.NET .NET Aspire panosu tek başına modda da kullanılabilir. Daha fazla bilgi için bağımsız .NET.NET Aspire gösterge panosu'ye bakın.

Visual Studio araçları

Visual Studio, .NET Aspire tümleştirmeleri ve Uygulama Konağı düzenleyici projesiyle çalışmaya yönelik ek özellikler sağlar. Bu özelliklerin tümü şu anda Visual Studio Code veya CLI aracılığıyla kullanılamamaktadır.

Tümleştirme paketi ekleme

.NET Aspirekullanarak diğer tüm NuGet paketleri gibi uygulamanıza Visual Studio tümleştirmeleri eklersiniz. Ancak Visual Studio doğrudan .NET Aspire tümleştirmeleri eklemek için kullanıcı arabirimi seçenekleri de sağlar.

  1. Visual Studio'de, .NET Aspire tümleştirmesi eklemek istediğiniz projeye sağ tıklayın ve >.NET.NET Aspire paketiniekle'yi seçin.

    Visual Studio Bileşeni Ekle seçeneğinin görüntülendiği .NET Aspire bağlam menüsü.

  2. Paket yöneticisi, .NET.NET Aspire tümleştirmeleri için önceden yapılandırılmış (filtre ölçütlerini dolduran) arama sonuçlarıyla açılır ve istediğiniz tümleştirmeye kolayca göz atmanıza ve seçmenize olanak sağlar.

    Visual Studio tümleştirmesi ekle seçeneklerinin görüntülendiği .NET Aspire bağlam menüsü.

tümleştirmeleri hakkında daha fazla bilgi için bkz. tümleştirmelere genel bakış.

Barındırma paketleri ekleme

.NET .NET Aspire barındırma paketleri, bir uygulamanın bağımlı olabileceği veya kullanabileceği çeşitli kaynakları ve bağımlılıkları yapılandırmak için kullanılır. Barındırma paketleri, diğer tümleştirme paketlerinden, *.AppHost projesine eklendikleri için farklıdır. Uygulamanıza barındırma paketi eklemek için şu adımları izleyin:

  1. Visual Studiobölümünde, üzerine sağ tıklayın. projeyi AppHost seçin ve Ekle>.NET.NET Aspire paketi...ekleyin.

    Visual Studio Barındırma Kaynağı Ekle seçeneğinin görüntülendiği .NET Aspire bağlam menüsü.

  2. Paket yöneticisi, .NET.NET Aspire barındırma paketleri için önceden yapılandırılmış arama sonuçlarıyla (filtre ölçütlerini doldurma) açılır ve istediğiniz pakete kolayca göz atmanızı ve seçmenizi sağlar.

    Visual Studio kaynağı ekle seçeneklerinin görüntülendiği .NET Aspire bağlam menüsü.

Orkestrasyon projeleri ekleme

Aşağıdaki adımları kullanarak mevcut bir uygulamaya .NET.NET Aspire düzenleme projeleri ekleyebilirsiniz:

  1. Visual Studio'da mevcut bir proje üzerinde sağ tıklayın ve >.NET.NET Aspire Orchestrator Desteği Ekle... seçin..

    Visual Studio bağlam menüsü, .NET Aspire Orchestrator Desteği Ekle seçeneğini görüntülüyor.

  2. * özetini içeren bir iletişim kutusu penceresi açılır. AppHost ve *. ServiceDefaults, çözümünüze eklenen projeleri.

    Visual Studio ekleme .NET Aspire düzenleme özeti gösteren ekran görüntüsü.

  3. OK seçin ve aşağıdaki değişiklikler uygulanır:

    • *. AppHost ve *. ServiceDefaults düzenleme projeleri çözümünüze eklenir.
    • özgün projenizin builder.AddServiceDefaults dosyasına Program.cs çağrısı eklenir.
    • Özgün projenize bir referans, Program.cs projesinin dosyasına eklenecektir.

.NET .NET Aspire düzenleme hakkında daha fazla bilgi için bkz. .NET.NET Aspire düzenlemeye genel bakış.

Orkestrasyon işlemine kaydol

, yeni proje iş akışı sırasında düzenleme Listeleme seçeneği sağlar. Visual Studio, *.AppHost ve *.ServiceDefaults projelerini seçtiğiniz proje şablonuyla birlikte oluşturmasını sağlamak için bu seçeneği belirleyin.

.NET.NET Aspire orkestrasyonuna nasıl kaydolunacağını gösteren ekran görüntüsü.

Test projesi oluşturma

Visual Studiokullanırken .NET.NET Aspire Uygulamayı Başlat şablonunu seçtiğinizde, bir test projesi ekleme seçeneğiniz vardır. Bu test projesi, testleriniz için başlangıç noktası olarak kullanabileceğiniz bir örnek test içeren bir xUnit projesidir.

Test projesi oluşturma seçeneğinin görüntülendiği Visual Studio ekran görüntüsü.

Daha fazla bilgi için bkz. İlk .NET.NET Aspire testinizi yazın.

Visual Studio Code araçları

Visual Studio Code C# Dev Kit projeleri oluşturmak ve geliştirmek için .NETile .NET Aspirekullanabilirsiniz. 'da yeni bir projesi oluşturmak için, Gezgini görünümünde Proje oluştur ve ardından şablonlarından birini seçin:

.NET Aspire'da yeni bir Visual Studio Code projesi oluşturmayı gösteren ekran görüntüsü.

Yeni bir .NET Aspire projesi oluşturduktan sonra, Visual Studio Code hata ayıklayıcısını kullanarak uygulamayı çalıştırıp hatalarını ayıklar, kesme noktalarında ilerleyip değişkenleri incelersiniz:

.NET Aspirebir Visual Studio Code projesinde hata ayıklamayı gösteren ekran görüntüsü.

Ayrıca bkz.