Delen via


.NET .NET Aspire instellen en tools

.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

Vereisten voor .NET.NET Aspire installeren

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

Hint

U kunt ook .NET.NET Aspire oplossingen ontwikkelen met behulp van GitHub Codespaces of Dev Containers.

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. Kies 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.

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.

De .NET.NET Aspire-sjablonen installeren

Als u de .NET Aspire-sjablonen in Visual Studiowilt installeren, moet u deze handmatig installeren, tenzij u Visual Studio 17.12 of hoger gebruikt. Voor Visual Studio 17,9 tot en met 17.11 voert u de volgende stappen uit:

  1. Visual Studio openen.
  2. Ga naar Tools>NuGet Package Manager>Package Manager Console.
  3. Voer de volgende opdracht uit om de sjablonen te installeren:
dotnet new install Aspire.ProjectTemplates

Voor Visual Studio 17.12 of hoger worden de .NET Aspire-sjablonen automatisch geïnstalleerd.

Als u deze sjablonen wilt installeren, gebruikt u de opdracht dotnet new install en geeft u de Aspire.ProjectTemplates NuGet-id door.

dotnet new install Aspire.ProjectTemplates

Als u een specifieke versie wilt installeren, voegt u het versienummer toe aan de pakketnaam:

dotnet new install Aspire.ProjectTemplates::9.0.0

Hint

Als u de .NET.NET Aspire workload al hebt geïnstalleerd, moet u de --force vlag doorgeven om de bestaande sjablonen te overschrijven. U kunt gerust de .NET.NET Aspire workload verwijderen.

De .NET.NET Aspire-sjablonen weergeven

De .NET Aspire-sjablonen worden automatisch geïnstalleerd wanneer u Visual Studio 17.9 of hoger installeert. Als u wilt zien welke .NET.NET Aspire sjablonen beschikbaar zijn, selecteert u Bestand>Nieuw>Project- in Visual Studioen zoekt u in de zoekbalk naar 'Aspire' (Alt+S-). U ziet een lijst met beschikbare .NET.NET Aspire projectsjablonen:

Visual Studio: Maak een nieuw project en zoek naar 'Aspire'.

Als u de beschikbare sjablonen in Visual Studio Code wilt weergeven waarop de C# DevKit is geïnstalleerd, selecteert u de knop Maken .NET Project wanneer er geen map wordt geopend in de Explorer- weergave:

Visual Studio Code: Maak knop .NET Project aan.

Zoek vervolgens in de zoekbalk naar 'Aspire' om de beschikbare .NET Aspire projectsjablonen te bekijken:

Visual Studio Code: Maak een nieuw project en zoek naar 'Aspire'.

Als u wilt controleren of de .NET.NET Aspire-sjablonen zijn geïnstalleerd, gebruikt u de opdracht dotnet new list en geeft u de naam van de aspire-sjabloon door:

dotnet new list aspire

De console-uitvoer moet er als volgt uitzien:

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

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

Zie .NET.NET Aspire sjablonenvoor meer informatie.

Container runtime

.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.

.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.NET 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.NET orkestratie.

Deelnemen aan orkestratie

Visual Studio biedt de mogelijkheid om in Aspire orkestratie deel te nemen 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.

Visual Studio Code-gereedschappen

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