Delen via

.NET .NET Aspire instellen en hulpprogramma's

  • Artikel

.NET .NET Aspire bevat hulpprogramma's waarmee u cloudeigen apps kunt maken en configureren. De hulpprogramma's bevatten handige sjablonen voor startersproject en andere functies om aan de slag te gaan met .NET Aspire voor Visual Studio, Visual Studio Codeen CLI-werkstromen. In de volgende secties leert u hoe u met .NET.NET Aspire hulpprogramma's kunt werken en de volgende taken kunt verkennen:

  • .NET .NET Aspire en de bijbehorende afhankelijkheden installeren
  • Startersprojectsjablonen maken met behulp van Visual Studio, Visual Studio Codeof de .NET CLI
  • .NET .NET Aspire integraties installeren
  • Werken met het .NET.NET Aspire-dashboard

.NET .NET Aspire installeren

Als u met .NET.NET Aspirewilt werken, hebt u het volgende lokaal geïnstalleerd:

Visual Studio 2022 17.9 of hoger bevat standaard de nieuwste .NET.NET Aspire SDK- wanneer u de workload Web & Cloud installeert.

Als u een eerdere versie van Visual Studio 2022 hebt, kunt u een upgrade uitvoeren naar Visual Studio 2022 17.9 of de .NET Aspire SDK installeren met behulp van de volgende stappen:

Gebruik het .NET Aspire-installatieprogramma om de Visual Studio workload in Visual Studio 2022 te installeren.

  1. Open het Visual Studio-installatieprogramma.

  2. Selecteer Wijzigen naast Visual Studio 2022.

  3. Selecteer de workload ASP.NET en de webontwikkelingsworkload.

  4. Selecteer in het deelvenster Installatiedetails.NET.NET Aspire SDK.

  5. Selecteer Wijzigen om de .NET.NET Aspire-integratie te installeren.

    Een schermopname waarin wordt getoond hoe u de .NET Aspire workload installeert met het Visual Studio-installatieprogramma.

Om ervoor te zorgen dat u de nieuwste versie van de .NET.NET Aspire SDK installeert, ...

Containerruntime

.NET .NET Aspire projecten zijn ontworpen voor uitvoering in containers. U kunt Docker Desktop of Podman als uw containerruntime gebruiken. Docker Desktop is de meest voorkomende containerruntime. Podman is een opensource-daemonloos alternatief voor Docker, waarmee U OCI-containers (Open Container Initiative) kunt bouwen en uitvoeren. Als uw hostomgeving zowel Docker als Podman heeft geïnstalleerd, gebruikt .NET Aspire standaard Docker. U kunt in plaats daarvan .NET Aspire instrueren Podman te gebruiken door de omgevingsvariabele DOTNET_ASPIRE_CONTAINER_RUNTIME in te stellen op podman:

export DOTNET_ASPIRE_CONTAINER_RUNTIME=podman

Zie Podman installeren op Linuxvoor meer informatie.

sjablonen voor .NET.NET Aspire

.NET .NET Aspire biedt een set oplossings- en projectsjablonen. Deze sjablonen zijn beschikbaar in uw favoriete .NET geïntegreerde ontwikkelomgeving. U kunt deze sjablonen gebruiken om volledige .NET Aspire oplossingen te maken of afzonderlijke projecten toe te voegen aan bestaande .NET Aspire-oplossingen. Zie .NET.NET Aspire sjablonenvoor meer informatie.

.NET .NET Aspire instrumentenpaneel

.NET .NET Aspire sjablonen die de app-host project beschikbaar maken, bevatten ook een nuttig dashboard voor ontwikkelaars dashboard dat wordt gebruikt voor het bewaken en inspecteren van verschillende aspecten van uw app, zoals logboeken, traceringen en omgevingsconfiguraties. Dit dashboard is ontworpen om de lokale ontwikkelervaring te verbeteren en biedt een overzicht van de algehele status en structuur van uw app.

Het .NET.NET Aspire dashboard is alleen zichtbaar wanneer de app wordt uitgevoerd en start automatisch wanneer u het *.AppHost project start. Zowel Visual Studio als Visual Studio Code starten uw app en het .NET Aspire-dashboard automatisch voor u in uw browser. Als u de app start met behulp van de .NET CLI, kopieert en plakt u de dashboard-URL uit de uitvoer in uw browser, of houdt u Ctrl- ingedrukt en selecteert u de koppeling (als uw terminal hyperlinks ondersteunt).

Een schermopname waarin wordt getoond hoe u het dashboard start met behulp van de CLI.

De linkernavigatie bevat koppelingen naar de verschillende onderdelen van het dashboard, die u in de volgende secties verkent.

Een schermopname van de pagina .NET.NET Aspire dashboardprojecten.

Het .NET.NET Aspire dashboard is ook beschikbaar in een zelfstandige modus. Zie standalone .NET.NET Aspire dashboardvoor meer informatie.

hulpprogramma's voor Visual Studio

Visual Studio biedt extra functies voor het werken met .NET Aspire-integraties en het App Host Orchestrator-project. Niet al deze functies zijn momenteel beschikbaar in Visual Studio Code of via de CLI.

