Tutorial: Hinzufügen von .NET Aspire zu einer vorhandenen .NET-App

1. Starten Sie Visual Studio und wählen Sie dann Datei>Öffnen>Projekt/Lösung aus.

2. Navigieren Sie zum Ordner der obersten Ordnerebene der Lösung, die Sie geklont haben, wählen Sie eShopLite.slnaus, und wählen Sie dann Öffnenaus.

3. Klicken Sie im Lösungs-Explorermit der rechten Maustaste auf die eShopLite Lösung, und wählen Sie dann Startprojekte konfigurierenaus.

4. Wählen Sie mehrere Startprojekteaus.

5. Wählen Sie in der Spalte Aktion für beide Produkte und Store Projekte Start aus.

6. Wählen Sie OKaus.

7. Um mit dem Debuggen der Lösung zu beginnen, drücken Sie F5-, oder wählen Sie Start-aus.

8. Zwei Seiten werden im Browser geöffnet:

   • Auf einer Seite werden Produkte im JSON-Format durch einen Aufruf der Products-Web-API angezeigt.
   • Auf einer Seite wird die Homepage der Website angezeigt. Wählen Sie im Menü auf der linken Seite Produkte aus, um den Katalog anzuzeigen, der über die Web-API bezogen wurde.

9. Um das Debuggen zu beenden, schließen Sie den Browser.

1. Starten Sie Visual Studio Code, und öffnen Sie den Ordner, den Sie geklont haben. Führen Sie vom Terminal aus, in dem Sie das Repository geklont haben, den folgenden Befehl aus:

   code .
   

2. Wählen Sie das Menüelement Ausführen und Debuggen aus, oder drücken Sie Strg+Shift+D.

3. Wählen Sie den Link create a launch.json file aus.

   

4. Kopieren Sie den folgenden JSON in diese Datei und speichern Sie.

   • Unix
   • Windows

   {
       "version": "0.2.0",
       "compounds": [
           {
               "name": "Run all",
               "configurations": [
                   "Run products",
                   "Run store",
               ]
           }
       ],
       "configurations": [
           {
               "name": "Run products",
               "type": "dotnet",
               "request": "launch",
               "projectPath": "${workspaceFolder}/Products/Products.csproj"
           },
           {
               "name": "Run store",
               "type": "dotnet",
               "request": "launch",
               "projectPath": "${workspaceFolder}/Store/Store.csproj"
           }
       ]
   }
   

5. Um mit dem Debuggen der Lösung zu beginnen, drücken Sie F5-, oder wählen Sie Start-aus.

6. Zwei Seiten werden im Browser geöffnet:

   • Auf einer Seite werden Produkte im JSON-Format aus einem Aufruf der Products-Web-API angezeigt.
   • Auf einer Seite wird die Homepage der Website angezeigt. Wählen Sie im Menü auf der linken Seite Produkte aus, um den Katalog anzuzeigen, der über die Web-API bezogen wurde.

7. Um das Debuggen zu beenden, schließen Sie den Browser, und wählen Sie dann zweimal die Schaltfläche beenden aus (einmal für jede ausgeführte Debuginstanz).

1. Öffnen Sie ein Terminalfenster, und ändern Sie Verzeichnisse in das neu geklonte Repository.

2. Führen Sie den folgenden Befehl aus, um die Products-App zu starten:

   dotnet run --project ./Products/Products.csproj
   

3. Eine Browserseite wird geöffnet, die die JSON für die Produkte anzeigt.

4. Wechseln Sie in einem separaten Terminalfenster erneut in das Verzeichnis des geklonten Repositories.

5. Starten Sie die Store App, indem Sie den folgenden Befehl ausführen:

   dotnet run --project ./Store/Store.csproj
   

6. Der Browser öffnet eine Seite, auf der die Homepage der Website angezeigt wird. Wählen Sie im Menü auf der linken Seite Produkte aus, um den Katalog anzuzeigen, der über die Web-API bezogen wurde.

7. Um das Debuggen zu beenden, schließen Sie den Browser, und drücken Sie STRG+C- in beiden Terminals.

1. Klicken Sie in Visual Studioim Projekt-Explorermit der rechten Maustaste auf das Store--Projekt, wählen Sie Hinzufügenaus, und wählen Sie dann .NET.NET Aspire Orchestrator-Supportaus.

2. Wählen Sie im Dialogfeld Hinzufügen .NET.NET Aspire OrchestratorunterstützungOKaus.

   

