Läs mer om .NET Aspire-verktyg
.NET Aspire lägger till verktyg i Visual Studio-användargränssnittet som hjälper dig att skapa och hantera molnbaserade appar. Dessa verktyg kan minska förvirringen eftersom det är tydligt vilka komponenter som utgör hela appen, även om de körs i olika containrar. Instrumentpanelen för .NET Aspire visar också en enhetlig vy över din app som körs med diagnostik- och övervakningsdata som hjälper dig att testa och felsöka den.
Tänk dig scenariot med imaginära utomhuskläder och utrustningsföretag igen. Dina utvecklingsteam har slutfört sin arkitekturdesign för varje mikrotjänst och vill börja utveckla. Du vill förstå hur de kan fungera med .NET Aspire i Visual Studio och på kommandoraden.
I den här lektionen får du lära dig mer om .NET Aspire-verktygen och hur de hjälper utvecklare när de skapar och felsöker molnbaserade appar.
Förutsättningar
Innan du installerar .NET Aspire behöver du följande på datorn:
- .NET 8.0
- Docker Desktop eller Podman som värd för containrar.
- En integrerad utvecklingsmiljö (IDE) som Visual Studio eller en kodredigerare, till exempel Visual Studio Code
Om du använder Visual Studio måste du installera version 17.9 eller senare.
Kommentar
Docker Desktop eller Podman är nödvändiga för att vara värd för de containrar som .NET Aspire använder för att köra mikrotjänster och vissa säkerhetskopieringstjänster. Eftersom .NET Aspire konfigurerar och kompilerar avbildningarna och containrarna åt dig behöver du inte vara expert på containrar.
Installera .NET Aspire
Om du använder Microsoft Visual Studio kan du installera .NET Aspire genom att lägga till .NET Aspire SDK-komponenten från arbetsbelastningen ASP.NET och webbutveckling . När de har installerats blir nya verktyg tillgängliga. Du kommer att slutföra de här stegen i övningen senare i den här modulen.
Om du inte vill använda Installationsprogrammet för Visual Studio kan du också använda .NET CLI för att installera .NET Aspire:
dotnet workload update
dotnet workload install aspire
dotnet workload list
Projektmallar i Visual Studio
Fem .NET Aspire-programmallar läggs till. Du kan använda dem för att skapa ett nytt program:
- .NET Aspire-program: Den här mallen skapar en minimal .NET Aspire-lösning med två projekt som finns: App Host-projektet samordnar lösningen och servicestandardprojektet hanterar återanvändbar konfigurationsinformation för återhämtning, tjänstidentifiering och telemetri.
- .NET Aspire Starter-program: Den här mallen skapar en komplett lösning. Den innehåller samma programvärd - och tjänststandardprojekt som föregående mall och lägger till projekt för en serverdels-API-tjänst och ett klientwebbgränssnitt.
- .NET Aspire App Host: Den här mallen skapar endast appvärdprojektet i en ny lösning. Du kan lägga till mikrotjänster, bibliotek och andra projekt för att slutföra din app.
- Standardvärden för .NET Aspire-tjänsten: Den här mallen skapar endast servicestandardprojektet i en ny lösning.
- .NET Aspire Test Project: Den här mallen skapar xUnit-tester för appvärden.
Kommentar
Du kan också lägga till .NET Aspire i alla befintliga .NET-webbprogram som du öppnar i Visual Studio. Högerklicka på projektet i Solution Explorer, välj Lägg till och välj sedan .NET Aspire Orchestrator Support. Den här åtgärden lägger till programvärd- och tjänststandardprojekt i lösningen och registrerar det befintliga projektet i dem för tjänstidentifiering och andra .NET Aspire-funktioner.
Instrumentpanelen för .NET Aspire
När du arbetar med ditt program kan du använda Visual Studio-felsökningsprogrammet för att köra kod genom att trycka på F5-tangenten. När du gör detta skapar Visual Studio automatiskt Docker-avbildningar för varje mikrotjänst, startar Docker-tjänsten om den inte körs och kör hela programmet. Den visar också instrumentpanelen .NET Aspire, som du kan använda för att ansluta till mikrotjänster, undersöka appens prestanda och övervaka dess beteende:
Viktigt!
.NET Aspire-projektmallarna anger App Host-projektet som startprojekt för lösningen. Om du ändrar startprojektet fungerar inte .NET Aspire-instrumentpanelen och andra aspekter av lösningen korrekt under felsökningen.
På instrumentpanelens startsida kan du se alla resurser som utgör programmet. Varje mikrotjänst visas som ett projekt. Säkerhetskopieringstjänster, till exempel Redis-cacheminnen, visas som Containrar. Andra komponenter kan finnas som körbara filer. Du kan få mer information för varje resurs. Mikrotjänster har också en slutpunktskolumn . Välj länken i den här kolumnen för att ansluta till och testa resursen i webbläsaren.
Det finns fyra övervakningsavsnitt på instrumentpanelen:
- Konsolloggar: På den här sidan visas all text som skickas till standardutdata från det projekt som du väljer längst upp. Standardutdata används ofta för att rapportera händelser eller statusmeddelanden.
- Strukturerade loggar: Den här sidan visar händelser som genereras av OpenTelemetry-biblioteket. Strukturerade loggar är enklare att köra frågor mot än andra logghändelser eftersom de bevarar meddelandemallen och parametrarna.
- Spårningar: Den här sidan visar spårningar för varje begäran som tas emot av din app. Informationen omfattar tidsstämpeln, när spårningen har slutförts och spårningens varaktighet. Kolumnen Spans visar alla resurser som var inblandade i begäran. Om du väljer Visa i kolumnen Information kan du se en tidslinje som illustrerar alla intervall i spårningen och deras varaktigheter.
- Mått: Den här sidan visar diagram för alla mått du väljer. Välj först ett projekt överst på sidan. Välj sedan från listan med mått, som innehåller värden som antal aktiva begäranden, varaktigheter för begäranden, antal anslutningar och andra prestandadata. När du har valt ett mått visas ett livediagram. Du kan ändra tidsintervallet för diagrammet eller filtret för att öka detaljnivån till mer diagnostikinformation.