Rövid útmutató: Mikroszolgáltatási alkalmazások üzembe helyezése az Azure Spring Appsben

Feljegyzés

Az első 50 vCPU óra és 100 GB memória minden hónapban ingyenes. További információ: Árcsökkentés – Az Azure Spring Apps többet tesz, kevesebbe kerül! az Azure Blog alkalmazásaiban.

Feljegyzés

Az Azure Spring Apps az Azure Spring Cloud szolgáltatás új neve. Bár a szolgáltatásnak új neve van, bizonyos helyeken a régi nevet fogja látni egy darabig, miközben az eszközök, például képernyőképek, videók és diagramok frissítésével dolgozunk.

Ez a cikk bemutatja, hogyan helyezhet üzembe mikroszolgáltatási alkalmazásokat az Azure Spring Appsben a jól ismert PetClinic mintaalkalmazás használatával.

A Pet Clinic minta bemutatja a mikroszolgáltatás-architektúra mintáját. Az alábbi ábra a PetClinic alkalmazás architektúráját mutatja be az Azure Spring Apps Enterprise-csomagban.

Az ábra a Pet Clinic minta alábbi architekturális folyamatait és kapcsolatait mutatja be:

• Az Azure Spring Apps használatával kezeli az előtér- és háttéralkalmazásokat. A háttéralkalmazások a Spring Boot használatával készültek, és minden alkalmazás HSQLDB-t használ állandó tárolóként. Az újrakonfigurált előtérbeli alkalmazás a Pet Clinic API Gateway-alkalmazásra épül, Node.js önálló előtérbeli webalkalmazásként szolgál.
• Az Azure Spring Apps felügyelt összetevőit használja, beleértve a Szolgáltatásregisztrációs adatbázist, az Alkalmazáskonfigurációs szolgáltatást, a Spring Cloud Gatewayt és az Alkalmazás élő nézetét. Az Alkalmazáskonfigurációs szolgáltatás beolvassa a Git-adattár konfigurációját.
• Elérhetővé teszi a Spring Cloud Gateway URL-címét a háttérszolgáltatás-alkalmazásokhoz való átirányításhoz, és az Alkalmazás élő nézetének URL-címét teszi elérhetővé a háttéralkalmazások figyeléséhez.
• Naplókat elemez a Log Analytics-munkaterület használatával.
• Figyeli a teljesítményt az Alkalmazás Elemzések.

Feljegyzés

Ez a cikk a PetClinic egyszerűsített verzióját használja egy memórián belüli adatbázis használatával, amely nem áll készen a gyors üzembe helyezésre az Azure Spring Appsben.

A Tanzu fejlesztői eszközei nyilvános hozzáférést biztosítanak az Application Live View-hoz, ami kockázati pont. Az éles környezetnek biztonságossá kell tennie a hozzáférést. További információ: A Tanzu Dev Tools konfigurálása az Azure Spring Apps Enterprise-csomagban című témakör Dev Tools konfigurálása című szakasza.

A Pet Clinic minta bemutatja a mikroszolgáltatás-architektúra mintáját. Az alábbi ábra a PetClinic alkalmazás architektúráját mutatja be az Azure Spring Apps Standard csomagban.

Az ábra a Pet Clinic minta alábbi architekturális folyamatait és kapcsolatait mutatja be:

• Az Azure Spring Apps használatával kezeli a Spring Boot-alkalmazásokat. Minden alkalmazás HSQLDB-t használ állandó tárolóként.
• A Spring Cloud Config Server és az Eureka szolgáltatásregisztrációs adatbázis felügyelt összetevőit használja az Azure Spring Appsben. A konfigurációs kiszolgáló beolvassa a Git-adattár konfigurációját.
• Elérhetővé teszi az API Gateway URL-címét a szolgáltatásalkalmazások felé irányuló kérelmek terheléselosztásához, és elérhetővé teszi a Rendszergazda-kiszolgáló URL-címét az alkalmazások kezeléséhez.
• Naplókat elemez a Log Analytics-munkaterület használatával.
• Figyeli a teljesítményt az Alkalmazás Elemzések.

Feljegyzés

Ez a cikk a PetClinic egyszerűsített verzióját használja egy memórián belüli adatbázis használatával, amely nem áll készen a gyors üzembe helyezésre az Azure Spring Appsben.

Az üzembe helyezett alkalmazás admin-server nyilvános hozzáférést tesz elérhetővé, ami kockázati pont. Az éles környezetnek biztonságossá kell tennie a Spring Boot Rendszergazda alkalmazást.

Ez a cikk a következő lehetőségeket ismerteti az Azure Spring Appsben való üzembe helyezéshez:

• Az Azure Portal lehetőség a legegyszerűbb és leggyorsabb módja az erőforrások létrehozásának és az alkalmazások egyetlen kattintással történő üzembe helyezésének. Ez a lehetőség olyan Spring-fejlesztőknek ajánlott, akik gyorsan üzembe szeretnének helyezni alkalmazásokat az Azure-felhőszolgáltatásokban.
• Az Azure Portal + Maven beépülő modul lehetőség hagyományosabb módja az erőforrások létrehozásának és az alkalmazások lépésenkénti üzembe helyezésének. Ez a lehetőség az Azure-felhőszolgáltatásokat első alkalommal használó Spring-fejlesztők számára ajánlott.
• Az Azure CLI-beállítás egy hatékony parancssori eszközt használ az Azure-erőforrások kezeléséhez. Ez a lehetőség olyan Spring-fejlesztőknek ajánlott, akik ismerik az Azure-felhőszolgáltatásokat.

• Az Azure Portal + Maven beépülő modul lehetőség hagyományosabb módja az erőforrások létrehozásának és az alkalmazások lépésenkénti üzembe helyezésének. Ez a lehetőség az Azure-felhőszolgáltatásokat első alkalommal használó Spring-fejlesztők számára ajánlott.
• Az Azure Developer CLI-lehetőség hatékonyabb módszer az erőforrások automatikus létrehozására és alkalmazások egyszerű parancsokkal történő üzembe helyezésére. Az Azure Developer CLI sablonnal építi ki a szükséges Azure-erőforrásokat, és üzembe helyezi az alkalmazáskódot. Ez a lehetőség olyan Spring-fejlesztőknek ajánlott, akik ismerik az Azure-felhőszolgáltatásokat.

1. Előfeltételek

Azure Portal + Maven beépülő modul

• Azure-előfizetés. Ha nem rendelkezik Azure-előfizetéssel, első lépésként hozzon létre egy ingyenes Azure-fiókot.
• Git.
• Java Development Kit (JDK) 17-es verzió.

Azure Developer CLI

• Azure-előfizetés. Ha nem rendelkezik előfizetéssel, a kezdés előtt hozzon létre egy ingyenes fiókot .
• Git.
• Java Development Kit (JDK) 17-es verzió.
• Azure Developer CLI, 1.2.0-s vagy újabb verzió.

Azure Portalra

• Azure-előfizetés. Ha nem rendelkezik előfizetéssel, a kezdés előtt hozzon létre egy ingyenes fiókot .
• Ha első alkalommal helyez üzembe Azure Spring Apps Enterprise-csomagpéldányt a célelőfizetésben, tekintse meg a Nagyvállalati csomag Követelményei szakaszát az Azure Marketplace-en.
• (Nem kötelező) Git.
• (Nem kötelező) Java Development Kit (JDK) 17-es verzió.

Azure Portal + Maven beépülő modul

