Samouczek: dodawanie .NET Aspire do istniejącej aplikacji .NET

1. Uruchom Visual Studio, a następnie wybierz Plik>Otwórz>Projekt/Rozwiązanie.

2. Przejdź do folderu najwyższego poziomu sklonowanego rozwiązania, wybierz eShopLite.sln, a następnie wybierz Otwórz.

3. W eksploratorze rozwiązań kliknij prawym przyciskiem myszy rozwiązanie eShopLite, a następnie wybierz pozycję Konfiguruj projekty startowe.

4. Wybierz pozycję Wiele projektów startowych.

5. W kolumnie akcja wybierz pozycję Rozpocznij dla projektów Products i Store.

6. Wybierz pozycję OK.

7. Aby rozpocząć debugowanie rozwiązania, naciśnij F5 lub wybierz pozycję Rozpocznij.

8. Dwie strony są otwierane w przeglądarce:

   • Na stronie są wyświetlane produkty w formacie JSON z wywołania do API produktów.
   • Strona wyświetla stronę główną witryny internetowej. W menu po lewej stronie wybierz pozycję Products, aby wyświetlić wykaz uzyskany z internetowego interfejsu API.

9. Aby zatrzymać debugowanie, zamknij przeglądarkę.

1. Uruchom Visual Studio Code i otwórz sklonowany folder. W terminalu, w którym sklonujesz repozytorium, uruchom następujące polecenie:

   code .
   

2. Wybierz pozycję menu Uruchom i Debuguj lub naciśnij Ctrl+Shift+D.

3. Wybierz , aby utworzyć uruchamianie.json link do pliku.

   

4. Skopiuj i wklej następujący JSON do tego pliku, a następnie zapisz:

   • 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. Aby rozpocząć debugowanie rozwiązania, naciśnij F5 lub wybierz pozycję Rozpocznij.

6. Dwie strony są otwierane w przeglądarce:

   • Na stronie są wyświetlane produkty w formacie JSON z wywołania do API produktów.
   • Strona wyświetla stronę główną witryny internetowej. W menu po lewej stronie wybierz pozycję Products, aby wyświetlić wykaz uzyskany z internetowego interfejsu API.

7. Aby zatrzymać debugowanie, zamknij przeglądarkę, a następnie dwukrotnie wybierz przycisk Zatrzymaj (raz dla każdego uruchomionego wystąpienia debugowania).

1. Otwórz okno terminalu i zmień katalogi na nowo sklonowane repozytorium.

2. Aby uruchomić aplikację Products, uruchom następujące polecenie:

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

3. Zostanie otwarta strona przeglądarki, na której wyświetli się JSON dotyczące produktów.

4. W osobnym oknie terminalu ponownie zmień katalog na sklonowane repozytorium.

5. Uruchom aplikację Store, uruchamiając następujące polecenie:

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

6. Przeglądarka otwiera stronę wyświetlającą stronę główną witryny internetowej. W menu po lewej stronie wybierz pozycję Products, aby wyświetlić wykaz uzyskany z internetowego interfejsu API.

7. Aby zatrzymać debugowanie, zamknij przeglądarkę i naciśnij Ctrl+C w obu terminalach.

1. W w Eksploratorze rozwiązań kliknij prawym przyciskiem myszy projekt Store Store, wybierz pozycję Dodaj, a następnie wybierz pozycję Orchestrator Support.

2. W dialogu Dodaj .NETobsługę.NET Aspire Orchestratora wybierz pozycję OK.

   

Teraz powinny istnieć dwa nowe projekty, które zostały dodane do rozwiązania:

• eShopLite.AppHost: projekt orkiestratora zaprojektowany pod kątem łączenia i konfigurowania różnych projektów i usług aplikacji. Orkiestrator jest ustawiony jako projekt startowy i zależy od projektu eShopLite.Store.
• pl-PL: eShopLite.ServiceDefaults: wspólny projekt .NET.NET Aspire do zarządzania konfiguracjami używanymi ponownie w projektach w ramach rozwiązania, związanymi z odpornością , wykrywaniem usług i telemetrią .

W projekcie eShopLite.AppHost otwórz plik . Zwróć uwagę na ten wiersz kodu, który rejestruje projekt Store w orkiestracji .NET.NET Aspire:

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

Aby uzyskać więcej informacji, zobacz AddProject.

Aby dodać projekt Products do .NET.NET Aspire:

1. W Visual Studio, w Eksploratorze rozwiązań , kliknij prawym przyciskiem myszy projekt Products, wybierz pozycję Dodaj, a następnie wybierz pozycję .NET.NET Aspire Orchestrator Support.

2. Komunikat wskazujący, że projekt .NET.NET Aspire Orchestrator już istnieje, wybierz OK.

   

W projekcie eShopLite.AppHost otwórz plik . Zwróć uwagę na ten wiersz kodu, który rejestruje projekt Products w aranżacji .NET.NET Aspire:

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

