Meer informatie over .NET Aspire-hulpprogramma's
.NET Aspire voegt hulpprogramma's toe aan de Visual Studio-gebruikersinterface om u te helpen bij het maken en beheren van cloudeigen apps. Deze hulpprogramma's kunnen verwarring vergemakkelijken omdat het duidelijk is welke integraties uw volledige app vormen, ook al worden ze uitgevoerd in verschillende containers. Het .NET Aspire-dashboard biedt ook een uniforme weergave van uw actieve app, met diagnostische en bewakingsgegevens om u te helpen het te testen en fouten op te sporen.
Denk opnieuw aan het denkbeeldige scenario van een outdoorbedrijf voor kleding en uitrusting. Uw ontwikkelteams hebben hun architectuurontwerpen voor elke microservice voltooid en willen beginnen met ontwikkelen. U wilt begrijpen hoe zij met .NET Aspire kunnen werken in Visual Studio en op de opdrachtregel.
In deze les leert u meer over de .NET Aspire-hulpprogramma's en hoe ze ontwikkelaars helpen bij het maken en opsporen van fouten in cloudeigen apps.
Voorwaarden
Voordat u .NET Aspire installeert, hebt u het volgende nodig op uw computer:
- .NET 8.0.
- Docker Desktop of Podman voor het hosten van containers.
- Een IDE (Integrated Development Environment) zoals Visual Studio of een code-editor zoals Visual Studio Code.
Als u Visual Studio gebruikt, moet u versie 17.9 of hoger installeren.
Notitie
Docker Desktop of Podman is nodig voor het hosten van de containers die .NET Aspire gebruikt om microservices en sommige back-upservices uit te voeren. Aangezien .NET Aspire de installatiekopieën en containers voor u configureert en compileert, hoeft u geen expert in containers te zijn.
.NET Aspire installeren
Als u Microsoft Visual Studio gebruikt, kunt u .NET Aspire installeren door de .NET Aspire SDK toe te voegen integratie vanuit de ASP.NET- en webontwikkelingsworkload. Zodra de installatie is uitgevoerd, worden er nieuwe hulpprogramma's beschikbaar. Verderop in deze module voert u deze stappen uit in de oefening.
Als u het Installatieprogramma van Visual Studio niet wilt gebruiken, kunt u ook de .NET CLI gebruiken om .NET Aspire te installeren:
dotnet workload update
dotnet workload install aspire
dotnet workload list
Projectsjablonen in Visual Studio
Er worden vijf .NET Aspire-toepassingssjablonen toegevoegd. U kunt deze gebruiken om een nieuwe toepassing te maken:
- .NET Aspire Application: met deze sjabloon maakt u een minimale .NET Aspire-oplossing met twee projecten: het App Host project organiseert de oplossing en de servicestandaarden project beheert herbruikbare configuratiedetails voor tolerantie, servicedetectie en telemetrie.
- .NET Aspire Starter-toepassing: met deze sjabloon maakt u een volledige oplossing. Het bevat dezelfde App Host en Service-standaardinstellingen projecten als de vorige sjabloon en voegt projecten toe voor een back-end-API-service en een front-endwebinterface.
- .NET Aspire App Host: met deze sjabloon wordt alleen het App Host-project in een nieuwe oplossing gemaakt. U kunt microservices, bibliotheken en andere projecten toevoegen om uw app te voltooien.
- .NET Aspire Service Defaults: met deze sjabloon wordt alleen het project Service defaults gemaakt in een nieuwe oplossing.
- .NET Aspire Test Project: met deze sjabloon worden xUnit-tests voor de app-host gemaakt.
Notitie
U kunt .NET Aspire ook toevoegen aan elke bestaande .NET-webtoepassing die u opent in Visual Studio. Klik in Solution Explorermet de rechtermuisknop op het project, selecteer toevoegen en selecteer vervolgens .NET Aspire Orchestrator Support. Met deze actie worden standaardprojecten voor app-host en -service toegevoegd aan de oplossing en wordt het bestaande project hierin ingeschreven voor servicedetectie en andere .NET Aspire-functies.
Het .NET Aspire-dashboard
Terwijl u aan uw toepassing werkt, kunt u het foutopsporingsprogramma van Visual Studio gebruiken om code uit te voeren door op de toets F5 te drukken. Wanneer u F5selecteert, worden Docker-installatiekopieën automatisch gemaakt voor elke microservice, wordt de Docker-service gestart als deze niet wordt uitgevoerd en wordt de volledige toepassing uitgevoerd. Ook wordt het .NET Aspire-dashboard weergegeven, dat u kunt gebruiken om verbinding te maken met microservices, de prestaties van de app te onderzoeken en het gedrag ervan te controleren:
Belangrijk
De .NET Aspire-projectsjablonen stellen het App Host-project in als het opstartproject voor de oplossing. Als u het opstartproject wijzigt, werken het .NET Aspire-dashboard en andere aspecten van uw oplossing niet correct tijdens foutopsporing.
Op de startpagina van het dashboard ziet u alle resources waaruit de toepassing bestaat. Elke microservice wordt vermeld als een Project-. Backing-services, zoals Redis-caches, worden vermeld als Containers. Andere integraties kunnen beschikbaar zijn als Uitvoerbare bestanden. U kunt meer details verkrijgen voor elke bron. Microservices hebben ook een kolom Endpoint. Selecteer de koppeling in deze kolom om verbinding te maken met de resource en deze te testen in de browser.
Er zijn vier bewakingssecties in het dashboard:
- consolelogboeken: op deze pagina worden alle tekst weergegeven die wordt verzonden naar standaarduitvoer van het project dat u bovenaan selecteert. Standaarduitvoer wordt vaak gebruikt om gebeurtenissen of statusberichten te rapporteren.
- gestructureerde logboeken: op deze pagina worden gebeurtenissen weergegeven die zijn gegenereerd door de OpenTelemetry-bibliotheek. Gestructureerde logboeken zijn eenvoudiger om query's uit te voeren dan andere logboeken, omdat ze de berichtsjabloon en -parameters behouden.
- Traceringen: op deze pagina worden traceringen weergegeven voor elke aanvraag die door uw app is ontvangen. De details bevatten de tijdstempel, wanneer de tracering is voltooid en de duur van de tracering. In de kolom worden alle resources weergegeven die betrokken zijn bij de aanvraag. Als u Weergave selecteert in de kolom Details, ziet u een tijdlijn waarop alle segmenten in de tracering en hun duur worden weergegeven.
- metrische gegevens: op deze pagina worden grafieken weergegeven voor eventuele metrische gegevens die u selecteert. Kies eerst een project boven aan de pagina. Kies vervolgens in de lijst met metrische gegevens, waaronder waarden zoals het aantal actieve aanvragen, de duur van de aanvraag, het aantal verbindingen en andere prestatiegegevens. Wanneer u een metrische waarde selecteert, wordt een livegrafiek weergegeven. U kunt het tijdsinterval voor de grafiek of het filter wijzigen om in te zoomen op meer diagnostische gegevens.