.NET .NET Aspire beállítás és eszközhasználat

Fejlesztési környezet kiválasztása

Visual Studio Visual Studio Code .NET CLI

.NET .NET Aspire olyan eszközöket tartalmaz, amelyekkel natív felhőbeli alkalmazásokat hozhat létre és konfigurálhat. Az eszközkészlet hasznos kezdőprojekt-sablonokat és egyéb funkciókat tartalmaz, amelyekkel egyszerűbbé teheti a .NET Aspire használatát Visual Studio, Visual Studio Codeés parancssori felületi munkafolyamatokhoz. Az alábbi szakaszokban megtanulhatja, hogyan dolgozhat .NET.NET Aspire eszközkészlettel, és megismerheti a következő feladatokat:

• .NET .NET Aspire és függőségeinek telepítése
• Kezdő projektsablonok létrehozása Visual Studio, Visual Studio Codevagy a .NET parancssori felület használatával
• .NET .NET Aspire integrációk telepítése
• Az .NET.NET Aspire irányítópultjának kezelése

.NET .NET Aspire telepítése

A .NET.NET Aspirehasználatához a következő helyi telepítésre van szükség:

• .NET 8.0 vagy .NET 9.0.
• OCI-kompatibilis tároló futtatási környezet, mint például:
  • Docker Asztali vagy Podman. További információ: Container Runtime.
• Integrált fejlesztői környezet (IDE) vagy kódszerkesztő, például:
  • Visual Studio 2022 17.9-es vagy újabb verziója (nem kötelező)
  • Visual Studio Code (nem kötelező)
    • C# Dev Kit: Bővítmény (nem kötelező)
  • JetBrains Rider .NET.NET Aspire beépülő modullal (nem kötelező)

Visual Studio 2022 17.9 vagy újabb verzió alapértelmezés szerint tartalmazza a legújabb .NET.NET Aspire SDK-t, amikor a Web & Cloud workloadot telepítik. Ha a 2022-es Visual Studio korábbi verziójával rendelkezik, frissíthet a Visual Studio 2022 17.9-es verzióra, vagy telepítheti a .NET Aspire SDK-t az alábbi lépésekkel:

A .NET Aspire számítási feladat 2022.Visual Studio-ben való telepítéséhez használja a Visual Studio telepítőt.

1. Nyissa meg a Visual Studio telepítőt.

2. Válassza a 2022- melletti Visual Studio módosítása lehetőséget.

3. Válassza a ASP.NET és a webfejlesztési feladatot.

4. A Telepítés részletei panelen válassza .NET.NET Aspire SDKlehetőséget.

5. Válassza módosítása lehetőséget a .NET.NET Aspire integrációjának telepítéséhez.

   

Konténer futtatókörnyezete

.NET .NET Aspire projektek tárolókban való futtatásra vannak tervezve. Tároló futtatási környezetként használhatja a Docker Desktopot vagy a Podman-et. Docker asztali környezet a leggyakoribb konténer futási környezet. Podman a Dockernyílt forráskódú démon nélküli alternatíva, amely open container initiative (OCI) tárolókat hozhat létre és futtathat. Ha a gazdakörnyezetben telepítve van mind a Docker, mind a Podman, akkor .NET Aspire alapértelmezés szerint a Docker-t használja. Utasíthatja a .NET Aspire-t, hogy a Podman-et használja, ha a DOTNET_ASPIRE_CONTAINER_RUNTIME környezeti változót podman-ra állítja.

Linux

Bash

export DOTNET_ASPIRE_CONTAINER_RUNTIME=podman

További információért lásd: Podman telepítése Linux.

Windows

PowerShell

[System.Environment]::SetEnvironmentVariable("DOTNET_ASPIRE_CONTAINER_RUNTIME", "podman", "User")

További információért lásd: a Podman telepítése a Windows.

.NET .NET Aspire sablonok

.NET .NET Aspire megoldás- és projektsablonokat biztosít. Ezek a sablonok a kedvenc .NET fejlesztői integrált környezetben érhetők el. Ezekkel a sablonokkal teljes .NET Aspire megoldásokat hozhat létre, vagy egyéni projekteket adhat hozzá a meglévő .NET Aspire megoldásokhoz. További információ: .NET.NET Aspire sablonok.

.NET .NET Aspire irányítópult

.NET .NET Aspire alkalmazás gazdagépének projektjét elérhetővé tevő sablonok olyan hasznos fejlesztői irányítópultot is tartalmaznak,, amely az alkalmazás különböző aspektusainak, például naplóknak, nyomkövetéseknek és környezeti konfigurációknak a figyelésére és vizsgálatára szolgál. Ez az irányítópult a helyi fejlesztési élmény javítása érdekében készült, és áttekintést nyújt az alkalmazás általános állapotáról és szerkezetéről.

A .NET.NET Aspire irányítópult csak akkor látható, amikor az alkalmazás fut, és automatikusan elindul, amikor a *.AppHost projektet elindítja. Visual Studio és Visual Studio Code automatikusan elindítja az alkalmazást és a .NET Aspire irányítópultot a böngészőben. Ha az alkalmazást a .NET parancssori felülettel indítja el, másolja és illessze be az irányítópult URL-címét a kimenetből a böngészőbe, vagy tartsa lenyomva Ctrl, és jelölje ki a hivatkozást (ha a terminál támogatja a hivatkozásokat).