• Azure-előfizetés. Ha nem rendelkezik előfizetéssel, a kezdés előtt hozzon létre egy ingyenes fiókot .
• Ha első alkalommal helyez üzembe Azure Spring Apps Enterprise-csomagpéldányt a célelőfizetésben, tekintse meg a Nagyvállalati csomag Követelményei szakaszát az Azure Marketplace-en.
• Git.
• (Nem kötelező) Java Development Kit (JDK) 17-es verzió.
• (Nem kötelező) Node.js, 16.20-es vagy újabb verzió.
• Azure CLI, 2.45.0-s vagy újabb verzió.

Azure CLI

• Azure-előfizetés. Ha nem rendelkezik előfizetéssel, a kezdés előtt hozzon létre egy ingyenes fiókot .
• Ha első alkalommal helyez üzembe Azure Spring Apps Enterprise-csomagpéldányt a célelőfizetésben, tekintse meg a Nagyvállalati csomag Követelményei szakaszát az Azure Marketplace-en.
• Git.
• Java Development Kit (JDK) 17-es verzió.
• Azure CLI, 2.55.0-s vagy újabb verzió.

2. A Spring projekt előkészítése

Azure Portal + Maven beépülő modul

A minta helyi előkészítéséhez kövesse az alábbi lépéseket:

1. Klónozza a mintaprojektet a következő paranccsal:

   git clone https://github.com/Azure-Samples/spring-petclinic-microservices.git
   

2. Lépjen a projekt gyökérkönyvtárára, majd az alábbi paranccsal futtassa a mintaprojektet helyileg:

   bash ./scripts/run_all_without_infra.sh
   

3. Miután a szkript sikeresen befejeződött, lépjen http://localhost:8080 a böngészőbe a PetClinic alkalmazás eléréséhez.

Azure Developer CLI

Az alábbi lépésekkel inicializálhatja a Pet Clinic alkalmazást az Azure Developer CLI-sablonok használatával:

1. A Bash ablakban hozzon létre egy új, üres mappát, majd navigáljon hozzá.

2. A projekt inicializálásához használja a következő parancsot:

   azd init --template Azure-Samples/spring-petclinic-microservices
   

   Az alábbi lista a parancsok közötti interakciót ismerteti:

   • Adjon meg egy új környezetnevet: Adjon meg egy környezetnevet, amelyet a rendszer az összes Azure-erőforrás tárolására létrehozott erőforráscsoport utótagjaként használ. Ennek a névnek egyedinek kell lennie az Azure-előfizetésben.

   A konzol az alábbi példához hasonló üzeneteket ad ki:

   Initializing a new project (azd init)
   
   Downloading template code to: <your-local-path>
   (✓) Done: Initialized git repository
   Enter a new environment name: <your-env-name>
   
   SUCCESS: New project initialized!
   You can view the template code in your directory: <your-local-path>
   Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
   

3. A felhőkörnyezet előkészítése

Ez a szakasz azt ismerteti, hogyan hozhat létre Azure Spring Apps-szolgáltatáspéldányt, és hogyan készítheti elő az Azure-felhőkörnyezetet.

Azure Portal + Maven beépülő modul

3.1. Jelentkezzen be az Azure Portalra

Lépjen az Azure Portalra, adja meg a hitelesítő adatait, és jelentkezzen be a portálra. Az alapértelmezett nézet a szolgáltatási irányítópult.

3.2. Azure Spring Apps-példány létrehozása

A szolgáltatáspéldány létrehozásához kövesse az alábbi lépéseket:

1. Válassza az Erőforrás létrehozása lehetőséget az Azure Portal sarkában.

2. Az Azure Services lapon válassza a Compute>Azure Spring Apps lehetőséget.

   

3. Az Azure Spring Apps létrehozása lapon töltse ki az űrlapot az Alapok lapon.

   

   Az űrlap kitöltéséhez használja az alábbi táblázatot útmutatóként. Az ajánlott csomag a Standard.

   Beállítás	Ajánlott érték	Leírás
   Előfizetés	Az Ön előfizetésének a neve.	A kiszolgálóhoz használni kívánt Azure-előfizetés. Ha több előfizetéssel rendelkezik, válassza ki azt az előfizetést, amelynek a számláját ki szeretné fizetni az erőforrásért.
   Erőforráscsoport	myresourcegroup	Egy új erőforráscsoport neve vagy egy meglévő az előfizetéséből.
   Név	myasa	Egyedi név, amely azonosítja az Azure Spring Apps-példányt. A névnek 4 és 32 karakter közötti hosszúságúnak kell lennie, és csak kisbetűket, számokat és kötőjeleket tartalmazhat. A szolgáltatásnév első karakterének betűnek kell lennie, az utolsó karakternek pedig betűnek vagy számnak kell lennie.
   Terv	Standard	A tarifacsomag határozza meg a példányhoz társított erőforrásokat és költségeket.
   Régió	A felhasználókhoz legközelebbi régió.	A felhasználókhoz legközelebb eső hely.
   Zónaredundáns	Nincs kiválasztva	Létrehozza az Azure Spring Apps szolgáltatást egy Azure rendelkezésre állási zónában. Jelenleg nem támogatott minden régióban.

4. Lépjen az Azure Spring Apps létrehozása lap Diagnosztikai beállítások lapjára, majd válassza az Új létrehozása lehetőséget egy új Log Analytics-munkaterületpéldány létrehozásához. Az új Log Analytics-munkaterület létrehozása lapon szükség szerint frissítse a Log Analytics-munkaterület nevét, majd kattintson az OK gombra a létrehozás megerősítéséhez.

   

5. Lépjen az Alkalmazás Elemzések lapra az Azure Spring Apps létrehozása lapon, majd válassza az Új létrehozása lehetőséget egy új alkalmazás Elemzések-példány létrehozásához. Az új alkalmazás létrehozása Elemzések erőforráslapon szükség szerint frissítse az Application Insights nevét, válassza az Erőforrás mód munkaterület-alapú elemét, majd az OK gombra kattintva erősítse meg a létrehozást.

   

6. A kiválasztások áttekintéséhez válassza a Véleményezés és létrehozás lehetőséget. Ezután válassza a Létrehozás lehetőséget az Azure Spring Apps-példány kiépítéséhez.

7. Válassza az Értesítések ikont (harang) az üzembehelyezési folyamat figyeléséhez. Az üzembe helyezés befejezése után a Rögzítés irányítópulton lehetőséget választva létrehozhat egy parancsikont az Azure Portal irányítópultján a szolgáltatás Áttekintés lapján.

   

8. Válassza az Erőforrás megnyitása lehetőséget az Azure Spring Apps áttekintési oldalának megnyitásához .

9. Válassza a Konfigurációs kiszolgáló lehetőséget a navigációs panelen.

10. Az URI konfigurációs kiszolgáló lapján adja meghttps://github.com/Azure-Samples/spring-petclinic-microservices-config.git, majd válassza az Érvényesítés lehetőséget.

    

11. Az ellenőrzés után válassza az Alkalmaz elemet a konfigurációs kiszolgáló konfigurálásának befejezéséhez.

Azure Developer CLI

A szükséges erőforrások létrehozásához kövesse az alábbi lépéseket:

1. Az alábbi paranccsal jelentkezzen be az Azure-ba az OAuth2 használatával. Ha már bejelentkezett, hagyja figyelmen kívül ezt a lépést.

   azd auth login
   

   A konzol az alábbi példához hasonló üzeneteket ad ki:

   Logged in to Azure.
   

