Delen via

Aspire installatie en gereedschappen

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 Aspire voor Visual Studio, Visual Studio Codeen CLI-werkstromen. In de volgende secties leert u hoe u met Aspire hulpprogramma's kunt werken en de volgende taken kunt verkennen:

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

Vereisten installeren Aspire

Om met Aspire te werken, moet u het volgende lokaal geïnstalleerd hebben:

Tip

U kunt ook oplossingen ontwikkelen Aspire met CodespacesGitHub of Dev Containers.

Visual Studio 2022 17.9 of hoger bevat standaard de nieuwste Aspire SDK wanneer u de web- en cloudworkload installeert.

Aspire Sjablonen

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 Aspire oplossingen te maken of afzonderlijke projecten toe te voegen aan bestaande Aspire-oplossingen.

Aspire De sjablonen installeren

Als u de 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. open Visual Studio.
  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 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.4.0

Aspire De sjablonen weergeven

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

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

Als u wilt controleren of de Aspire sjablonen zijn geïnstalleerd, gebruikt u de opdracht nieuwe lijst dotnet 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
---------------------------------  ----------------------  --------  -------------------------------------------------------
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

Zie Aspire sjablonen voor meer informatie.

containerruntime

Aspire kan containers uitvoeren met behulp van verschillende OCI-compatibele runtimes, waaronder Docker Desktop en Podman. Hoewel sommige gebruikers hebben gemeld dat het gebruik van Rancher Desktop is geslaagd, met name wanneer deze is geconfigureerd voor het gebruik van de Docker CLI, is dit geen officieel ondersteund of regelmatig getest scenario. Het is mogelijk om Rancher Desktop te gebruiken met de standaardinstallatie, maar het is geen officieel ondersteunde of gevalideerde benadering. Als u problemen ondervindt met Rancher Desktop, laat het ons dan weten, maar houd er rekening mee dat oplossingen mogelijk geen prioriteit krijgen.

  • Docker Desktop is de populairste containerruntime van Aspire ontwikkelaars, die een vertrouwde en breed ondersteunde omgeving biedt voor het bouwen en uitvoeren van containers.
  • Podman is een open source, daemonless alternatief voor Docker. Het biedt ondersteuning voor het bouwen en uitvoeren van OCI-containers (Open Container Initiative), waardoor het een flexibele keuze is voor ontwikkelaars die de voorkeur geven aan een lichtgewicht oplossing.

Als uw hostomgeving een Docker en Podman geïnstalleerd zijn, gebruikt Aspire standaard Docker. U kunt in plaats daarvan Aspire instrueren Podman te gebruiken door de omgevingsvariabele ASPIRE_CONTAINER_RUNTIME in te stellen op podman:

export ASPIRE_CONTAINER_RUNTIME=podman

Zie Podman installeren op Linuxvoor meer informatie.

Overwegingen voor WSL (Windows-subsysteem voor Linux)

Wanneer u met WSL werkt Podman , moet u ervoor zorgen dat het podman uitvoerbare bestand beschikbaar is in uw PATH en niet alleen is gedefinieerd als een shellalias. Aspire verwerkt containerruntimes door te zoeken naar het uitvoerbare bestand in het systeem-PAD en shell-aliassen worden tijdens dit proces niet herkend.

Bekende problemen en oplossingen:

  • Podman geïnstalleerd in een afzonderlijke WSL-distributie: als Podman deze is geïnstalleerd in een andere WSL-distributie dan uw Aspire toepassing, is de podman opdracht mogelijk niet beschikbaar in het PATH van uw huidige distributie.

    Oplossing: Installeer Podman rechtstreeks in de WSL-distributie waar u uw Aspire toepassing uitvoert of maak een symbolische koppeling naar het Podman uitvoerbare bestand in een map die zich in uw PATH bevindt (zoals /usr/local/bin).

  • Shell-aliassen gebruiken: als u een shellalias hebt, zoals alias podman='podman-remote-static-linux_amd64' in uw ~/.bash_aliases of vergelijkbaar bestand, Aspire kunt u de containerruntime niet vinden.

    Oplossing: Maak in plaats van een alias een symbolische koppeling of voeg de map met het Podman uitvoerbare bestand toe aan uw 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

