Rövid útmutató: Aspire-alkalmazás üzembe helyezése az Azure App Service-ben

Ebben a rövid útmutatóban megtudhatja, hogyan hozhatja létre és helyezheti üzembe első Aspire-alkalmazását az Azure App Service-ben. Az Azure App Service teljes körűen felügyelt platformot biztosít a webalkalmazások üzemeltetéséhez beépített infrastruktúra-karbantartással, biztonsági javításokkal és skálázással.

Ezt a teljes rövid útmutatót a böngészőben a GitHub Codespaces használatával hajthatja végre, amely előre konfigurált fejlesztői környezetet biztosít a .NET 10 és az Azure Developer CLI már telepítve van. A végére egy futó Aspire-alkalmazás van üzembe helyezve az Azure App Service-ben.

Megjegyzés:

Bár ez a rövid útmutató a .NET-projektekre összpontosít, az Aspire támogatja az Aspire 1.3-tól kezdődő Python-alkalmazásokat is. A Python Aspire-alkalmazások ugyanezzel az integrációval is üzembe helyezhetők az Azure App Service-ben.

Előfeltételek

• Egy Azure-fiók, aktív előfizetéssel. Hozzon létre egy fiókot ingyenesen.
• Egy GitHub-fiók. Hozzon létre egy fiókot ingyenesen.

Aspire kezdőalkalmazás létrehozása GitHub-kódtérben

1. Lépjen a github.com/codespaces.

2. A .NET-sablonhoz válassza a Sablon használata lehetőséget.

   A böngésző megnyit egy új kódteret, amelyben a Visual Studio Code fut a böngészőben. A környezet tartalmazza az előre telepített .NET 10-et és az Azure Developer CLI-t.

3. A kódtér termináljában telepítse az Aspire CLI-t globálisan:

   dotnet tool install -g Aspire.Cli
   

4. A terminálban hozzon létre egy új Aspire-alkalmazást. Amikor a rendszer kéri, fogadja el az alapértelmezett értékeket.

   aspire new aspire-starter --name aspire-starter
   

   A parancs létrehoz egy új könyvtárat, amely egy teljes Aspire-megoldással van elnevezve aspire-starter , beleértve a következőket:

   • AppHost-projekt orkesztrációhoz
   • ServiceDefaults-projekt megosztott konfigurációkhoz
   • Minta API- és webes előtérbeli projektek

5. Lépjen be a projektkönyvtárba:

   cd aspire-starter
   

Azure App Service-integráció hozzáadása

Konfigurálja az Aspire-alkalmazást az Azure App Service-ben való üzembe helyezéshez.

1. Adja hozzá az Azure App Service üzemeltetési integrációs csomagját:

   aspire add azure-appservice
   

   A aspire add parancs automatikusan észleli az AppHost-projektet, és hozzáadja az Aspire.Hosting.Azure.AppService csomagot.

2. Nyissa meg az aspire-starter/aspire-starter.AppHost/AppHost.cs.

3. Adjon hozzá egy Azure App Service-környezetet a CreateBuilder sor után:

   builder.AddAzureAppServiceEnvironment("app-service-env");
   

   További információ: Kell-e App Service-környezet az Aspire-alkalmazások futtatásához?

4. Adjon hozzá .WithExternalHttpEndpoints() a apiservice projekthez. A teljes apiservice kódnak a következőképpen kell kinéznie:

   var apiService = builder.AddProject<Projects.aspire_starter_ApiService>("apiservice")
       .WithExternalHttpEndpoints()
       .WithHttpHealthCheck("/health");
   

   Megjegyzés:

   A apiservice-re szükség van .WithExternalHttpEndpoints(), mert az Aspire az App Service-rel jelenleg nem kezeli az alkalmazások közötti forgalmat belső végpontokon keresztül. apiservice külső HTTP-végpontokon keresztül kell elérhetőnek lennie a szolgáltatások közötti kommunikáció működéséhez.