2. Az alábbi paranccsal csomagolhatja be az alkalmazás üzembe helyezhető példányát, üzembe helyezheti a sablon infrastruktúráját az Azure-ban, majd üzembe helyezheti az alkalmazáskódot az újonnan kiépített erőforrásokon:

   azd provision
   

   Az alábbi lista a parancsok interakcióit ismerteti:

   • Válasszon ki egy használni kívánt Azure-előfizetést: Mozogjon nyilakkal, írja be a szűrést, majd nyomja le az Enter billentyűt.
   • Válassza ki a használni kívánt Azure-helyet: Mozogjon nyilakkal, írja be a szűrést, majd nyomja le az Enter billentyűt.

   A konzol az alábbi példához hasonló üzeneteket ad ki:

   SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

   Feljegyzés

   A parancs végrehajtása hosszabb időt is igénybe vehet. Az Azure-erőforrások üzembe helyezésekor megjelenik egy előrehaladási mutató.

4. Az alkalmazások üzembe helyezése az Azure Spring Appsben

Most már üzembe helyezheti az alkalmazást az Azure Spring Appsben.

Azure Portal + Maven beépülő modul

A mikroszolgáltatási alkalmazások üzembe helyezéséhez kövesse az alábbi lépéseket az Azure Spring Apps Maven beépülő moduljának használatával:

1. Lépjen a mintaprojekt könyvtárára, majd az alábbi paranccsal konfigurálja az Azure Spring Apps alkalmazásait:

   ./mvnw -P spring-apps com.microsoft.azure:azure-spring-apps-maven-plugin:1.17.0:config
   

2. Az alábbi lista a parancsok interakcióit ismerteti:

   • Válassza ki a konfigurálni kívánt gyermekmodulokat (vesszővel elválasztott bemeneti számok, például: [1-2,4,6], ENTER az ÖSSZES kiválasztásához): Nyomja le az Enter billentyűt az összes kijelöléséhez.
   • OAuth2-bejelentkezés: Engedélyezze a bejelentkezést az Azure-ba az OAuth2 protokoll alapján.
   • Előfizetés kiválasztása: Válassza ki a létrehozott Azure Spring Apps-példány előfizetési listájának számát, amely alapértelmezés szerint a lista első előfizetése. Ha az alapértelmezett számot használja, nyomja le közvetlenül az Enter billentyűt .
   • Válassza ki az Üzembe helyezéshez az Azure Spring Appst: Válassza ki a létrehozott Azure Spring Apps-példány listaszámát. Ha az alapértelmezett számot használja, nyomja le közvetlenül az Enter billentyűt .
   • Válassza ki a nyilvános hozzáféréshez szükséges alkalmazásokat:(vesszővel elválasztott bemeneti számok, például: [1-2,4,6], ENTER a NONE kiválasztásához): Adja meg az 1,5 értéket és admin-serverapi-gatewaya .
   • Győződjön meg arról, hogy menti az összes fenti konfigurációt (Y/n):: Nyomja le az y billentyűt. Ha az n billentyűt lenyomja, a konfiguráció nem lesz mentve a POM-fájlokba.

3. Az egyes alkalmazások létrehozásához és üzembe helyezéséhez használja a következő parancsot:

   ./mvnw azure-spring-apps:deploy
   

4. Az OAuth2 bejelentkezési kéréséhez engedélyezze a bejelentkezést az Azure-ba az OAuth2 protokoll alapján.

   Feljegyzés

   Az Azure Spring Apps üzembe helyezése akár 25 percet is igénybe vehet.

A parancs futtatása után a napló az alábbi példához hasonló kimenetet jelenít meg, amely azt jelzi, hogy az összes üzembe helyezés sikeres:

[INFO] Deployment(default) is successfully updated.
[INFO] Deployment Status: Running
[INFO]   InstanceName:admin-server-default-xx-xx-xxx  Status:Running Reason:null       DiscoverStatus:UP
[INFO] Getting public url of app(admin-server)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-admin-server.azuremicroservices.io

...

[INFO] Getting public url of app(api-gateway)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-api-gateway.azuremicroservices.io

Azure Developer CLI

Az alábbi lépésekkel csomagolhatja az alkalmazást, kiépítheti a webalkalmazás által igényelt Azure-erőforrásokat, majd üzembe helyezheti az Azure Spring Appsben:

1. Az alkalmazás üzembe helyezhető példányának csomagolásához használja a következő parancsot:

   azd package
   

   A konzol az alábbi példához hasonló üzeneteket ad ki:

   SUCCESS: Your application was packaged for Azure in xx minutes xx seconds.
   

2. Az alábbi paranccsal helyezze üzembe az alkalmazáskódot az újonnan kiépített erőforrásokon:

   azd deploy
   

   A konzol az alábbi példához hasonló üzeneteket ad ki:

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service admin-server
   - Endpoint: https://<your-Azure-Spring-Apps-instance-name>-admin-server.azuremicroservices.io
   
   (✓) Done: Deploying service api-gateway
   - Endpoint: https://<your-Azure-Spring-Apps-instance-name>-api-gateway.azuremicroservices.io
   
   (✓) Done: Deploying service customers-service
   - No endpoints were found
   
   (✓) Done: Deploying service vets-service
   - No endpoints were found
   
   (✓) Done: Deploying service visits-service
   - No endpoints were found
   
   
   SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

Feljegyzés

Az előző három parancsot is azd up kombinálhatja: azd package (az alkalmazás üzembe helyezhető példányát csomagolja), azd provision (Azure-erőforrásokat helyez üzembe) és azd deploy (alkalmazáskódot helyez üzembe). További információ: Azure-Samples/spring-petclinic-microservices.

2. A Spring projekt előkészítése

Azure Portalra

A következő szakaszban az Üzembe helyezés az Azure-ban gomb elindít egy Azure Portal-felületet, amely a Spring PetClinic-adattárból telepíti a forráskódot. Nincs szükség helyi előkészítési lépésekre.

Azure Portal + Maven beépülő modul

Ha ellenőrizni szeretné az alkalmazást a felhőben való üzembe helyezés előtt, kövesse az alábbi lépéseket a helyi gépen:

1. A Következő paranccsal klónozza a Pet Clinic alkalmazást a GitHubról:

   git clone https://github.com/Azure-Samples/spring-petclinic-microservices.git
   

2. Lépjen a projekt gyökérkönyvtárára, majd a következő paranccsal hozza létre a projektet:

   ./mvnw clean package -DskipTests
   

Ha helyileg szeretné futtatni az alkalmazást, kövesse az alábbi lépéseket. Ellenkező esetben kihagyhatja ezeket a lépéseket.

1. Nyisson meg egy új Bash-ablakot, majd a következő paranccsal indítsa el a Config Servert:

   ./mvnw spring-boot:run -pl spring-petclinic-config-server
   

2. Nyisson meg egy új Bash-ablakot, majd a következő paranccsal indítsa el a Felderítési kiszolgálót:

   ./mvnw spring-boot:run -pl spring-petclinic-discovery-server
   

3. Az Ügyfelek, állatorvosok, látogatások és Spring Cloud Gateway-szolgáltatások esetében nyisson meg egy új Bash-ablakot, és a következő parancsokkal indítsa el a szolgáltatásokat:

   ./mvnw spring-boot:run -pl spring-petclinic-customers-service
   ./mvnw spring-boot:run -pl spring-petclinic-vets-service
   ./mvnw spring-boot:run -pl spring-petclinic-visits-service
   ./mvnw spring-boot:run -Dspring-boot.run.profiles=default,development \
       -pl spring-petclinic-api-gateway
   

4. Nyisson meg egy új Bash-ablakot, és keresse meg a projektkönyvtárat spring-petclinic-frontend . A függőségek telepítéséhez és az előtérbeli alkalmazás futtatásához használja az alábbi parancsokat:

   npm install
   npm run start
   