A bal oldali navigációs sáv az irányítópult különböző részeire mutató hivatkozásokat tartalmaz, amelyeket az alábbi szakaszokban ismerhet meg.

A .NET.NET Aspire irányítópult önálló módban is elérhető. További információért tekintse meg a különálló .NET.NET Aspire irányítópult-at.

Visual Studio szerszámozás

Visual Studio további funkciókat biztosít .NET Aspire integrációk és az App Host vezénylő projektjének használatához. Jelenleg nem minden funkció érhető el a Visual Studio Code vagy a parancssori felületen keresztül.

Integrációs csomag hozzáadása

A .NET Aspirehasználatával, mint bármely más NuGet-csomagot, a Visual Studio integrációkat adhatja hozzá az alkalmazásába. A Visual Studio azonban felhasználói felületi lehetőségeket is biztosít .NET Aspire integrációk közvetlen hozzáadásához.

1. Kattintson jobb gombbal a Visual Studioprojektre, amelyhez egy .NET Aspire integrációt szeretne hozzáadni, majd válassza a >.NET.NET Aspire csomag hozzáadása....

   

2. A csomagkezelő a keresési eredményeket előre beállítva (a szűrők feltöltésével) nyitja meg a .NET.NET Aspire integrációkhoz, így egyszerűen böngészhet és kiválaszthatja a szükséges integrációt.

   

Az .NET.NET Aspire integrációkkal kapcsolatos további információkért lásd .NET.NET Aspire integrációk áttekintését.

Üzemeltetési csomagok hozzáadása

.NET .NET Aspire üzemeltetési csomagok különböző erőforrások és függőségek konfigurálására szolgálnak, amelyektől az alkalmazás függhet vagy felhasználhat. A tárhelycsomagok abban különböznek a többi integrációs csomagtól, hogy hozzáadják őket a *- hoz. AppHost projekt. Ha üzemeltetési csomagot szeretne hozzáadni az alkalmazáshoz, kövesse az alábbi lépéseket:

1. A Visual Studioterületen válassza a jobb gombbal a *. Az AppHost projektet, és válassza >.NET.NET Aspire csomag hozzáadása...lehetőséget.

   

2. Megnyílik a csomagkezelő a keresési eredmények előre konfigurálásával (a szűrőfeltételek feltöltésével) .NET.NET Aspire üzemeltetési csomagokhoz, így egyszerűen tallózhat és kiválaszthatja a kívánt csomagot.

   

Vezénylési projektek hozzáadása

.NET .NET Aspire vezénylési projekteket a következő lépésekkel adhat hozzá egy meglévő alkalmazáshoz:

1. Kattintson jobb gombbal a Visual Studioegy meglévő projektre, és válassza az >.NET.NET Aspire Orchestrator-támogatás hozzáadása lehetőséget..

   

2. Egy párbeszédpanel nyílik meg az *.AppHost és az *.ServiceDefaults projektek összegzésével, amelyeket hozzáadtak a megoldásához.

   

3. Válassza OK lehetőséget, és alkalmazza a következő módosításokat:

   • A *.AppHost és a *.ServiceDefaults vezénylési projektek hozzáadódnak a megoldáshoz.
   • A builder.AddServiceDefaults hívása hozzáadódik az eredeti projekt Program.cs fájljához.
   • Az eredeti projektre mutató hivatkozás hozzáadódik a *Program.cs fájljához. AppHost projekt.

Az .NET.NET Aspire orkesztációról további információért nézze meg a .NET.NET Aspire orkesztáció áttekintése.

Csatlakozás a szervezéshez

Visual Studio lehetővé teszi, hogy Aspire vezénylési az új projekt munkafolyamata során. Válassza ezt a lehetőséget, hogy a Visual Studio a *.AppHost és a *.ServiceDefaults projekteket a kiválasztott projektsablonnal együtt hozza létre.

Tesztprojekt létrehozása

Ha Visual Studiohasznál, és kiválasztja a .NET.NET Aspire Alkalmazás indítása sablont, lehetősége van egy tesztprojektet is belefoglalni. Ez a tesztprojekt egy xUnit-projekt, amely tartalmaz egy mintatesztet, amelyet kiindulópontként használhat a tesztekhez.

További információért lásd: Írd meg az első .NET.NET Aspire tesztedet.

Visual Studio Code szerszámozás

A Visual Studio CodeC# Dev Kit bővítményhasználatával hozhat létre és fejleszthet .NET.NET Aspire projekteket. Ha új .NET Aspire projektet szeretne létrehozni Visual Studio Code, válassza a .NET nézetben a Projekt létrehozása gombot, majd válasszon egyet a .NET.NET Aspire sablonok közül:

Miután létrehozott egy új .NET Aspire projektet, futtatja az alkalmazást, és hibakereséssel áthalad a töréspontokon, a Visual Studio Code hibakereső használatával változókat vizsgál.

Lásd még:

• Nem telepíthető .NET.NET Aspire számítási feladat
• Dev Proxy használata .NET.NET Aspire projekt