Telepítés az Azure-ra

1. Közvetlenül az aspire-starterből inicializálja az azd-t az aktuális könyvtárban:

   azd init
   

   Amikor a rendszer kéri,

   • Válassza az Aktuális könyvtár vizsgálata lehetőséget.
   • Válassza a Megerősítés és a saját alkalmazásom inicializálásának folytatása lehetőséget.
   • Adjon meg egy egyedi környezetnevet: írjon be egy Ön által választott aspire-quickstartnevet.

   A parancs létrehozza az üzembe helyezéshez szükséges konfigurációs fájlokat, amelyek alapértelmezés szerint csak egy azure.yaml-fájl , amely az AppHost-projektre mutatnak. Ez a konfiguráció lehetővé teszi, hogy azd up megfelelően működjön az AppHost-projekt azonosítása révén. Az host: containerapp érték nem határozza meg az üzembehelyezési célt, mert azd a AppHost.cs fájlban definiált infrastruktúrát AddAzureAppServiceEnvironmenthasználja (ebben az esetben a hozzáadott App Service-környezetet).

2. Jelentkezzen be az Azure-ba a következővel azd auth login: . Ez elindít egy interaktív bejelentkezési oldalt. Jelentkezzen be Azure-fiókja hitelesítő adataival.

   azd auth login
   

3. Az alkalmazás üzembe helyezése:

   azd up
   

   Amikor a rendszer kéri:

   • Előfizetés: Az Azure-előfizetés kiválasztása
   • Hely: Válasszon egy Önhöz közeli régiót (például (Európa) Nyugat-Európa (westeurope))

   A azd up parancs a következő műveleteket hajtja végre a AppHost.cs kód alapján:

   • Új erőforráscsoport létrehozása
   • Azure App Service-csomag létrehozása
   • Azure Container Registry létrehozása
   • Két App Service-webalkalmazást hoz létre (egyet az API-hoz, egyet az előtérben)
   • Felügyelt Aspire-irányítópult-erőforrás létrehozása
   • Alkalmazások létrehozása és tárolóba helyezése
   • A tárolók leküldése az Azure Container Registrybe
   • A konténerek üzembe helyezése az App Service-be

   Ez a folyamat több percet vesz igénybe.

4. Az üzembe helyezés befejezésekor az azd megjeleníti az üzembe helyezett szolgáltatások végponti URL-címeit.

   Deploying services (azd deploy)
   
     (✓) Done: Deploying service apiservice
     - Endpoint: https://apiservice-xxxxxx.azurewebsites.net/ 
   
     (✓) Done: Deploying service webfrontend
     - Endpoint: https://webfrontend-xxxxxx.azurewebsites.net/ 
   
     Aspire Dashboard: https://app-service-env-aspiredashboard-xxxxxx.azurewebsites.net
   
   SUCCESS: Your up workflow to provision and deploy to Azure completed in 1 minute 49 seconds.
   

Aspire alkalmazás böngészése

1. Az üzembehelyezési kimenetben keresse meg a webfrontend szolgáltatás URL-címét. A következőképpen néz ki:

   webfrontend: https://webfrontend-xxxxx.azurewebsites.net
   

2. Másolja ki az URL-címet, és nyissa meg egy új böngészőlapon.

   Az Aspire starter alkalmazás az Azure App Service-ben fut. A webes előtér kommunikál az API-szolgáltatással, bemutatva az elosztott architektúrát.

3. Próbálja meg végigjárni az alkalmazást, hogy ellenőrizze, hogy megfelelően működik-e.

4. Az Aspire-irányítópult megtekintéséhez keresse meg az Aspire-irányítópult URL-címét az üzembehelyezési kimenetben, és nyissa meg egy új böngészőlapon.

   

Az üzembe helyezés részleteinek megtekintése az Azure Portalon

1. Lépjen az Azure Portalra.