5. Miután a szkript sikeresen befejeződött, lépjen http://localhost:8080 a böngészőbe a PetClinic alkalmazás eléréséhez.

Azure CLI

Ha ellenőrizni szeretné az alkalmazást a felhőben való üzembe helyezés előtt, kövesse az alábbi lépéseket a helyi gépen:

1. A Következő paranccsal klónozza a Pet Clinic alkalmazást a GitHubról:

   git clone https://github.com/Azure-Samples/spring-petclinic-microservices.git
   

2. Lépjen a projekt gyökérkönyvtárára, majd a következő paranccsal hozza létre a projektet:

   ./mvnw clean package -DskipTests
   

Ha helyileg szeretné futtatni az alkalmazást, kövesse az alábbi lépéseket. Ellenkező esetben kihagyhatja ezeket a lépéseket.

1. Nyisson meg egy új Bash-ablakot, majd a következő paranccsal indítsa el a Config Servert:

   ./mvnw spring-boot:run -pl spring-petclinic-config-server
   

2. Nyisson meg egy új Bash-ablakot, majd a következő paranccsal indítsa el a Felderítési kiszolgálót:

   ./mvnw spring-boot:run -pl spring-petclinic-discovery-server
   

3. Az Ügyfelek, állatorvosok, látogatások és Spring Cloud Gateway-szolgáltatások esetében nyisson meg egy új Bash-ablakot, és a következő parancsokkal indítsa el a szolgáltatásokat:

   ./mvnw spring-boot:run -pl spring-petclinic-customers-service
   ./mvnw spring-boot:run -pl spring-petclinic-vets-service
   ./mvnw spring-boot:run -pl spring-petclinic-visits-service
   ./mvnw spring-boot:run -Dspring-boot.run.profiles=default,development \
       -pl spring-petclinic-api-gateway
   

4. Nyisson meg egy új Bash-ablakot, és keresse meg a projektkönyvtárat spring-petclinic-frontend . A függőségek telepítéséhez és az előtérbeli alkalmazás futtatásához használja az alábbi parancsokat:

   npm install
   npm run start
   

5. Miután a szkript sikeresen befejeződött, lépjen http://localhost:8080 a böngészőbe a PetClinic alkalmazás eléréséhez.

3. A felhőkörnyezet előkészítése

A minta futtatásához szükséges fő erőforrás egy Azure Spring Apps-példány. Ez a szakasz azt ismerteti, hogyan hozhatja létre ezt az erőforrást.

Azure Portalra

Ez a szakasz egy Üzembe helyezés az Azure-ban gombbal indít üzembe helyezési felületet az Azure Portalon. Ez a felület ARM-sablonnal hoz létre Azure-erőforrásokat.

3.1. Jelentkezzen be az Azure Portalra

Lépjen az Azure Portalra, adja meg a hitelesítő adatait, és jelentkezzen be a portálra. Az alapértelmezett nézet a szolgáltatási irányítópult.

3.2. Azure-erőforrások létrehozása

Az alábbi lépésekkel hozza létre az alkalmazás által használt összes Azure-erőforrást:

1. Válassza a következő Üzembe helyezés az Azure-ban gombot az üzembe helyezési felület azure portalon való elindításához:

   

2. Töltse ki az űrlapot az Alapismeretek lapon. Az űrlap kitöltéséhez használja az alábbi táblázatot útmutatóként:

   Beállítás	Ajánlott érték	Leírás
   Előfizetés	Az Ön előfizetésének a neve.	A kiszolgálóhoz használni kívánt Azure-előfizetés. Ha több előfizetéssel rendelkezik, válassza ki azt az előfizetést, amelyben ki szeretné számlázni az erőforrást.
   Erőforráscsoport	myresourcegroup	Egy új erőforráscsoport neve vagy egy meglévő az előfizetéséből.
   Régió	A felhasználókhoz legközelebbi régió.	A rendszer a régiót használja az erőforráscsoport létrehozásához.

   

3. A kiválasztások áttekintéséhez válassza a Véleményezés és létrehozás lehetőséget. Ezután válassza a Létrehozás lehetőséget az alkalmazás Azure Spring Appsben való üzembe helyezéséhez.

4. Az eszköztáron válassza az Értesítések ikont (csengő) az üzembehelyezési folyamat megfigyeléséhez. Az üzembe helyezés befejezése után kiválaszthatja a Rögzítés az irányítópulton lehetőséget, amely létrehoz egy csempét ehhez a szolgáltatáshoz az Azure Portal irányítópultján a szolgáltatás áttekintési oldalának parancsikonjaként. Válassza az Ugrás az erőforrásra lehetőséget a szolgáltatás Áttekintés lapjának megnyitásához.

   

Azure Portal + Maven beépülő modul

3.1. Jelentkezzen be az Azure Portalra

Lépjen az Azure Portalra , és adja meg a hitelesítő adatait a portálra való bejelentkezéshez. Az alapértelmezett nézet a szolgáltatási irányítópult.

3.2. Azure Spring Apps-példány létrehozása

A szolgáltatáspéldány létrehozásához kövesse az alábbi lépéseket:

1. Válassza az Erőforrás létrehozása lehetőséget az Azure Portal sarkában.

2. Válassza a Compute>Azure Spring Apps lehetőséget.

3. Töltse ki az űrlapot az Alapismeretek lapon. Az űrlap kitöltéséhez használja az alábbi táblázatot útmutatóként:

   Beállítás	Ajánlott érték	Leírás
   Előfizetés	Az Ön előfizetésének a neve.	A kiszolgálóhoz használni kívánt Azure-előfizetés. Ha több előfizetéssel rendelkezik, válassza ki azt az előfizetést, amelyben ki szeretné számlázni az erőforrást.
   Erőforráscsoport	myresourcegroup	Egy új erőforráscsoport neve vagy egy meglévő az előfizetéséből.
   Név	myasa	Egyedi név, amely azonosítja az Azure Spring Apps szolgáltatást. A névnek 4 és 32 karakter közötti hosszúságúnak kell lennie, és csak kisbetűket, számokat és kötőjeleket tartalmazhat. A szolgáltatásnév első karakterének betűnek kell lennie, az utolsó karakternek pedig betűnek vagy számnak kell lennie.
   Régió	A felhasználókhoz legközelebbi régió.	A felhasználókhoz legközelebb eső hely.
   Üzemeltetési lehetőségek és csomagok	Vállalat	A példányhoz társított erőforrást és költséget meghatározó díjszabási csomag.
   Zónaredundáns	Nincs kiválasztva	Az Azure Spring Apps szolgáltatás azure-beli rendelkezésre állási zónában való létrehozásának lehetősége. Ez a funkció jelenleg nem támogatott minden régióban.
   SzoftverES IP-csomag	Használatalapú fizetés	Az Azure Spring Apps használat közbeni fizetését lehetővé tevő díjszabási csomag.
   Mintaprojekt üzembe helyezése	Nincs kiválasztva	A beépített mintaalkalmazás használatának lehetősége.

4. Lépjen az Azure Spring Apps létrehozása lap Diagnosztikai beállítások lapjára, majd válassza az Új létrehozása lehetőséget egy új Log Analytics-munkaterületpéldány létrehozásához. Az új Log Analytics-munkaterület létrehozása lapon szükség szerint frissítse a Log Analytics-munkaterület nevét, majd kattintson az OK gombra a létrehozás megerősítéséhez.

