Oktatóanyag: .NET Aspire hozzáadása meglévő .NET-alkalmazáshoz

1. Indítsa el Visual Studio, majd válassza Fájl>>Projekt/megoldás megnyitása.

2. Keresse meg a klónozott megoldás legfelső szintű mappáját, válassza a eShopLite.sln, majd a Megnyitáslehetőséget.

3. A Megoldáskezelőkattintson a jobb gombbal az eShopLite megoldásra, majd válassza az Indítási projektek konfigurálásalehetőséget.

4. Válassza Több indítási projektlehetőséget.

5. A Művelet oszlopban válassza a Indítás lehetőséget mind a Termékek, mind az Áruház projektekhez.

6. Válassza OKlehetőséget.

7. A megoldás hibakereséséhez nyomja le F5 vagy válassza a Startlehetőséget.

8. Két oldal nyílik meg a böngészőben:

   • Egy oldal JSON formátumban jeleníti meg a termékeket egy hívás eredményeként a Termékek Web API-ból.
   • Egy oldal megjeleníti a webhely kezdőlapját. A bal oldali menüben válassza a Termékek lehetőséget a Webes API-ból beszerzett katalógus megtekintéséhez.

9. A hibakeresés leállításához zárja be a böngészőt.

1. Indítsa el Visual Studio Code, és nyissa meg a klónozott mappát. A terminálon, ahol klónozta az adattárat, futtassa a következő parancsot:

   code .
   

2. Válassza a Futtatás és hibakeresés menüelemet, vagy nyomja le Ctrl+Shift+Dbillentyűkombinációt.

3. Válassza ki a hozzon létre egy launch.json fájlt hivatkozást.

   

4. Másolja és illessze be a következőt ebbe a fájlba: JSON, majd mentse el.

   • 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. A megoldás hibakereséséhez nyomja le F5 vagy válassza a Startlehetőséget.

6. Két oldal nyílik meg a böngészőben:

   • Egy oldal JSON formátumban jeleníti meg a termékeket egy hívás eredményeként a Termékek Web API-ból.
   • Egy oldal megjeleníti a webhely kezdőlapját. A bal oldali menüben válassza a Termékek lehetőséget a Webes API-ból beszerzett katalógus megtekintéséhez.

7. A hibakeresés leállításához zárja be a böngészőt, majd válassza a leállítása gombot kétszer (minden futó hibakeresési példány esetében egyszer).

1. Nyisson meg egy terminálablakot, és módosítsa a könyvtárakat az újonnan klónozott adattárba.

2. A Termékek alkalmazás elindításához futtassa a következő parancsot:

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

3. Megnyílik egy böngészőlap, amely a termékek JSON értékét jeleníti meg.

4. Egy külön terminálablakban módosítsa ismét a könyvtárakat klónozott adattárra.

5. Indítsa el a Store alkalmazást az alábbi parancs futtatásával:

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

6. A böngésző megnyit egy lapot, amely megjeleníti a webhely kezdőlapját. A bal oldali menüben válassza a Termékek lehetőséget a Webes API-ból beszerzett katalógus megtekintéséhez.

7. A hibakeresés leállításához zárja be a böngészőt, és nyomja le a Ctrl+C mindkét terminálon.

1. A Visual StudioMegoldáskezelő területén kattintson jobb gombbal a Store projektre, válassza a Hozzáadás, majd a .NET.NET Aspire Vezénylő Támogatás lehetőséget.

2. Az Add .NET.NET Aspire Orchestrator támogatási párbeszédpanelben kattintson az OKgombra.

   

Most két új projektnek kell lennie, mindkettőt hozzá kell adni a megoldáshoz:

• eShopLite.AppHost: Az alkalmazás különböző projektjeinek és szolgáltatásainak összekapcsolására és konfigurálására tervezett vezénylőprojekt. Az orchestrator van beállítva Kezdő projektként, és függ a eShopLite.Store projekttől.
• eShopLite.ServiceDefaults: Egy .NET.NET Aspire megosztott projekt, amely kezeli a projektekben újrahasznosított konfigurációkat az ön megoldásában, a rugalmasság, szolgáltatásfelderítés és telemetria terén.

Az eShopLite.AppHost projektben nyissa meg a Program.cs fájlt. Figyelje meg ezt a kódsort, amely regisztrálja a Store projektet a .NET.NET Aspire vezénylésben:

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

További információ: AddProject.

Add hozzá a Termékek projektet a .NET.NET Aspire-hoz/-hez/-höz:

1. A Visual StudioMegoldáskezelőterületén kattintson a jobb gombbal a Termékek projektre, válassza a hozzáadása, majd a .NET.NET Aspire Orchestrator támogatásilehetőséget.

2. Egy párbeszédpanel, amely jelzi, hogy .NET.NET Aspire Orchestrator-projekt már létezik, válassza az OK, lehetőséget.

   

Az eShopLite.AppHost projektben nyissa meg a Program.cs fájlt. Figyelje meg ezt a kódsort, amely regisztrálja a Termékek projektet a .NET.NET Aspire koordinációban:

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