2. Írja be az erőforráscsoportokat a keresősávba, és válassza az Erőforráscsoportok lehetőséget.

3. Keresse meg és válassza ki az azd által létrehozott erőforráscsoportot (amelynek neve rg- kezdetű és ezt követi a környezet neve).

   

   A következő erőforrásokat kell látnia:

   • App Service-csomag: Az üzemeltetési infrastruktúra
   • App Services: A webfrontend- és apiservice-alkalmazások
   • Aspire Irányítópult: Felügyelt Azure-erőforrás, amelyet az erőforrás-alapú hozzáférés-vezérlés (RBAC) véd.
   • Tárolóregisztrációs adatbázis: Tárolja a tárolólemezképeket
   • Felhasználó által hozzárendelt identitás: Biztonságos hozzáférést biztosít a szolgáltatások között

Erőforrások tisztítása

Ha már nincs szüksége az Azure-erőforrásokra, törölje őket a díjak elkerülése érdekében.

1. A kódtér termináljában futtassa a következőt:

   azd down
   

2. Amikor a rendszer kéri, erősítse meg, hogy törölni szeretné az erőforrásokat.

3. Az Igen elemet választva véglegesen törölheti az erőforráscsoportot és az összes erőforrást.

A parancs eltávolítja a rövid útmutató során létrehozott összes Azure-erőforrást.

Gyakori kérdések

• Szükségem van egy App Service-környezetre az Aspire-alkalmazások futtatásához?
• Hogyan szabhatom testre az App Service üzembe helyezését?

Szükségem van egy App Service-környezetre az Aspire-alkalmazások futtatásához?

Nem, nincs szükség App Service-környezetre az Aspire-alkalmazások Azure App Service-ben való futtatásához. A AddAzureAppServiceEnvironment metódus létrehoz egy Aspire környezeti koncepciót, amely az alkalmazás üzemeltetési infrastruktúráját képviseli, amely ebben az esetben az App Service lesz. A neve ellenére nem hivatkozik App Service-környezetekre.

Amikor hívja a AddAzureAppServiceEnvironment-t, a következőket biztosítja:

• Azure App Service-csomag (prémium P0V3 szint Linuxon alapértelmezés szerint)
• Azure Container Registry konténerképek tárolására
• Felhasználó által hozzárendelt felügyelt identitás a szolgáltatások közötti biztonságos hozzáféréshez

Ez az Aspire-környezet koncepciója csoportosítja az erőforrásokat, és biztosítja az Aspire-alkalmazások Azure App Service-ben való üzembe helyezéséhez szükséges infrastruktúrát.

Hogyan szabhatom testre az App Service üzembe helyezését?

Az App Service üzembe helyezését a AppHost.cs konfiguráció módosításával szabhatja testre. Az Aspire Azure App Service-integráció számos módszert kínál az üzembe helyezés testreszabására:

• Az App Service-csomag konfigurálása: Termékváltozat, réteg és skálázási beállítások módosítása
• App Service-beállítások testreszabása: Környezeti változók, kapcsolati sztringek és alkalmazásbeállítások hozzáadása
• Infrastruktúra konfigurálása: Hálózatkezelés, hitelesítés és egyéb Azure-erőforrások módosítása
• Meglévő erőforrások használata: Csatlakozás meglévő App Service-csomagokhoz vagy más Azure-erőforrásokhoz

További információ: Aspire-alkalmazás konfigurálása az Azure App Service-hez.

Következő lépések

Sikeresen üzembe helyezett egy Aspire-alkalmazást az Azure App Service-ben! Íme néhány további lépés a felfedezéshez:

Aspire-alkalmazás konfigurálása az Azure App Service-hez

Az Azure App Service dokumentációja

Az Azure App Service funkcióinak felfedezése

• Egyéni tartományok és SSL konfigurálása
• Előkészítési környezetek beállítása
• Hitelesítés konfigurálása