5. Lépjen az Alkalmazás Elemzések lapra az Azure Spring Apps létrehozása lapon, majd válassza az Új létrehozása lehetőséget egy új alkalmazás Elemzések-példány létrehozásához. Az új alkalmazás létrehozása Elemzések erőforráslapon szükség szerint frissítse az Application Insights nevét, válassza az Erőforrás mód munkaterület-alapú elemét, majd az OK gombra kattintva erősítse meg a létrehozást.

6. A kiválasztások áttekintéséhez válassza a Véleményezés és létrehozás lehetőséget. Ezután válassza a Létrehozás lehetőséget az Azure Spring Apps-példány kiépítéséhez.

7. Válassza az Értesítések ikont (harang) az üzembehelyezési folyamat figyeléséhez. Az üzembe helyezés befejezése után a Rögzítés irányítópulton lehetőséget választva létrehozhat egy parancsikont az Azure Portal irányítópultján a szolgáltatás Áttekintés lapján.

   

8. Válassza az Erőforrás megnyitása lehetőséget az Azure Spring Apps áttekintési oldalának megnyitásához .

3.3. Azure Spring Apps-példány konfigurálása

Az alábbi szakaszok bemutatják, hogyan konfigurálhatja a szolgáltatáspéldányt.

Az alkalmazások létrehozása

Az alkalmazások létrehozásához kövesse az alábbi lépéseket:

1. A navigációs panelen válassza az Alkalmazások lehetőséget, majd az Alkalmazás létrehozása lehetőséget.

2. Az Alkalmazás létrehozása lapon használja az előtérnevet, és hagyja meg az összes többi mezőt az alapértelmezett értékekkel.

3. Ismételje meg az előző lépést az alábbi alkalmazásnevek mindegyikével:

   • customers-service
   • vets-service
   • visits-service

4. Válassza a Létrehozás lehetőséget az alkalmazás létrehozásának befejezéséhez.

   

Szolgáltatásregisztrációs adatbázis konfigurálása

A Szolgáltatásregisztrációs adatbázis konfigurálásához kövesse az alábbi lépéseket:

1. A navigációs panelen válassza a Szolgáltatásregisztrációs adatbázis lehetőséget.

2. Válassza az Alkalmazáskötés lehetőséget, válassza a Kötés alkalmazás lehetőséget, válasszon customers-service a listából, majd válassza az Alkalmaz lehetőséget.

3. Ismételje meg az előző lépést a következő alkalmazások kötéséhez:

   • vets-service
   • visits-service

   

Alkalmazáskonfigurációs szolgáltatás konfigurálása

Az Alkalmazáskonfigurációs szolgáltatás konfigurálásához kövesse az alábbi lépéseket:

1. A navigációs panelen válassza az Alkalmazáskonfigurációs szolgáltatás, majd a Gépház lehetőséget.

2. Töltse ki az adattárat a következő információkkal, majd válassza az Ellenőrzés elemet:

   • Név: alapértelmezett
   • Minták: alkalmazás,api-gateway,customers-service,vets-service,visits-service
   • URI: https://github.com/Azure-Samples/spring-petclinic-microservices-config.git.
   • Címke: master

   

3. Az ellenőrzés után válassza az Alkalmaz lehetőséget az Alkalmazáskonfigurációs szolgáltatás konfigurációjának befejezéséhez.

4. Válassza az Alkalmazáskötés lehetőséget, válassza a Kötés alkalmazás lehetőséget, válasszon customers-service a listából, majd válassza az Alkalmaz lehetőséget.

5. Ismételje meg az előző lépést a következő alkalmazások kötéséhez:

   • vets-service
   • visits-service

   

Alkalmazások konfigurációs fájlmintáinak beállítása

A konfigurációs fájlminták beállításához kövesse az alábbi lépéseket:

1. A navigációs panelen válassza az Alkalmazások lehetőséget, majd válassza ki az customers-service alkalmazást.

2. Az Alkalmazás áttekintése lapon válassza a Konfiguráció lehetőséget, válassza az Általános beállítások lapon a Konfigurációs fájlminták lehetőséget, majd válassza az alkalmazást és customers-servicea . Válassza a Mentés lehetőséget a konfigurációs fájlminták beállításához.

3. Ismételje meg az előző lépést a következő alkalmazások konfigurációs fájlmintáinak mentéséhez:

   • vets-service: Válassza ki az alkalmazást és a vets-service.
   • visits-service: Válassza ki az alkalmazást és a visits-service.

Spring Cloud Gateway konfigurálása

Ez a szakasz bemutatja, hogyan konfigurálhatja a Spring Cloud Gatewayt.

Először az alábbi lépésekkel rendeljen hozzá végpontot az átjáró-hozzáféréshez:

1. A navigációs panelen válassza a Spring Cloud Gateway lehetőséget.

2. Az Áttekintés lapon válassza az Igen lehetőséget egy végpont hozzárendeléséhez. Mentse a végpont URL-címét későbbi használatra.

Ezután konfigurálja a Spring Cloud Gateway útválasztását. Mivel az Azure Portal jelenleg nem támogatja a Spring Cloud Gateway útvonalkonfigurációját, nyisson meg egy Bash-ablakot, és az alábbi Azure CLI-lépésekkel konfigurálja az útválasztást:

1. A következő paranccsal jelentkezzen be az Azure CLI-be:

   az login
   

2. Az alábbi parancsokkal telepítheti az Azure CLI Azure Spring Apps-bővítményét, és regisztrálhatja a névteret Microsoft.SaaS:

   az extension add --name spring --upgrade
   az provider register --namespace Microsoft.SaaS
   

3. Az alábbi paranccsal fogadja el a jogi feltételeket és az adatvédelmi nyilatkozatokat:

   Feljegyzés

   Erre a lépésre csak akkor van szükség, ha az előfizetése még soha nem lett használva az Azure Spring Apps nagyvállalati csomagpéldányának létrehozásához.

   az term accept \
       --publisher vmware-inc \
       --product azure-spring-cloud-vmware-tanzu-2 \
       --plan asa-ent-hr-mtr
   

4. Hozzon létre változókat az erőforrásnevek tárolásához az alábbi parancsokkal. Mindenképpen cserélje le a helyőrzőket a saját értékeire.

   export SUBSCRIPTION_ID=<subscription-ID>
   export RESOURCE_GROUP=<resource-group-name>
   export SPRING_APPS_NAME=<Azure-Spring-Apps-instance-name>
   export APP_CUSTOMERS_SERVICE=customers-service
   export APP_VETS_SERVICE=vets-service
   export APP_VISITS_SERVICE=visits-service
   export APP_FRONTEND=frontend
   

5. Az alapértelmezett előfizetés beállításához használja a következő parancsot:

   az account set --subscription ${SUBSCRIPTION_ID}
   

6. Az alkalmazás útválasztásának beállításához használja a customers-service következő parancsot:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_CUSTOMERS_SERVICE} \
       --app-name ${APP_CUSTOMERS_SERVICE} \
       --routes-json \
         '[
           {
             "predicates": [
               "Path=/api/customer/**"
             ],
             "filters": [
               "StripPrefix=2"
             ]
           }
         ]'
   

7. Az alkalmazás útválasztásának beállításához használja a vets-service következő parancsot:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_VETS_SERVICE} \
       --app-name ${APP_VETS_SERVICE} \
       --routes-json \
         '[
            {
              "predicates": [
                "Path=/api/vet/**"
              ],
              "filters": [
                "StripPrefix=2"
              ]
            }
          ]'
   

8. Az alkalmazás útválasztásának beállításához használja a visits-service következő parancsot:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_VISITS_SERVICE} \
       --app-name ${APP_VISITS_SERVICE} \
       --routes-json \
         '[
            {
              "predicates": [
                "Path=/api/visit/**"
              ],
              "filters": [
                "StripPrefix=2"
              ]
            }
          ]'
   