Een integratiepakket toevoegen

U voegt .NET Aspire integraties toe aan uw app zoals elk ander NuGet-pakket met behulp van Visual Studio. Visual Studio biedt echter ook ui-opties om rechtstreeks .NET Aspire integraties toe te voegen.

  1. Selecteer in Visual Studiomet de rechtermuisknop het project waaraan u een .NET Aspire-integratie wilt toevoegen en selecteer >.NET.NET Aspire Pakket toevoegen....

    Het contextmenu Visual Studio met de optie .NET Aspire Component toevoegen.

  2. Pakketbeheer wordt geopend met vooraf geconfigureerde zoekresultaten (vullende filtercriteria) voor .NET.NET Aspire-integraties, zodat u eenvoudig kunt bladeren en de gewenste integratie kunt selecteren.

    Het contextmenu van de Visual Studio dat de opties toont voor het toevoegen van integratie .NET Aspire.

Raadpleeg .NETvoor meer informatie over .NET Aspire integraties.

Hostingpakketten toevoegen

.NET .NET Aspire hostingpakketten worden gebruikt om verschillende resources en afhankelijkheden te configureren die een app kan afhankelijk zijn van of verbruiken. Hostingpakketten worden onderscheiden van andere integratiepakketten omdat ze worden toegevoegd aan de *. AppHost project. Voer de volgende stappen uit om een hostingpakket toe te voegen aan uw app:

  1. Selecteer in Visual Studiomet de rechtermuisknop op het *.AppHost-project en selecteer Toevoegen>.NET.NET Aspire-pakket....

    Het contextmenu Visual Studio met de optie .NET Aspire Hostingresource toevoegen.

  2. Pakketbeheer wordt geopend met vooraf geconfigureerde zoekresultaten (vullende filtercriteria) voor .NET.NET Aspire hostingpakketten, zodat u eenvoudig kunt bladeren en het gewenste pakket kunt selecteren.

    Het contextmenu van de Visual Studio dat de opties voor het toevoegen van de .NET Aspire-bron weergeeft.

Orchestratieprojecten toevoegen

U kunt .NET.NET Aspire orkestratieprojecten toevoegen aan een bestaande app door de volgende stappen te volgen:

  1. In Visual Studioselecteer met de rechtermuisknop een bestaand project en kies >.NET.NET Aspire Orchestrator-ondersteuning toevoegen...

    Het contextmenu Visual Studio met de optie Ondersteuning voor Orchestrator toevoegen .NET Aspire.

  2. Er wordt een dialoogvenster geopend met een samenvatting van de *. AppHost en *. ServiceDefaults projecten die aan uw oplossing worden toegevoegd.

    Een schermopname die de samenvatting van de orkestratie Visual Studio.NET Aspire toont.

  3. Selecteer OK- en de volgende wijzigingen worden toegepast:

    • De *.AppHost en *.ServiceDefaults orchestratieprojecten worden toegevoegd aan uw oplossing.
    • Er wordt een aanroep naar builder.AddServiceDefaults toegevoegd aan het Program.cs bestand van het oorspronkelijke project.
    • Er wordt een verwijzing naar het oorspronkelijke project toegevoegd aan het Program.cs-bestand van het *.AppHost-project.

Zie .NETvoor meer informatie over .NET Aspire orkestratie.

Deelnemen aan orkestratie

Visual Studio biedt de mogelijkheid om in Aspire indeling te tijdens de nieuwe projectwerkstroom. Selecteer deze optie om Visual Studio*.AppHost en *.ServiceDefaults projecten te creëren naast uw geselecteerde projectsjabloon.

Een schermopname waarin wordt getoond hoe u in .NET.NET Aspire orkestratie kunt opnemen.

Testproject maken

Wanneer u Visual Studiogebruikt en u de sjabloon .NET.NET Aspire Toepassing starten selecteert, hebt u de mogelijkheid om een testproject op te nemen. Dit testproject is een xUnit-project dat een voorbeeldtest bevat die u als uitgangspunt voor uw tests kunt gebruiken.

Een schermopname van Visual Studio met de optie voor het maken van een testproject.

Zie voor meer informatie Schrijf uw eerste .NET.NET Aspire test.

hulpprogramma's voor Visual Studio Code

U kunt Visual Studio Code, met de C# Dev Kit-extensie, gebruiken om .NET.NET Aspire projecten te maken en te ontwikkelen. Als u een nieuw .NET Aspire project wilt maken in Visual Studio Code, selecteert u de knop .NET Project maken in de verkenner weergave en selecteert u vervolgens een van de .NET.NET Aspire-sjablonen:

Een schermopname waarin wordt getoond hoe u een nieuw .NET Aspire project maakt in Visual Studio Code.

Zodra u een nieuw .NET Aspire project hebt gemaakt, voert u de app uit en maakt u fouten op, doorloopt u onderbrekingspunten en inspecteert u variabelen met behulp van het Visual Studio Code foutopsporingsprogramma:

Een schermopname waarin wordt getoond hoe u fouten in een .NET Aspire project in Visual Studio Codekunt opsporen.

Zie ook