Dela via

Aspire installation och verktyg

Aspire innehåller verktyg som hjälper dig att skapa och konfigurera molnbaserade appar. Verktygen innehåller användbara startprojektmallar och andra funktioner för att effektivisera komma igång med Aspire för Visual Studio, Visual Studio Codeoch CLI-arbetsflöden. I de kommande avsnitten får du lära dig hur du arbetar med Aspire verktyg och utforskar följande uppgifter:

  • Installera Aspire och dess beroenden
  • Skapa startprojektmallar med hjälp av Visual Studio, Visual Studio Codeeller .NET CLI
  • Installera Aspire integrationer
  • Arbeta med Aspire instrumentpanelen

Installera Aspire förutsättningar

För att arbeta med Aspirebehöver du följande installerat lokalt:

Tip

Du kan också utveckla Aspire lösningar med hjälp av GitHub Codespaces eller Dev Containers.

Visual Studio 2022 17.9 eller senare innehåller den senaste Aspire SDK:n som standard när du installerar webb- och molnarbetsbelastningen.

Aspire Mallar

Aspire innehåller en uppsättning lösnings- och projektmallar. Dessa mallar är tillgängliga i din favoritintegrerade utvecklingsmiljö .NET. Du kan använda dessa mallar för att skapa fullständiga Aspire lösningar eller lägga till enskilda projekt i befintliga Aspire lösningar.

Installera mallarna Aspire

Om du vill installera Aspire mallar i Visual Studiomåste du installera dem manuellt om du inte använder Visual Studio 17.12 eller senare. Följ dessa steg för Visual Studio 17.9 till 17.11:

  1. Öppna Visual Studio.
  2. Gå till Tools>NuGet Package Manager>Package Manager Console.
  3. Kör följande kommando för att installera mallarna:
dotnet new install Aspire.ProjectTemplates

För Visual Studio 17.12 eller senare installeras Aspire-mallarna automatiskt.

Om du vill installera dessa mallar använder du kommandot dotnet new install genom att ange Aspire.ProjectTemplates NuGet-identifierare.

dotnet new install Aspire.ProjectTemplates

Om du vill installera en viss version lägger du till versionsnumret i paketnamnet:

dotnet new install Aspire.ProjectTemplates::9.4.0

Visa en lista över Aspire mallarna

Aspire-mallarna installeras automatiskt när du installerar Visual Studio 17.9 eller senare. Om du vill se vilka Aspire mallar som är tillgängliga väljer du Arkiv>Nytt>projekt i Visual Studiooch söker efter "Aspire" i sökfältet (Alt+S). Du ser en lista över tillgängliga Aspire projektmallar:

Visual Studio: Skapa ett nytt projekt och sök efterAspire.

Om du vill visa tillgängliga mallar i Visual Studio Code med C# DevKit installerat väljer du knappen Skapa .NET Project när ingen mapp öppnas i Explorer vy:

Visual Studio Code: Skapa-knapp för .NET-projekt.

Sök sedan efter "Aspire" i sökfältet för att se tillgängliga Aspire projektmallar:

Visual Studio Code: Skapa ett nytt projekt och sök efterAspire.

Kontrollera att mallarna Aspire är installerade genom att använda kommandot dotnet new list och skicka in aspire mallnamnet:

dotnet new list aspire

Konsolens utdata bör se ut så här:

dotnet new list aspire
These templates matched your input: 'aspire'