Zwróć również uwagę, że projekt eShopLite.AppHost zależy teraz zarówno od projektów Store, jak i Products.

Tworzenie projektu hosta aplikacji

Aby zorganizować istniejące projekty, należy utworzyć nowy projekt host aplikacji. Aby utworzyć nowy projekt hosta aplikacji z dostępnych szablonów .NET Aspire, użyj następującej komendy CLI .NET:

dotnet new aspire-apphost -o eShopLite.AppHost

Dodaj projekt hosta aplikacji do istniejącego rozwiązania:

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

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

Dodaj projekt Store jako odwołanie do projektu hosta aplikacji przy użyciu następującego polecenia interfejsu wiersza polecenia :

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

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

Tworzenie projektu domyślnego usługi

Po utworzeniu projektu hosta aplikacji, należy utworzyć nowy projekt domyślnych usług . Aby utworzyć nowe ustawienia domyślne usługi projektu z dostępnych szablonów .NET Aspire, użyj następującego polecenia interfejsu wiersza polecenia .NET:

dotnet new aspire-servicedefaults -o eShopLite.ServiceDefaults

Aby dodać projekt do rozwiązania, użyj następującego polecenia CLI .NET:

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

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

Zaktualizuj projekt hosta aplikacji , aby dodać odwołanie do projektu Products:

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

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

Zarówno projekty Store, jak i Products, muszą odwoływać się do projektu domyślnych ustawień usługi , aby można było łatwo uwzględnić odkrywanie usług. Aby dodać odwołanie do domyślnych ustawień usługi projektu Store, użyj następującego polecenia interfejsu wiersza polecenia .NET:

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

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

To samo polecenie, używane z nieco różnymi ścieżkami, powinno zostać użyte, aby dodać odwołanie do domyślnych ustawień usługi w projekcie w projekcie Products.

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

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

W projektach Store i Products zaktualizuj pliki Program.cs, dodając następujący wiersz bezpośrednio po wierszu var builder = WebApplication.CreateBuilder(args);:

builder.AddServiceDefaults();

Aktualizowanie projektu hosta aplikacji

Otwórz plik Program.cs hosta aplikacji i zastąp jego zawartość następującym kodem c#:

var builder = DistributedApplication.CreateBuilder(args);

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

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

builder.Build().Run();

Powyższy kod:

• Tworzy nową instancję DistributedApplicationBuilder.
• Dodaje projekt Store do orkiestratora.
• Dodaje do orkiestratora projekt Products.
• Buduje i uruchamia orkiestratora.

1. W Visual Studio, aby rozpocząć debugowanie, naciśnij F5, aVisual Studio buduje projekty.
2. Jeśli zostanie wyświetlone okno dialogowe Start Docker Desktop, wybierz Tak. Visual Studio uruchamia aparat Docker i tworzy niezbędne kontenery. Po zakończeniu wdrażania zostanie wyświetlony pulpit nawigacyjny .NET.NET Aspire.
3. Na pulpicie wybierz punkt końcowy projektu dla produktów . Zostanie wyświetlona nowa karta przeglądarki i zostanie wyświetlony katalog produktów w formacie JSON.
4. Na pulpicie nawigacyjnym wybierz punkt końcowy dla projektu store. Zostanie wyświetlona nowa karta przeglądarki i zostanie wyświetlona strona główna aplikacji internetowej.
5. W menu po lewej stronie wybierz pozycję Products. Zostanie wyświetlony katalog produktów.
6. Aby zatrzymać debugowanie, zamknij przeglądarkę.

Usuń wykonanie . Plikjson, który utworzyłeś wcześniej, nie ma już żadnego zastosowania. Zamiast tego uruchom projekt host aplikacji , który organizuje inne projekty:

1. Uruchom projekt hosta aplikacji, klikając prawym przyciskiem myszy projekt eShopLite.AppHost w Eksploratorze rozwiązań i wybierając Debug>Uruchom nowe wystąpienie:

   

   Notatka

   Jeśli program Docker Desktop (lub Podman) nie jest uruchomiony, wystąpi błąd. Uruchom silnik kontenera zgodny ze standardem OCI i spróbuj ponownie.

1. Uruchom projekt hosta aplikacji , uruchamiając następujące polecenie:

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

   Notatka

   Jeśli program Docker Desktop (lub Podman) nie jest uruchomiony, wystąpi błąd. Uruchom silnik kontenera zgodny ze standardem OCI i spróbuj ponownie.

2. Na pulpicie wybierz punkt końcowy projektu dla produktów . Zostanie wyświetlona nowa karta przeglądarki i zostanie wyświetlony katalog produktów w formacie JSON.
3. Na pulpicie nawigacyjnym wybierz punkt końcowy dla projektu store. Zostanie wyświetlona nowa karta przeglądarki i zostanie wyświetlona strona główna aplikacji internetowej.
4. W menu po lewej stronie wybierz pozycję Products. Zostanie wyświetlony katalog produktów.
5. Aby zatrzymać debugowanie, zamknij przeglądarkę.