9. Az előtéralkalmazás útválasztásának beállításához használja az alábbi parancsot:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_FRONTEND} \
       --app-name ${APP_FRONTEND} \
       --routes-json \
         '[
            {
              "predicates": [
                "Path=/**"
              ],
              "filters": [
                "StripPrefix=0"
              ],
              "order": 1000
            }
          ]'
   

Fejlesztői eszközök konfigurálása

A fejlesztői eszközök konfigurálásához kövesse az alábbi lépéseket.

1. A navigációs panelen válassza a Fejlesztői eszközök lehetőséget.

2. Válassza a Végpont hozzárendelése lehetőséget a fejlesztői eszközök végpontjának hozzárendeléséhez.

3. Mentse az App Live View végpontját későbbi használatra.

Azure CLI

3.1. Adja meg az egyes erőforrások nevét

Hozzon létre változókat az erőforrásnevek tárolásához az alábbi parancsokkal. Mindenképpen cserélje le a helyőrzőket a saját értékeire.

export LOCATION=<location>
export RESOURCE_GROUP=myresourcegroup
export SPRING_APPS=myasa
export APP_FRONTEND=frontend
export APP_CUSTOMERS_SERVICE=customers-service
export APP_VETS_SERVICE=vets-service
export APP_VISITS_SERVICE=visits-service
export GIT_CONFIG_REPO=default

3.2. Bejelentkezés az Azure CLI-be

A bejelentkezéshez kövesse az alábbi lépéseket:

1. A következő paranccsal jelentkezzen be az Azure CLI-be:

   az login
   

2. A következő paranccsal listázhatja az összes elérhető előfizetést a használni kívánt előfizetés-azonosító meghatározásához:

   az account list --output table
   

3. Az alapértelmezett előfizetés beállításához használja a következő parancsot:

   az account set --subscription <subscription-ID>
   

3.3. Új erőforráscsoport létrehozása

Az alábbi lépésekkel hozzon létre egy új erőforráscsoportot:

1. Az alapértelmezett hely beállításához használja a következő parancsot:

   az configure --defaults location=${LOCATION}
   

2. Erőforráscsoport létrehozásához használja a következő parancsot:

   az group create --resource-group ${RESOURCE_GROUP}
   

3. Az újonnan létrehozott erőforráscsoportot az alábbi paranccsal állíthatja be alapértelmezett erőforráscsoportként:

   az configure --defaults group=${RESOURCE_GROUP}
   

3.4. Bővítmény telepítése és névtér regisztrálása

A következő parancsokkal telepítheti az Azure CLI Azure Spring Apps-bővítményét, és regisztrálhatja a Microsoft.SaaS névteret:

az extension add --name spring --upgrade
az provider register --namespace Microsoft.SaaS

3.5. Azure Spring Apps-példány létrehozása

A szolgáltatáspéldány létrehozásához kövesse az alábbi lépéseket:

1. A következő paranccsal fogadja el a vállalati csomagra vonatkozó jogi feltételeket és adatvédelmi nyilatkozatokat:

   Feljegyzés

   Erre a lépésre csak akkor van szükség, ha az előfizetése még soha nem lett használva az Azure Spring Apps nagyvállalati csomagpéldányának létrehozásához.

   az term accept \
       --publisher vmware-inc \
       --product azure-spring-cloud-vmware-tanzu-2 \
       --plan asa-ent-hr-mtr
   

2. A következő paranccsal hozzon létre egy Azure Spring Apps-szolgáltatáspéldányt a szükséges Tanzu-összetevőkkel:

   az spring create \
       --name ${SPRING_APPS} \
       --sku Enterprise \
       --enable-application-configuration-service \
       --enable-service-registry \
       --enable-gateway \
       --enable-application-live-view
   

3.6. Az Azure Spring Apps-példány konfigurálása

A szolgáltatáspéldány konfigurálásához kövesse az alábbi lépéseket:

1. Az alábbi paranccsal konfigurálhatja az Azure Spring Apps-példány diagnosztikai beállításait:

   export SPRING_APPS_RESOURCE_ID=$(az spring show \
       --name ${SPRING_APPS} \
       --query id \
       --output tsv)
   az monitor diagnostic-settings create \
       --resource ${SPRING_APPS_RESOURCE_ID} \
       --name logs-and-metrics \
       --workspace ${SPRING_APPS} \
       --logs '[
         {
           "category": "ApplicationConsole",
           "enabled": true,
           "retentionPolicy": {
             "enabled": false,
             "days": 0
           }
         },
         {
            "category": "SystemLogs",
            "enabled": true,
            "retentionPolicy": {
              "enabled": false,
              "days": 0
            }
         },
         {
            "category": "IngressLogs",
            "enabled": true,
            "retentionPolicy": {
              "enabled": false,
              "days": 0
             }
         }
       ]' \
       --metrics '[
         {
           "category": "AllMetrics",
           "enabled": true,
           "retentionPolicy": {
             "enabled": false,
             "days": 0
           }
         }
       ]'
   

2. Az alábbi parancsokkal hozhat létre alkalmazásokat az Azure Spring Apps-példányhoz:

   az spring app create --service ${SPRING_APPS} --name ${APP_FRONTEND}
   az spring app create --service ${SPRING_APPS} --name ${APP_CUSTOMERS_SERVICE}
   az spring app create --service ${SPRING_APPS} --name ${APP_VETS_SERVICE}
   az spring app create --service ${SPRING_APPS} --name ${APP_VISITS_SERVICE}
   

3. A szolgáltatásregisztrációs adatbázis alkalmazásainak kötéséhez használja az alábbi parancsokat:

   az spring service-registry bind --service ${SPRING_APPS} --app ${APP_CUSTOMERS_SERVICE}
   az spring service-registry bind --service ${SPRING_APPS} --app ${APP_VETS_SERVICE}
   az spring service-registry bind --service ${SPRING_APPS} --app ${APP_VISITS_SERVICE}
   

4. Az alábbi paranccsal hozzon létre egy konfigurációs adattárat az Alkalmazáskonfigurációs szolgáltatáshoz:

   az spring application-configuration-service git repo add \
       --service ${SPRING_APPS} \
       --name ${GIT_CONFIG_REPO} \
       --patterns application,api-gateway,customers-service,vets-service,visits-service \
       --uri https://github.com/Azure-Samples/spring-petclinic-microservices-config.git \
       --label master
   

5. Az alábbi parancsokkal kötheti az alkalmazásokat az Alkalmazáskonfigurációs szolgáltatáshoz:

   az spring application-configuration-service bind \
       --service ${SPRING_APPS} \
       --app ${APP_CUSTOMERS_SERVICE}
   az spring application-configuration-service bind \
       --service ${SPRING_APPS} \
       --app ${APP_VETS_SERVICE}
   az spring application-configuration-service bind \
       --service ${SPRING_APPS} \
       --app ${APP_VISITS_SERVICE}
   

6. A következő paranccsal rendeljen végpontot a Spring Cloud Gatewayhez:

   az spring gateway update --service ${SPRING_APPS} --assign-endpoint
   

7. Az alkalmazás útválasztásának beállításához használja a customers-service következő parancsot:

   az spring gateway route-config create \
       --service ${SPRING_APPS} \
       --name ${APP_CUSTOMERS_SERVICE} \
       --app-name ${APP_CUSTOMERS_SERVICE} \
       --routes-json '[
         {
           "predicates": [
             "Path=/api/customer/**"
           ],
           "filters": [
             "StripPrefix=2"
           ]
         }
      ]'
   