Template Name                      Short Name              Language  Tags
---------------------------------  ----------------------  --------  -------------------------------------------------------
Aspire AppHost               aspire-apphost          [C#]      Common/Aspire/Cloud
Aspire Empty App              aspire                  [C#]      Common/Aspire/Cloud/Web/Web API/API/Service
Aspire Service Defaults       aspire-servicedefaults  [C#]      Common/Aspire/Cloud/Web/Web API/API/Service
Aspire Starter App            aspire-starter          [C#]      Common/Aspire/Blazor/Web/Web API/API/Service/Cloud
Aspire Test Project (MSTest)  aspire-mstest           [C#]      Common/Aspire/Cloud/Web/Web API/API/Service/Test
Aspire Test Project (NUnit)   aspire-nunit            [C#]      Common/Aspire/Cloud/Web/Web API/API/Service/Test
Aspire Test Project (xUnit)   aspire-xunit            [C#]      Common/Aspire/Cloud/Web/Web API/API/Service/Test

Mer information finns i Aspire mallar.

Containerkörning

Aspire kan köra containrar med flera OCI-kompatibla körningsmiljöer, inklusive Docker Desktop och Podman. Vissa användare har rapporterat att de har lyckats med Rancher Desktop , särskilt när de Docker har konfigurerats för att använda CLI, men detta är inte ett scenario som stöds officiellt eller testas regelbundet. Det kan vara möjligt att använda Rancher Desktop med standardinstallationen, men det är inte en officiellt stödd eller validerad metod. Om du stöter på problem med Rancher Desktop kan du meddela oss, men tänk på att korrigeringar kanske inte prioriteras.

  • Docker Desktop är den mest populära containerkörningen bland Aspire utvecklare och erbjuder en välbekant och allmänt stödd miljö för att skapa och köra containrar.
  • Podman är ett daemonlöst alternativ med öppen källkod till Docker. Det har stöd för att skapa och köra OCI-containrar (Open Container Initiative), vilket gör det till ett flexibelt val för utvecklare som föredrar en enkel lösning.

Om din värdmiljö har en Docker och Podman installerad, används Aspire som standard till att använda Docker. Du kan instruera Aspire att använda Podman i stället genom att ange ASPIRE_CONTAINER_RUNTIME miljövariabeln till podman:

export ASPIRE_CONTAINER_RUNTIME=podman

Mer information finns i Installera Podman på Linux.

Överväganden för WSL (Windows-undersystem för Linux)

När du använder Podman med WSL kontrollerar du att den podman körbara filen är tillgänglig i ditt PATH och inte bara definieras som ett gränssnittsalias. Aspire löser containerkörningar genom att söka efter den körbara filen i systemsökvägen, och gränssnittsalias identifieras inte under den här processen.

Vanliga problem och lösningar:

  • Podman installerat i en separat WSL-distribution: Om Podman är installerat i en annan WSL-distribution än ditt Aspire program kanske podman kommandot inte är tillgängligt i den aktuella distributionens PATH.

    Lösning: Installera Podman direkt i WSL-distributionen där du kör ditt Aspire program eller skapa en symbolisk länk till den Podman körbara filen i en katalog som finns i din PATH (till exempel /usr/local/bin).

  • Använda gränssnittsalias: Om du har ett gränssnittsalias som alias podman='podman-remote-static-linux_amd64' i din ~/.bash_aliases eller liknande fil kan Aspire du inte hitta containerkörningen.

    Lösning: I stället för att använda ett alias skapar du en symbolisk länk eller lägger till katalogen som innehåller den Podman körbara filen i din PATH:

    # Option 1: Create a symbolic link
sudo ln -s /path/to/podman-remote-static-linux_amd64 /usr/local/bin/podman

# Option 2: Add to PATH in your shell profile
echo 'export PATH="/path/to/podman/directory:$PATH"' >> ~/.bashrc
source ~/.bashrc

Kontrollera konfigurationen: Du kan kontrollera att den är korrekt konfigurerad genom att Podman köra:

which podman
podman --version

Båda kommandona ska lyckas och returnera giltiga resultat innan du kör programmet Aspire .

Tip

Om du stöter på problem med Podman i WSL-miljöer kan du läsa "podman" för containerkörningen kunde inte hittas i WSL för specifik felsökningsvägledning.

Aspire instrumentbräda

Aspire Mallar som exponerar AppHost-projektet innehåller även en användbar instrumentpanel för utvecklare som används för att övervaka och inspektera olika aspekter av din app, till exempel loggar, spårningar och miljökonfigurationer. Den här instrumentpanelen är utformad för att förbättra den lokala utvecklingsupplevelsen och ger en översikt över appens övergripande tillstånd och struktur.

Instrumentpanelen Aspire visas bara när appen körs och startar automatiskt när du startar *. AppHost-projekt . Visual Studio och Visual Studio Code startar både din app och din Aspire-instrumentpanel automatiskt i webbläsaren. Om du startar appen med hjälp av .NET CLI kopierar och klistrar du in instrumentpanelens URL från utdata i webbläsaren eller håller ned Ctrl och väljer länken (om terminalen stöder hyperlänkar).

En skärmbild som visar hur du startar instrumentpanelen med hjälp av CLI.

Det vänstra navigeringsfältet innehåller länkar till de olika delarna av instrumentpanelen, som du utforskar i följande avsnitt.

En skärmbild av sidan Projekt på Aspire instrumentpanelen.

Instrumentpanelen Aspire är också tillgänglig i ett fristående läge. Mer information finns i Fristående Aspire instrumentpanel.

Visual Studio verktygsutrustning

Visual Studio innehåller extra funktioner för att arbeta med Aspire integreringar och AppHost-orkestreringsprojektet. Alla dessa funktioner är för närvarande inte tillgängliga i Visual Studio Code eller via CLI.

Lägga till ett integrationspaket

Du lägger till Aspire-integreringar i din app som vilket annat NuGet-paket med hjälp av Visual Studio. Men Visual Studio innehåller även användargränssnittsalternativ för att lägga till Aspire integreringar direkt.

  1. I Visual Studioväljer du det projekt som du vill lägga till en Aspire integrering i och väljer Lägg till>Aspire paket....

    Snabbmenyn Visual Studio med alternativet Lägg till Aspire komponent.

  2. Pakethanteraren öppnas med förkonfigurerade sökresultat (fyller filtervillkor) för Aspire integreringar, så att du enkelt kan bläddra och välja önskad integrering.

    Snabbmenyn Visual Studio som visar integreringsalternativen Lägg till Aspire.

Mer information om Aspire integreringar finns i Aspire översikten över integreringar.

Lägga till värdpaket

Aspire värdpaket används för att konfigurera olika resurser och beroenden som en app kan vara beroende av eller använda. Värdskapspaket skiljer sig från andra integrationspaket eftersom de läggs till i *.AppHost-projektet. Följ dessa steg för att lägga till ett värdpaket i din app:

  1. I Visual Studioväljer du höger på *. AppHost-projekt och välj Lägg till>Aspire paket....

    Snabbmenyn Visual Studio som visar alternativet Lägg till Aspire värdresurs.

  2. Pakethanteraren öppnas med förkonfigurerade sökresultat (med förinställda filterkriterier) för Aspire värdpaket, vilket gör det enkelt för dig att bläddra och välja önskat paket.

    Snabbmenyn Visual Studio som visar alternativen för att lägga till Aspire-resurser.

Lägga till orkestreringsprojekt

Du kan lägga till Aspire orkestreringsprojekt i en befintlig app med hjälp av följande steg:

  1. I Visual Studiohögerklickar du på ett befintligt projekt och sedan väljer du Lägg till>Aspire Orchestrator Support.

    Snabbmenyn Visual Studio som visar alternativet Lägg till Aspire Orchestrator-support.

  2. Ett dialogfönster öppnas med en sammanfattning av *. AppHost och *. ServiceDefaults projekt som läggs till i din lösning.

    En skärmbild som visar Visual Studio lägga till Aspire orkestreringssammanfattning.

  3. Välj OK och följande ändringar tillämpas:

    • *.AppHost och *.ServiceDefaults orkestrerings-projekt läggs till i din lösning.
    • Ett anrop till builder.AddServiceDefaults läggs till i Program.cs-filen i det ursprungliga projektet.
    • En referens till det ursprungliga projektet läggs till i filen AppHost.cs i *. AppHost projekt.

Mer information om Aspire orkestrering finns i Aspire översikt över orkestrering.

Gå med i orkestrering

Visual Studio erbjuder möjligheten att anmäla sig till Aspire samordning i samband med det nya projektarbetsflödet. Välj det här alternativet om du vill låta Visual Studio skapa *.AppHost och *.ServiceDefaults-projekt tillsammans med den valda projektmallen.

En skärmbild som visar hur du går med i Aspire orkestrering.

Skapa testprojekt

När du använder Visual Studiooch väljer mallen Aspire Starta program har du möjlighet att inkludera ett testprojekt. Det här testprojektet är ett xUnit-projekt som innehåller ett exempeltest som du kan använda som utgångspunkt för dina tester.

En skärmbild av Visual Studio som visar alternativet att skapa ett testprojekt.

Mer information finns i Skriva ditt första Aspire test.

Visual Studio Code verktygsutrustning

Du kan använda Visual Studio Code, med C# Dev Kit tillägget, för att skapa och utveckla Aspire projekt. Om du vill skapa ett nytt Aspire projekt i Visual Studio Codeväljer du knappen Skapa .NET projekt i utforskarvyn och väljer sedan en av mallarna Aspire :

En skärmbild som visar hur du skapar ett nytt Aspire projekt i Visual Studio Code.

När du har skapat ett nytt Aspire projekt kör och felsöker du appen, stegar igenom brytpunkter och inspekterar variabler med hjälp av Visual Studio Code felsökningsprogrammet:

En skärmbild som visar hur du felsöker ett Aspire projekt i Visual Studio Code.

Aspire CLI

Aspire CLI (aspirekommandot) är ett plattformsoberoende verktyg som tillhandahåller kommandoradsfunktioner för att skapa, hantera, köra och publicera flerspråkiga Aspire projekt. Aspire Använd CLI för att effektivisera arbetsflöden för utveckling och samordna tjänster för distribuerade program.

För mer information, se Aspire CLI-översikt och Installera Aspire CLI.

Se även