Sie sollten jetzt zwei neue Projekte haben, die der Lösung hinzugefügt wurden.

• eShopLite.AppHost-: Ein Orchestratorprojekt, das entwickelt wurde, um die verschiedenen Projekte und Dienste Ihrer App zu verbinden und zu konfigurieren. Der Orchestrator wird als Startprojektfestgelegt und hängt vom Projekt eShopLite.Store ab.
• eShopLite.ServiceDefaults-: Ein .NET.NET Aspire gemeinsam genutztes Projekt zum Verwalten von Konfigurationen, die in den Projekten Ihrer Lösung im Zusammenhang mit Resilienz, Dienstermittlungund Telemetriewiederverwendet werden.

Öffnen Sie die Datei im Projekt Program.cs. Beachten Sie diese Codezeile, die das Store--Projekt im .NET.NET Aspire-Orchestrierungsschema registriert.

builder.AddProject<Projects.Store>("store");

Weitere Informationen finden Sie unter AddProject.

So fügen Sie das projekt Products zu .NET.NET Aspirehinzu:

1. Klicken Sie in Visual Studioim Lösungs-Explorermit der rechten Maustaste auf das Projekt Produkte, wählen Sie Hinzufügenaus, und wählen Sie dann .NET.NET Aspire Orchestrator-Supportaus.

2. Ein Dialogfeld zeigt an, dass das Orchestrator-Projekt .NET.NET Aspire bereits vorhanden ist. Wählen Sie OKaus.

   

Öffnen Sie die Datei im Projekt Program.cs. Beachten Sie diese Codezeile, die das Projekt Products im Orchestrierungsschema .NET.NET Aspire registriert.

builder.AddProject<Projects.Products>("products");

Beachten Sie außerdem, dass das eShopLite.AppHost--Projekt jetzt sowohl von den Store-- als auch von den Products--Projekten abhängt.

Erstellen eines App-Hostprojekts

Um die vorhandenen Projekte zu koordinieren, müssen Sie ein neues -App-Host--Projekt erstellen. Um ein neues App-Host-Projekt aus den verfügbaren .NET Aspire Vorlagen zu erstellen, verwenden Sie den folgenden .NET CLI-Befehl:

dotnet new aspire-apphost -o eShopLite.AppHost

Fügen Sie das App-Host Projekt zur vorhandenen Lösung hinzu:

dotnet sln ./eShopLite.sln add ./eShopLite.AppHost/eShopLite.AppHost.csproj

dotnet sln .\eShopLite.sln add .\eShopLite.AppHost\eShopLite.AppHost.csproj

Fügen Sie das Store- Projekt als Projektverweis zum App-Host Projekt hinzu, indem Sie den folgenden befehl .NET CLI verwenden:

dotnet add ./eShopLite.AppHost/eShopLite.AppHost.csproj reference ./Store/Store.csproj

dotnet add .\eShopLite.AppHost\eShopLite.AppHost.csproj reference .\Store\Store.csproj

Erstellen eines Service-Standardeinstellungsprojekts

Nachdem das App-Hostprojekt erstellt wurde, müssen Sie ein neues Dienststandards Projekt erstellen. Verwenden Sie den folgenden CLI-Befehl, um ein neues Standarddienstprojekt aus den verfügbaren .NET Aspire Vorlagen zu erstellen:

dotnet new aspire-servicedefaults -o eShopLite.ServiceDefaults

Um das Projekt zur Lösung hinzuzufügen, verwenden Sie den folgenden .NET CLI-Befehl:

dotnet sln ./eShopLite.sln add ./eShopLite.ServiceDefaults/eShopLite.ServiceDefaults.csproj

dotnet sln .\eShopLite.sln add .\eShopLite.ServiceDefaults\eShopLite.ServiceDefaults.csproj

Aktualisieren Sie das App-Host-Projekt, um einen Projektverweis zum Products-Projekt hinzuzufügen.

dotnet add ./eShopLite.AppHost/eShopLite.AppHost.csproj reference ./Products/Products.csproj

dotnet add .\eShopLite.AppHost\eShopLite.AppHost.csproj reference .\Products\Products.csproj

Sowohl die Store- als auch die Produkte-Projekte müssen auf das Servicestandards-Projekt verweisen, damit sie problemlos Diensterkennung einschließen können. Verwenden Sie zum Hinzufügen eines Verweises auf das -Dienststandardprojekt im Store-Projekt den folgenden .NET CLI-Befehl:

dotnet add ./Store/Store.csproj reference ./eShopLite.ServiceDefaults/eShopLite.ServiceDefaults.csproj

dotnet add .\Store\Store.csproj reference .\eShopLite.ServiceDefaults\eShopLite.ServiceDefaults.csproj

Derselbe Befehl mit leicht unterschiedlichen Pfaden sollte verwendet werden, um einen Verweis auf das Projekt Dienststandards im Projekt Products hinzuzufügen.

dotnet add ./Products/Products.csproj reference ./eShopLite.ServiceDefaults/eShopLite.ServiceDefaults.csproj

dotnet add .\Products\Products.csproj reference .\eShopLite.ServiceDefaults\eShopLite.ServiceDefaults.csproj

Aktualisieren Sie in den Store und Produkte Projekten ihre Program.cs Dateien und fügen Sie die folgende Zeile unmittelbar nach der var builder = WebApplication.CreateBuilder(args); Zeile hinzu:

builder.AddServiceDefaults();

Aktualisieren des App-Hostprojekts

Öffnen Sie die Datei Program.cs des App-Hosts des -Projekts, und ersetzen Sie deren Inhalt durch den folgenden C#-Code:

var builder = DistributedApplication.CreateBuilder(args);

builder.AddProject<Projects.Store>("store");

builder.AddProject<Projects.Products>("products");

builder.Build().Run();

Der vorangehende Code:

• Erstellt eine neue DistributedApplicationBuilder Instanz.
• Fügt das Store- Projekt dem Orchestrator hinzu.
• Fügt das Projekt Products dem Orchestrator hinzu.
• Erstellt und führt den Orchestrator aus.

1. Um das Debuggen in Visual Studiozu starten, drücken Sie F5, undVisual Studio erstellt die Projekte.
2. Wenn das Start-Docker-Desktop--Dialogfeld angezeigt wird, wählen Sie Jaaus. Visual Studio startet den Docker-Motor und erstellt die notwendigen Container. Nach Abschluss der Bereitstellung wird das .NET.NET Aspire Dashboard angezeigt.
3. Wählen Sie im Dashboard den Endpunkt für die Produkte Projekt aus. Eine neue Browserregisterkarte wird angezeigt und zeigt den Produktkatalog im JSON-Format an.
4. Wählen Sie im Dashboard den Endpunkt für das Store-Projekt aus. Eine neue Browserregisterkarte wird geöffnet, um die Startseite der Webanwendung anzuzeigen.
5. Wählen Sie im Menü auf der linken Seite Produkteaus. Der Produktkatalog wird angezeigt.
6. Um das Debuggen zu beenden, schließen Sie den Browser.

Löschen Sie die zuvor erstellte launch.json Datei, sie dient nicht mehr einem Zweck. Starten Sie stattdessen das App-Host Projekt, das die anderen Projekte orchestriert:

1. Starten Sie das App-Host--Projekt, indem Sie mit der rechten Maustaste auf das eShopLite.AppHost--Projekt im Projektmappen-Explorer klicken und Debug>Neue Instanz startenauswählen.

   

   Anmerkung

   Wenn Docker Desktop (oder Podman) nicht ausgeführt wird, erhalten Sie eine Fehlermeldung. Starten Sie die OCI-kompatible Container-Engine, und versuchen Sie es erneut.

1. Starten Sie das App-Host-Projekt, indem Sie den folgenden Befehl ausführen:

   dotnet run --project ./eShopLite.AppHost/eShopLite.AppHost.csproj
   

   Anmerkung

   Wenn Docker Desktop (oder Podman) nicht läuft, kommt es zu einem Fehler. Starten Sie die OCI-kompatible Container-Engine, und versuchen Sie es erneut.

2. Wählen Sie im Dashboard den Endpunkt für die Produkte Projekt aus. Eine neue Registerkarte im Browser wird geöffnet und zeigt den Produktkatalog im JSON-Format an.
3. Wählen Sie im Dashboard den Endpunkt für das Store-Projekt aus. Eine neue Browserregisterkarte wird geöffnet und zeigt die Startseite der Webanwendung an.
4. Wählen Sie im Menü auf der linken Seite Produkteaus. Der Produktkatalog wird angezeigt.
5. Um das Debuggen zu beenden, schließen Sie den Browser.