Azt is megfigyelheti, hogy az eShopLite.AppHost projekt mostantól a Store és Termékek projektektől is függ.

Alkalmazásgazdaprojekt létrehozása

A meglévő projektek vezényléséhez létre kell hoznia egy új alkalmazásgazda projektet. Ha új alkalmazásgazda projektet szeretne létrehozni az elérhető .NET Aspire sablonokból, használja a következő .NET CLI-parancsot:

dotnet new aspire-apphost -o eShopLite.AppHost

Adja hozzá a alkalmazásgazda projektet a meglévő megoldáshoz:

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

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

Adja hozzá a Store projektet projekthivatkozásként az alkalmazásgazda projekthez az alábbi .NET PARANCSSOR-paranccsal:

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

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

Alapértelmezett szolgáltatásprojekt létrehozása

Az alkalmazásgazdaprojekt létrehozása után létre kell hoznia egy új szolgáltatás alapértelmezett projektet. Új szolgáltatás alapértelmezési projekt létrehozásához az elérhető .NET Aspire sablonokból használja a következő .NET CLI parancsot:

dotnet new aspire-servicedefaults -o eShopLite.ServiceDefaults

A projekt megoldáshoz való hozzáadásához használja a következő .NET parancssori felület parancsot:

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

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

Frissítse a alkalmazásgazda projektet, hogy projekthivatkozást adjon hozzá a Termékek projekthez:

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

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

A Store és a Termékek projekt projekteknek is hivatkozniuk kell a szolgáltatás alapértelmezettjeinek projektjére, hogy könnyen belefoglalhassák a szolgáltatás felfedezését. Ha az szolgáltatás alapértelmezett-projektre szeretne hivatkozni a Store projektben, használja a következő .NET parancssori felület parancsot:

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

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

A Termékek projektben az alapértelmezett szolgáltatásra mutató hivatkozás hozzáadásához ugyanazt a parancsot kell használni, amely kissé eltérő elérési utakat tartalmaz:

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

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

A Store és Termékek projektekben frissítse a Program.cs fájlokat, és közvetlenül a var builder = WebApplication.CreateBuilder(args); sor után adja hozzá a következő sort:

builder.AddServiceDefaults();

Az alkalmazásgazdaprojekt frissítése

Nyissa meg a Program.cs projekt fájlját, és cserélje le a tartalmát a következő C#-kódra:

var builder = DistributedApplication.CreateBuilder(args);

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

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

builder.Build().Run();

Az előző kód:

• Létrehoz egy új DistributedApplicationBuilder-példányt.
• Hozzáadja a Store projektet az orchestratorhoz.
• Hozzáadja a Termékek projektet az orchestrátorhoz.
• Létrehozza és futtatja az orchestrátort.

1. A Visual Studiohibakeresés indításához és a projektek építéséhez nyomja le az F5Visual Studio billentyűt.
2. Ha megjelenik az Indítás Docker Asztal párbeszédpanel, válassza Igenlehetőséget. Visual Studio elindítja a Docker motort, és létrehozza a szükséges tárolókat. Amikor az üzembe helyezés befejeződött, megjelenik a .NET.NET Aspire irányítópult.
3. Az irányítópulton válassza ki a projekt számára a típusú termékek végpontját. Megjelenik egy új böngészőlap, amely JSON formátumban jeleníti meg a termékkatalógust.
4. Az irányítópulton válassza ki a tároló projekt végpontját. Megjelenik egy új böngészőlap, amely megjeleníti a webalkalmazás kezdőlapját.
5. A bal oldali menüben válassza a Termékeklehetőséget. Megjelenik a termékkatalógus.
6. A hibakeresés leállításához zárja be a böngészőt.

Törölje a korábban létrehozott launch.json fájlt, az már nem szolgál célként. Ehelyett indítsa el a alkalmazásgazda projektet, amely a többi projektet vezényli:

1. Indítsa el a app host projektet jobb kattintással az eShopLite.AppHost projekten a Megoldáskezelőben, és válassza a Hibakeresés>Új példány indítása:

   

   Jegyzet

   Ha Docker Desktop (vagy Podman) nem fut, hibaüzenet jelenik meg. Indítsa el az OCI-kompatibilis tárolómotort, és próbálkozzon újra.

1. Indítsa el a alkalmazásgazda projektet az alábbi parancs futtatásával:

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

   Jegyzet

   Ha Docker Desktop (vagy Podman) nem fut, hibaüzenet jelenik meg. Indítsa el az OCI-kompatibilis tárolómotort, és próbálkozzon újra.

2. Az irányítópulton válassza ki a projekt számára a típusú termékek végpontját. Megjelenik egy új böngészőlap, amely JSON formátumban jeleníti meg a termékkatalógust.
3. Az irányítópulton válassza ki a tároló projekt végpontját. Megjelenik egy új böngészőlap, amely megjeleníti a webalkalmazás kezdőlapját.
4. A bal oldali menüben válassza a Termékeklehetőséget. Megjelenik a termékkatalógus.
5. A hibakeresés leállításához zárja be a böngészőt.