8. Az alkalmazás útválasztásának beállításához használja a vets-service következő parancsot:

   az spring gateway route-config create \
       --service ${SPRING_APPS} \
       --name ${APP_VETS_SERVICE} \
       --app-name ${APP_VETS_SERVICE} \
       --routes-json '[
         {
           "predicates": [
             "Path=/api/vet/**"
           ],
           "filters": [
             "StripPrefix=2"
           ]
         }
       ]'
   

9. Az alkalmazás útválasztásának beállításához használja a visits-service következő parancsot:

   az spring gateway route-config create \
       --service ${SPRING_APPS} \
       --name ${APP_VISITS_SERVICE} \
       --app-name ${APP_VISITS_SERVICE} \
       --routes-json '[
         {
           "predicates": [
             "Path=/api/visit/**"
           ],
           "filters": [
             "StripPrefix=2"
           ]
         }
       ]'
   

10. Az alkalmazás útválasztásának beállításához használja a frontend következő parancsot:

    az spring gateway route-config create \
        --service ${SPRING_APPS} \
        --name ${APP_FRONTEND} \
        --app-name ${APP_FRONTEND} \
        --routes-json '[
          {
            "predicates": [
              "Path=/**"
            ],
            "filters": [
              "StripPrefix=0"
            ],
            "order": 1000
          }
        ]'
    

11. Az alábbi paranccsal rendeljen végpontot az Application Live View nézethez:

    az spring dev-tool update --service ${SPRING_APPS} --assign-endpoint
    

4. Az alkalmazások üzembe helyezése az Azure Spring Appsben

Azure Portalra

Az előző szakaszban az Üzembe helyezés az Azure-ban gomb egy olyan Azure Portal-felületet indít el, amely magában foglalja az alkalmazás üzembe helyezését, így semmi másra nincs szükség.

Azure Portal + Maven beépülő modul

Az Azure Spring Apps Maven beépülő moduljának üzembe helyezéséhez kövesse az alábbi lépéseket:

1. Lépjen a projekt gyökérkönyvtárára, majd futtassa a következő parancsot az alkalmazások Azure Spring Appsben való konfigurálásához:

   ./mvnw -P spring-apps-enterprise com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   Az alábbi lista a parancsok interakcióit ismerteti:

   • Válassza ki a konfigurálni kívánt gyermekmodulokat: Az Enter billentyűt lenyomva jelölje ki az összeset.
   • Előfizetés kiválasztása: Válassza ki a létrehozott Azure Spring Apps-példány előfizetési listájának számát, amely alapértelmezés szerint a lista első előfizetése. Ha az alapértelmezett számot használja, nyomja le közvetlenül az Enter billentyűt .
   • Meglévő Azure Spring Apps használata az Azure-ban: Nyomja le az y billentyűt a meglévő Azure Spring Apps-példány használatához.
   • Válassza ki az alkalmazásokat a nyilvános hozzáférés felfedéséhez: Nyomja le az Enter billentyűt a none kiválasztásához.
   • Ellenőrizze, hogy menti-e a fenti konfigurációkat: Nyomja le az y billentyűt. Ha az n billentyűt lenyomja, a konfiguráció nem lesz mentve a POM-fájlokba.

2. A háttéralkalmazások üzembe helyezéséhez használja a következő parancsot:

   ./mvnw azure-spring-apps:deploy
   

   A parancs futtatása után az alábbi naplóüzenetekből láthatja, hogy az üzembe helyezés sikeres volt:

   [INFO] Start deploying artifact(customers-service-3.0.1.jar) to deployment(default) of app(customers-service)...
   [INFO] Artifact(customers-service-3.0.1.jar) is successfully deployed to deployment(default) of app(customers-service).
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   
   ...
   
   [INFO] Start deploying artifact(vets-service-3.0.1.jar) to deployment(default) of app(vets-service)...
   [INFO] Artifact(vets-service-3.0.1.jar) is successfully deployed to deployment(default) of app(vets-service).
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   
   ...
   
   [INFO] Start deploying artifact(visits-service-3.0.1.jar) to deployment(default) of app(visits-service)...
   [INFO] Artifact(visits-service-3.0.1.jar) is successfully deployed to deployment(default) of app(visits-service).
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   

3. Az Azure Portal nem támogatja az előtérbeli alkalmazások üzembe helyezését, ezért az előtéralkalmazás üzembe helyezéséhez használja az alábbi Azure CLI-parancsot:

   az spring app deploy \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_FRONTEND} \
       --source-path spring-petclinic-frontend \
       --build-env BP_WEB_SERVER=nginx
   

   A parancs futtatása után az alábbi naplóüzenetekből láthatja, hogy az üzembe helyezés sikeres volt:

   [5/5] Updating deployment in app "frontend" (this operation can take a while to complete)
   Azure Spring Apps will use rolling upgrade to update your deployment, you have 1 instance, Azure Spring Apps will update the deployment in 1 round.
   The deployment is in round 1, 1 old instance is deleted/deleting and 1 new instance is started/starting
   Your application is successfully deployed.
   

Azure CLI

Az alkalmazások üzembe helyezéséhez kövesse az alábbi lépéseket:

1. Adja meg a projekt gyökérkönyvtárát, és használja a következő parancsot az előtérbeli alkalmazás létrehozásához és üzembe helyezéséhez:

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_FRONTEND} \
       --build-env BP_WEB_SERVER=nginx \
       --source-path ./spring-petclinic-frontend
   

2. Az alkalmazás létrehozásához és üzembe helyezéséhez használja a customers-service következő parancsot:

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_CUSTOMERS_SERVICE} \
       --source-path \
       --config-file-pattern application,customers-service \
       --build-env \
           BP_MAVEN_BUILT_MODULE=spring-petclinic-customers-service \
           BP_JVM_VERSION=17
   

3. Az alkalmazás létrehozásához és üzembe helyezéséhez használja a vets-service következő parancsot:

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_VETS_SERVICE} \
       --source-path \
       --config-file-pattern application,vets-service \
       --build-env \
           BP_MAVEN_BUILT_MODULE=spring-petclinic-vets-service \
           BP_JVM_VERSION=17
   

4. Az alkalmazás létrehozásához és üzembe helyezéséhez használja a visits-service következő parancsot:

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_VISITS_SERVICE} \
       --source-path \
       --config-file-pattern application,visits-service \
       --build-env \
           BP_MAVEN_BUILT_MODULE=spring-petclinic-visits-service \
           BP_JVM_VERSION=17
   

5. Az alkalmazások ellenőrzése

A következő szakaszok az üzembe helyezés ellenőrzésének módját ismertetik.

Azure Portalra

5.1. Az alkalmazások elérése

Az üzembe helyezés befejezése után a Spring Cloud Gateway URL-címét megtalálhatja az üzembehelyezési kimenetekből, ahogyan az alábbi képernyőképen látható:

Nyissa meg az átjáró URL-címét. Az alkalmazásnak az alábbi képernyőképhez hasonlóan kell kinéznie:

5.2. Az alkalmazásnaplók lekérdezése

A Pet Clinic egyes funkcióinak böngészése után a Log Analytics-munkaterület összegyűjti az egyes alkalmazások naplóit. A naplókat egyéni lekérdezésekkel ellenőrizheti, ahogyan az alábbi képernyőképen látható:

5.3. Az alkalmazások figyelése

Az alkalmazás-Elemzések figyeli az alkalmazás függőségeit, ahogy az alábbi alkalmazáskövetési térkép is mutatja:

Az alkalmazás élő nézetének URL-címét az üzembehelyezési kimenetekből találja. Nyissa meg az Alkalmazás élő nézet URL-címét az alkalmazás futtatókörnyezeteinek figyeléséhez, ahogyan az alábbi képernyőképen látható:

Azure Portal + Maven beépülő modul

5.1. Az alkalmazások elérése

Használja a Spring Cloud Gatewaytől hozzárendelt végpontot – például https://<your-Azure-Spring-Apps-instance-name>-gateway-xxxxx.svc.azuremicroservices.io. Az alkalmazásnak az alábbi képernyőképhez hasonlóan kell kinéznie:

5.2. Az alkalmazásnaplók lekérdezése

A Pet Clinic egyes funkcióinak böngészése után a Log Analytics-munkaterület összegyűjti az egyes alkalmazások naplóit. A naplókat egyéni lekérdezésekkel ellenőrizheti, ahogyan az alábbi képernyőképen látható:

5.3. Az alkalmazások figyelése

Az alkalmazás-Elemzések figyeli az alkalmazás függőségeit, ahogy az alábbi alkalmazáskövetési térkép is mutatja:

Nyissa meg a Fejlesztői eszközök által közzétett Application Live View URL-címet az alkalmazás futtatókörnyezeteinek monitorozásához, ahogyan az alábbi képernyőképen látható:

Azure CLI

5.1. Az alkalmazások elérése

A Spring Cloud Gateway URL-címének lekéréséhez használja az alábbi parancsokat:

export GATEWAY_URL=$(az spring gateway show \
    --service ${SPRING_APPS} \
    --query properties.url \
    --output tsv)
echo "https://${GATEWAY_URL}"

Az alkalmazásnak az alábbi képernyőképhez hasonlóan kell kinéznie:

5.2. Az alkalmazásnaplók lekérdezése

A Pet Clinic egyes funkcióinak böngészése után a Log Analytics-munkaterület összegyűjti az egyes alkalmazások naplóit. A naplókat egyéni lekérdezésekkel ellenőrizheti, ahogyan az alábbi képernyőképen látható:

5.3. Az alkalmazások figyelése

Az alkalmazás-Elemzések figyeli az alkalmazás függőségeit, ahogy az alábbi alkalmazáskövetési térkép is mutatja:

Az alkalmazás élő nézetének URL-címét az alábbi parancsokkal kérdezheti le:

export DEV_TOOL_URL=$(az spring dev-tool show \
    --service ${SPRING_APPS} \
    --query properties.url \
    --output tsv)
echo "https://${DEV_TOOL_URL}/app-live-view"

Nyissa meg az Alkalmazás élő nézet URL-címét az alkalmazás futtatókörnyezeteinek figyeléséhez, ahogyan az alábbi képernyőképen látható:

5.1. Az alkalmazások elérése

Az üzembehelyezési napló kimenetében található URL-adatok használatával nyissa meg a nevesített api-gateway alkalmazás által közzétett URL-címet , például https://<your-Azure-Spring-Apps-instance-name>-api-gateway.azuremicroservices.io. Az alkalmazásnak az alábbi képernyőképhez hasonlóan kell kinéznie:

5.2. Az alkalmazásnaplók lekérdezése

A Pet Clinic egyes funkcióinak böngészése után a Log Analytics-munkaterület összegyűjti az egyes alkalmazások naplóit. A naplókat egyéni lekérdezésekkel ellenőrizheti, ahogyan az alábbi képernyőképen látható:

5.3. Az alkalmazások figyelése

Az alkalmazás-Elemzések figyeli az alkalmazás függőségeit, ahogy az alábbi alkalmazáskövetési térkép is mutatja:

Nyissa meg az alkalmazás admin-server által közzétett URL-címet az alkalmazások Spring Boot Rendszergazda-kiszolgálón keresztüli kezeléséhez, ahogyan az alábbi képernyőképen látható:

6. Erőforrások tisztítása

Ha további rövid útmutatókkal és oktatóanyagokkal szeretne dolgozni, érdemes lehet ezeket az erőforrásokat a helyén hagyni. Ha már nincs szüksége az erőforrásokra, törölheti a felesleges erőforrásokat az Azure-díjak elkerülése érdekében.

Azure Portal + Maven beépülő modul

Az alábbi lépésekkel törölheti a teljes erőforráscsoportot, beleértve az újonnan létrehozott szolgáltatáspéldányt is:

1. Keresse meg az erőforráscsoportot az Azure Portalon. A navigációs menüben válassza az Erőforráscsoportok lehetőséget, majd válassza ki az erőforráscsoport nevét.

2. Az Erőforráscsoport lapon válassza a Törlés lehetőséget. A törlés megerősítéséhez írja be az erőforráscsoport nevét a szövegmezőbe, majd válassza a Törlés lehetőséget.

Azure Developer CLI

A mintaalkalmazásban használt összes Azure-erőforrás törléséhez használja a következő parancsot:

azd down

Az alábbi lista a parancsok közötti interakciót ismerteti:

• Összes törölni kívánt erőforrás: <resources-total>, biztos, hogy folytatni szeretné?: Nyomja le az y billentyűt.

A konzol az alábbi példához hasonló üzeneteket ad ki:

SUCCESS: Your application was removed from Azure in xx minutes xx seconds.

Mindenképpen törölje a cikkben létrehozott erőforrásokat, ha már nincs rájuk szüksége. Törölheti az Azure-erőforráscsoportot, amely tartalmazza az erőforráscsoportban lévő összes erőforrást.

Azure Portalra

A teljes erőforráscsoport törléséhez kövesse az alábbi lépéseket:

1. Keresse meg az erőforráscsoportot az Azure Portalon. A navigációs menüben válassza az Erőforráscsoportok lehetőséget, majd válassza ki az erőforráscsoport nevét.

2. Az Erőforráscsoport lapon válassza a Törlés lehetőséget. A törlés megerősítéséhez írja be az erőforráscsoport nevét a szövegmezőbe, majd válassza a Törlés lehetőséget.

Azure Portal + Maven beépülő modul

A teljes erőforráscsoport törléséhez kövesse az alábbi lépéseket:

1. Keresse meg az erőforráscsoportot az Azure Portalon. A navigációs menüben válassza az Erőforráscsoportok lehetőséget, majd válassza ki az erőforráscsoport nevét.

2. Az Erőforráscsoport lapon válassza a Törlés lehetőséget. A törlés megerősítéséhez írja be az erőforráscsoport nevét a szövegmezőbe, majd válassza a Törlés lehetőséget.

Azure CLI

Az erőforráscsoport törléséhez használja a következő parancsot:

az group delete --name ${RESOURCE_GROUP}

7. Következő lépések

Rövid útmutató: Az Azure Spring Apps integrálása az Azure Database for MySQL-hez

Az Azure Spring Apps CI/CD használata a GitHub Actions használatával

Alkalmazástelepítések automatizálása az Azure Spring Appsben

Strukturált alkalmazásnapló az Azure Spring Appshez

Felügyelt identitások használata alkalmazásokhoz az Azure Spring Appsben

Rövid útmutató: Log Analytics-munkaterület beállítása

Rövid útmutató: Azure Spring Apps-alkalmazások figyelése naplókkal, metrikákkal és nyomkövetéssel

Meglévő egyéni tartomány leképezése az Azure Spring Appsbe

Rövid útmutató: A mintaalkalmazás bemutatása

A Fitness Store mintaalkalmazás bemutatása

További információért tekintse át az alábbi cikkeket:

• Azure Pet Clinic mikroszolgáltatások
• Azure Spring Apps-minták
• Azure for Spring-fejlesztőknek
• A Spring Cloud Azure dokumentációja