Controleer uw installatie: U kunt controleren of Podman deze juist is geconfigureerd door het volgende uit te voeren:

which podman
podman --version

Beide opdrachten moeten slagen en geldige resultaten retourneren voordat uw Aspire toepassing wordt uitgevoerd.

Tip

Als u problemen ondervindt in Podman WSL-omgevingen, raadpleegt u Container Runtime 'podman' niet gevonden in WSL voor specifieke richtlijnen voor probleemoplossing.

Aspire dashboard

Aspire sjablonen die het AppHost-project beschikbaar maken, bevatten ook een nuttig ontwikkelaarsdashboard 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 Aspire dashboard is alleen zichtbaar terwijl de app actief is en wordt automatisch gestart wanneer je het *.AppHost-project start. Zowel Visual Studio als Visual Studio Code starten uw app en het 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 Projecten van het Aspire dashboard.

Het Aspire dashboard is ook beschikbaar in een zelfstandige modus. Zie Zelfstandig Aspire dashboard voor meer informatie.

Visual Studio-hulpprogramma's

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

Een integratiepakket toevoegen

U voegt 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 Aspire integraties toe te voegen.

  1. Visual StudioKlik met de rechtermuisknop op het project waaraan u een Aspire integratie wilt toevoegen en selecteer Pakket toevoegen>Aspire....

    Het contextmenu Visual Studio met de optie Aspire Component toevoegen.

  2. Het pakketbeheer wordt geopend met zoekresultaten die vooraf zijn geconfigureerd (filtercriteria vullen) voor 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 Aspire.

Zie Aspire voor meer informatie over Aspire integraties.

Hostingpakketten toevoegen

Aspire hostingpakketten worden gebruikt voor het configureren van verschillende resources en afhankelijkheden die een app mogelijk afhankelijk is van of verbruikt. 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. Gebruik Visual Studio de rechtermuisknop op de *.AppHost-project en kies Toevoegen>Aspire pakket....

    Het contextmenu Visual Studio met de optie Aspire Hostingresource toevoegen.

  2. Pakketbeheer wordt geopend met vooraf geconfigureerde zoekresultaten (vooraf ingevulde filtercriteria) voor 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 Aspire-bron weergeeft.

Orchestratieprojecten toevoegen

U kunt orkestratieprojecten toevoegen Aspire aan een bestaande app met behulp van de volgende stappen:

  1. Visual StudioSelecteer in een bestaand project met de rechtermuisknop en selecteer >Aspire..

    Het contextmenu Visual Studio met de optie Ondersteuning voor Orchestrator toevoegen 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 StudioAspire 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 AppHost.cs-bestand van het *.AppHost-project.

Voor meer informatie over Aspire orkestratie, zie Aspire orkestratieoverzicht.

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 die laat zien hoe u zich in orchestration kunt inschrijven Aspire.

Testproject maken

Wanneer u Visual Studio gebruikt en u de Aspire Start Toepassing-sjabloon selecteert, hebt u de mogelijkheid om een testproject toe te voegen. 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 Uw eerste Aspire test schrijven voor meer informatie.

Visual Studio Code-hulpprogramma's

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

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

Zodra u een nieuw 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 van het opsporen van fouten in een Aspire project in Visual Studio Code.

Aspire CLI

De Aspire CLI (aspire opdracht) is een platformoverschrijdend hulpprogramma dat opdrachtregelfunctionaliteit biedt voor het maken, beheren, uitvoeren en publiceren van polyglot-projecten Aspire . Gebruik de Aspire CLI om ontwikkelwerkstromen te stroomlijnen en services te coördineren voor gedistribueerde toepassingen.

Zie Aspire CLI-overzicht en CLI installeren Aspirevoor meer informatie.

Zie ook