Rövid útmutató: RESTful API-alkalmazás ü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 egy Microsoft Entra ID által védett RESTful API-alkalmazást az Azure Spring Appsben. A mintaprojekt a Simple Todo webalkalmazáson alapuló egyszerűsített verzió, amely csak a háttérszolgáltatást biztosítja, és a RESTful API-k védelméhez a Microsoft Entra ID-t használja.

Ezek a RESTful API-k szerepköralapú hozzáférés-vezérlés (RBAC) alkalmazásával védve vannak. A névtelen felhasználók nem férhetnek hozzá semmilyen adathoz, és nem szabályozhatják a különböző felhasználók hozzáférését. A névtelen felhasználók csak a következő három engedéllyel rendelkeznek:

• Olvasás: Ezzel az engedéllyel a felhasználó elolvashatja a ToDo-adatokat.
• Írás: Ezzel az engedéllyel a felhasználó hozzáadhatja vagy frissítheti a ToDo-adatokat.
• Törlés: Ezzel az engedéllyel a felhasználó törölheti a ToDo-adatokat.

Az üzembe helyezés sikeres befejezése után megtekintheti és tesztelheti az API-kat a Swagger felhasználói felületén keresztül.

Az alábbi ábra a rendszer architektúráját mutatja be:

Ez a cikk az alábbi lehetőségeket ismerteti az erőforrások létrehozásához és az Azure Spring Appsben való üzembe helyezéséhez:

• Az Azure Portal + Maven beépülő modullal hagyományosabb módon hozhat létre erőforrásokat, és lépésről lépésre üzembe helyezheti az alkalmazásokat. 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.

Ez a cikk az alábbi lehetőségeket ismerteti az erőforrások létrehozásához és az Azure Spring Appsben való üzembe helyezéséhez:

• Az Azure Portal + Maven beépülő modullal hagyományosabb módon hozhat létre erőforrásokat, és lépésről lépésre üzembe helyezheti az alkalmazásokat. 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.

1. Előfeltételek

Azure Portal + Maven beépülő modul

• Azure-előfizetés. Ha nem rendelkezik Azure-előfizetéssel, a kezdés előtt hozzon létre egy ingyenes Azure-fiókot .

• Az alábbi szerepkörök egyike:

  • Globális rendszergazda vagy Kiemelt szerepkörű rendszergazda, hozzájárulás megadásához, ha egy alkalmazás bármilyen engedélyt kér bármilyen API-hoz.
  • Cloud Application Rendszergazda istrator vagy Application Rendszergazda istrator, a Microsoft Graph-alkalmazásszerepkörök (alkalmazásengedélyek) kivételével, hozzájárulás megadásához bármely API-hoz engedélyt kérő alkalmazásokhoz.
  • Egy egyéni címtárszerepkör, amely tartalmazza az alkalmazások engedélyeinek megadására vonatkozó engedélyt az alkalmazás által igényelt engedélyekhez.

  További információ: Bérlőszintű rendszergazdai hozzájárulás megadása egy alkalmazáshoz.

• 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ó.

• Egy Microsoft Entra-bérlő. A létrehozással kapcsolatos utasításokért tekintse meg a rövid útmutatót: Új bérlő létrehozása a Microsoft Entra-azonosítóban.

Azure CLI

• Azure-előfizetés, Ha nem rendelkezik Azure-előfizetéssel, a kezdés előtt hozzon létre egy ingyenes Azure-fiókot .

• Az alábbi szerepkörök egyike:

  • Globális rendszergazda vagy Kiemelt szerepkörű rendszergazda, hozzájárulás megadásához, ha egy alkalmazás bármilyen engedélyt kér bármilyen API-hoz.
  • Cloud Application Rendszergazda istrator vagy Application Rendszergazda istrator, a Microsoft Graph-alkalmazásszerepkörök (alkalmazásengedélyek) kivételével, hozzájárulás megadásához bármely API-hoz engedélyt kérő alkalmazásokhoz.
  • Egy egyéni címtárszerepkör, amely tartalmazza az alkalmazások engedélyeinek megadására vonatkozó engedélyt az alkalmazás által igényelt engedélyekhez.

  További információ: Bérlőszintű rendszergazdai hozzájárulás megadása egy alkalmazáshoz.

• 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ó.

• Egy Microsoft Entra-bérlő. A létrehozással kapcsolatos utasításokért tekintse meg a rövid útmutatót: Új bérlő létrehozása a Microsoft Entra-azonosítóban.

• Az Azure CLI 2.53.1-es vagy újabb verziója.

Azure Portal + Maven beépülő modul

• Azure-előfizetés, Ha nem rendelkezik Azure-előfizetéssel, a kezdés előtt hozzon létre egy ingyenes Azure-fiókot .

• Az alábbi szerepkörök egyike:

  • Globális rendszergazda vagy Kiemelt szerepkörű rendszergazda, hozzájárulás megadásához, ha egy alkalmazás bármilyen engedélyt kér bármilyen API-hoz.
  • Cloud Application Rendszergazda istrator vagy Application Rendszergazda istrator, a Microsoft Graph-alkalmazásszerepkörök (alkalmazásengedélyek) kivételével, hozzájárulás megadásához bármely API-hoz engedélyt kérő alkalmazásokhoz.
  • Egy egyéni címtárszerepkör, amely tartalmazza az alkalmazások engedélyeinek megadására vonatkozó engedélyt az alkalmazás által igényelt engedélyekhez.

  További információ: Bérlőszintű rendszergazdai hozzájárulás megadása egy alkalmazáshoz.

• Git.

• Java Development Kit (JDK) 17-es verzió.

• Egy Microsoft Entra-bérlő. A létrehozással kapcsolatos utasításokért tekintse meg a rövid útmutatót: Új bérlő létrehozása a Microsoft Entra-azonosítóban.

Azure Developer CLI

• Azure-előfizetés, Ha nem rendelkezik Azure-előfizetéssel, a kezdés előtt hozzon létre egy ingyenes Azure-fiókot .

• Az alábbi szerepkörök egyike:

  • Globális rendszergazda vagy Kiemelt szerepkörű rendszergazda, hozzájárulás megadásához, ha egy alkalmazás bármilyen engedélyt kér bármilyen API-hoz.
  • Cloud Application Rendszergazda istrator vagy Application Rendszergazda istrator, a Microsoft Graph-alkalmazásszerepkörök (alkalmazásengedélyek) kivételével, hozzájárulás megadásához bármely API-hoz engedélyt kérő alkalmazásokhoz.
  • Egy egyéni címtárszerepkör, amely tartalmazza az alkalmazások engedélyeinek megadására vonatkozó engedélyt az alkalmazás által igényelt engedélyekhez.

  További információ: rendszergazdai hozzájárulás megadása.

• Git.

• Java Development Kit (JDK) 17-es verzió.

• Egy Microsoft Entra-bérlő. A létrehozással kapcsolatos utasításokért tekintse meg a rövid útmutatót: Új bérlő létrehozása a Microsoft Entra-azonosítóban.

• Az Azure Developer CLI (AZD) 1.0.2-es vagy újabb verziója.

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

A RESTful API-alkalmazás üzembe helyezéséhez az első lépés a Spring-projekt helyi futtatásának előkészítése.

Az alkalmazás helyi klónozásához és futtatásához kövesse az alábbi lépéseket:

1. Az alábbi paranccsal klónozza a mintaprojektet a GitHubról:

   git clone https://github.com/Azure-Samples/ASA-Samples-Restful-Application.git
   

2. Ha helyileg szeretné futtatni az alkalmazást, hajtsa végre a RESTful API-k közzététele és az alkalmazáskonfigurációs szakaszok frissítése című szakasz lépéseit, majd a következő paranccsal futtassa a mintaalkalmazást a Mavennel:

   cd ASA-Samples-Restful-Application
   ./mvnw spring-boot:run
   

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

A mintaalkalmazás futtatásához szükséges fő erőforrások egy Azure Spring Apps-példány és egy Azure Database for PostgreSQL-példány. A következő szakaszok ismertetik, hogyan hozhatja létre ezeket az erőforrásokat.

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

Azure Spring Apps-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 Alapismeretek űrlapot a következő információkkal:

   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.
   Terv	Vállalat	A példányhoz társított erőforrást és költséget meghatározó díjszabási csomag.
   Régió	A felhasználókhoz legközelebbi régió.	A felhasználókhoz legközelebb eső hely.
   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.
   Feltételek	Kiválasztott	A Marketplace-ajánlathoz társított szerződés jelölőnégyzete. Ezt a jelölőnégyzetet ki kell jelölnie.
   Mintaprojekt üzembe helyezése	Nincs kiválasztva	A beépített mintaalkalmazás használatának lehetősége.

4. 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.

5. 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.

   

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

3.3. A PostgreSQL-példány előkészítése

Az alábbi lépésekkel hozzon létre egy Azure Database for PostgreSQL-kiszolgálót:

1. Nyissa meg az Azure Portalt, és válassza az Erőforrás létrehozása lehetőséget.

2. Válassza az Adatbázisok>Azure Database for PostgreSQL lehetőséget.

3. Válassza a rugalmas kiszolgálótelepítési lehetőséget.

   

4. Töltse ki az Alapismeretek lapot a következő információkkal:

   • Kiszolgáló neve: my-demo-pgsql
   • Régió: USA keleti régiója
   • PostgreSQL-verzió: 14
   • Számítási feladat típusa: Fejlesztés
   • Magas rendelkezésre állás engedélyezése: nincs kiválasztva
   • Hitelesítési módszer: Csak PostgreSQL-hitelesítés
   • Rendszergazda felhasználónév: myadmin
   • Jelszó és jelszó megerősítése: Adjon meg egy jelszót.

5. A Hálózatkezelés lap konfigurálásához használja az alábbi információkat:

   • Csatlakozás ivity metódus: Nyilvános hozzáférés (engedélyezett IP-címek)
   • Nyilvános hozzáférés engedélyezése bármely Azure-szolgáltatásból ehhez a kiszolgálóhoz: kiválasztva

6. A kiválasztások áttekintéséhez válassza a Véleményezés + létrehozás lehetőséget, majd a Kiszolgáló kiépítéséhez válassza a Létrehozás lehetőséget . Ez a művelet eltarthat néhány percig.

7. Nyissa meg a PostgreSQL-kiszolgálót az Azure Portalon. Az Áttekintés lapon keresse meg a kiszolgálónév értékét, majd jegyezze fel későbbi használatra. Ehhez konfigurálnia kell az alkalmazás környezeti változóit az Azure Spring Appsben.

8. Adatbázis létrehozásához válassza az Adatbázisok lehetőséget a navigációs menüből – például teendő.

   

3.4. alkalmazáspéldány Csatlakozás PostgreSQL-példányba

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

1. Nyissa meg az Azure Spring Apps-példányt az Azure Portalon.

2. A navigációs menüben nyissa meg az Alkalmazások elemet, majd válassza az Alkalmazás létrehozása lehetőséget.

3. Az Alkalmazás létrehozása lapon adja meg a simple-todo-api alkalmazásnevet, majd válassza ki a Java-összetevőket üzembehelyezési típusként.

4. Válassza a Létrehozás lehetőséget az alkalmazás létrehozásának befejezéséhez, majd válassza ki az alkalmazást a részletek megtekintéséhez.

5. Nyissa meg az Azure Portalon létrehozott alkalmazást. Az Áttekintés lapon válassza a Végpont hozzárendelése lehetőséget az alkalmazás nyilvános végpontjának közzétételéhez. Mentse az URL-címet az alkalmazás eléréséhez az üzembe helyezés után.

6. Válassza a Szolgáltatás Csatlakozás or lehetőséget a navigációs panelen, majd válassza a Létrehozás lehetőséget egy új szolgáltatáskapcsolat létrehozásához.

   

7. Töltse ki az Alapismeretek lapot a következő információkkal:

   • Szolgáltatás típusa: rugalmas PostgreSQL-kiszolgáló adatbázisa
   • Csatlakozás ion név: A rendszer automatikusan generált nevet tölt fel, amely szintén módosítható.
   • Előfizetés: Válassza ki az előfizetését.
   • Rugalmas PostgreSQL-kiszolgáló: my-demo-pgsql
   • PostgreSQL-adatbázis: Válassza ki a létrehozott adatbázist.
   • Ügyfél típusa: SpringBoot

   

8. Konfigurálja a Következő: Hitelesítés lapot a következő információkkal:

   • Válassza ki a számítási szolgáltatás és a célszolgáltatás között használni kívánt hitelesítési típust. Válassza Csatlakozás ion sztringet.
   • Folytatás...: Adatbázis hitelesítő adatainak kiválasztása
   • Felhasználónév: myadmin
   • Jelszó: Adja meg a jelszavát.

   

9. Válassza a Tovább: Hálózatkezelés lehetőséget. A célszolgáltatáshoz való hozzáférés engedélyezéséhez használja az alapértelmezett tűzfalszabályok konfigurálása lehetőséget.

10. Válassza a Tovább elemet : Tekintse át a kijelöléseket, majd válassza a Létrehozás lehetőséget a kapcsolat létrehozásához.

3.5. RESTful API-k elérhetővé tétele

A RESTful API-k a Microsoft Entra-azonosítóban való közzétételéhez kövesse az alábbi lépéseket:

1. Jelentkezzen be az Azure Portalra.

2. Ha több bérlőhöz van hozzáférése, a Címtár + előfizetés szűrővel ( ) válassza ki azt a bérlőt, amelyben regisztrálni szeretne egy alkalmazást.

3. Keresse meg és válassza ki a Microsoft Entra ID-t.

4. A Kezelés területen válassza a Alkalmazásregisztrációk> New regisztráció lehetőséget.

5. Adja meg az alkalmazás nevét a Név mezőben – például Todo. Előfordulhat, hogy az alkalmazás felhasználói látják ezt a nevet, és később módosíthatja.

6. Támogatott fióktípusok esetén válassza a Bármely szervezeti könyvtárban (Bármely Microsoft Entra könyvtár – Több-bérlős) és a személyes Microsoft-fiókokban lévő Fiókok lehetőséget.

7. Válassza a Regisztráció elemet az alkalmazás létrehozásához.

8. Az Alkalmazás áttekintése lapon keresse meg az alkalmazás (ügyfél) azonosítójának értékét, majd jegyezze fel későbbi használatra. A projekt YAML-konfigurációs fájljának konfigurálásához szükség van rá.

9. A Kezelés területen válassza az API-k felfedése lehetőséget, keresse meg az alkalmazásazonosító URI-ját a lap elején, majd válassza a Hozzáadás lehetőséget.

10. Az alkalmazásazonosító URI-jának szerkesztése lapon fogadja el a javasolt alkalmazásazonosító URI-ját (api://{client ID}), vagy használjon az ügyfélazonosító helyett egy értelmes nevet, példáulapi://simple-todo, majd válassza a Mentés lehetőséget.

11. A Kezelés csoportban válassza az API-k>hatókör hozzáadása lehetőséget, majd adja meg a következő adatokat:

    • A Hatókör neve mezőbe írja be a ToDo.Read nevet.
    • A Ki tud hozzájárulni, csak a Rendszergazda válassza ki.
    • Ha Rendszergazda hozzájárulás megjelenítendő nevét szeretné megadni, írja be a ToDo-adatok olvasását.
    • A Rendszergazda hozzájárulás leírásához írja be a Hitelesített felhasználók számára a ToDo-adatok olvasását.
    • Állapot esetén hagyja engedélyezve.
    • Válassza a Hatókör hozzáadása lehetőséget.

12. Ismételje meg az előző lépéseket a másik két hatókör hozzáadásához: ToDo.Write és ToDo.Delete.

    

3.6. Az alkalmazáskonfiguráció frissítése

Az alábbi lépésekkel frissítheti a YAML-fájlt a Microsoft Entra által regisztrált alkalmazásadatok használatával a RESTful API-alkalmazással való kapcsolat létesítéséhez:

1. Keresse meg az alkalmazás src/main/resources/application.yml fájlját simple-todo-api . Frissítse a szakasz konfigurációját az spring.cloud.azure.active-directory alábbi példának megfelelően. Mindenképpen cserélje le a helyőrzőket a korábban létrehozott értékekre.

   spring:
     cloud:
       azure:
         active-directory:
           profile:
             tenant-id: <tenant>
           credential:
             client-id: <your-application-ID-of-ToDo>
           app-id-uri: <your-application-ID-URI-of-ToDo>
   

   Feljegyzés

   Az 1.0-s verziójú jogkivonatok esetében a konfigurációhoz az API ügyfél-azonosítója szükséges, míg a 2.0-s verziójú jogkivonatokban használhatja az ügyfél-azonosítót vagy az alkalmazásazonosító URI-ját a kérelemben. Mindkettőt konfigurálhatja úgy, hogy megfelelően végezze el a célközönség érvényesítését.

   Az engedélyezett tenant-id értékek a következők: common, organizations, consumersvagy a bérlőazonosító. Ezekről az értékekről további információt a AADSTS50020 – Az identitásszolgáltatótól származó felhasználói fiók nem létezik a bérlőben című hiba helytelen végpontja (személyes és szervezeti fiókok) című szakaszában talál. Az egybérlős alkalmazás konvertálásával kapcsolatos információkért lásd : Egybérlős alkalmazás átalakítása több-bérlőssé a Microsoft Entra-azonosítón.

2. A mintaprojekt újraépítéséhez használja a következő parancsot:

   ./mvnw clean package
   

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 RESOURCE_GROUP=myresourcegroup
export LOCATION=<location>
export POSTGRESQL_SERVER=my-demo-pgsql
export POSTGRESQL_DB=Todo
export POSTGRESQL_ADMIN_USERNAME=<admin-username>
export POSTGRESQL_ADMIN_PASSWORD=<admin-password>
export AZURE_SPRING_APPS_NAME=myasa
export APP_NAME=simple-todo-api
export TODO_APP_NAME=Todo
export TODO_APP_URL=api://simple-todo
export TODOWEB_APP_NAME=TodoWeb
export TODOWEB_APP_URL=api://simple-todoweb
export NEW_MEMBER_USERNAME=<new-member-username>
export NEW_MEMBER_PASSWORD=<new-member-password>
export USER_PRINCIPAL_NAME=<user-principal-name>

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

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

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

   az login
   

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

   az configure --defaults location=${LOCATION}
   

3. 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
   

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

   az account set --subscription <subscription-ID>
   

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

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

6. 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.3. 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.4. Azure Spring Apps-példány létrehozása

A következő lépésekkel hozzon létre egy szolgáltatáspéldányt és egy alkalmazást a példányban:

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. Az alábbi paranccsal hozzon létre egy Azure Spring Apps-szolgáltatáspéldányt:

   az spring create --name ${AZURE_SPRING_APPS_NAME} --sku enterprise
   

3. Az alábbi paranccsal hozzon létre egy alkalmazást az Azure Spring Apps-példányban:

   az spring app create \
       --service ${AZURE_SPRING_APPS_NAME} \
       --name ${APP_NAME} \
       --assign-endpoint true
   

3.5. A PostgreSQL-példány előkészítése

A Spring-webalkalmazás h2-t használ a localhost és az Azure Database for PostgreSQL adatbázisához az Azure-ban.

PostgreSQL-példány létrehozásához használja a következő parancsot:

az postgres flexible-server create \
    --name ${POSTGRESQL_SERVER} \
    --database-name ${POSTGRESQL_DB} \
    --admin-user ${POSTGRESQL_ADMIN_USERNAME} \
    --admin-password ${POSTGRESQL_ADMIN_PASSWORD} \
    --public-access 0.0.0.0

A beállítás 0.0.0.0 lehetővé teszi, hogy az Azure-ban üzembe helyezett erőforrások nyilvánosan hozzáférjenek a kiszolgálóhoz.

3.6. alkalmazáspéldány Csatlakozás PostgreSQL-példányba

Az alkalmazáspéldány és a PostgreSQL-példány létrehozása után az alkalmazáspéldány nem tud közvetlenül hozzáférni a PostgreSQL-példányhoz. Az alábbi lépésekkel engedélyezheti, hogy az alkalmazás csatlakozzon a PostgreSQL-példányhoz:

1. A PostgreSQL-példány teljes tartománynevének lekéréséhez használja a következő parancsot:

   export PSQL_FQDN=$(az postgres flexible-server show \
       --name ${POSTGRESQL_SERVER} \
       --query fullyQualifiedDomainName \
       --output tsv)
   

2. A következő paranccsal adja meg az spring.datasource. alkalmazás tulajdonságait környezeti változókon keresztül:

   az spring app update \
       --service ${AZURE_SPRING_APPS_NAME} \
       --name ${APP_NAME} \
       --env SPRING_DATASOURCE_URL="jdbc:postgresql://${PSQL_FQDN}:5432/${POSTGRESQL_DB}?sslmode=require" \
             SPRING_DATASOURCE_USERNAME="${POSTGRESQL_ADMIN_USERNAME}" \
             SPRING_DATASOURCE_PASSWORD="${POSTGRESQL_ADMIN_PASSWORD}"
   

3.7. RESTful API-k elérhetővé tétele

A RESTful API-k közzétételéhez kövesse az alábbi lépéseket:

1. Microsoft Entra ID-alkalmazás létrehozásához használja a következő parancsot:

   az ad app create \
       --display-name ${TODO_APP_NAME} \
       --sign-in-audience AzureADandPersonalMicrosoftAccount \
       --identifier-uris ${TODO_APP_URL}
   

2. Az alábbi paranccsal hozzon létre egy egyszerű szolgáltatást az alkalmazáshoz:

   az ad sp create --id ${TODO_APP_URL}
   

3. A következő paranccsal hozhat létre engedélyazonosítókat:

   permissionid1=$(uuidgen);permissionid2=$(uuidgen);permissionid3=$(uuidgen)
   

4. Adja hozzá a következő hatóköröket JSON-ként:

   api=$(echo '{
    "oauth2PermissionScopes": [
        {
            "adminConsentDescription": "Allows authenticated users to delete the ToDo data",
            "adminConsentDisplayName": "Delete the ToDo data",
            "id": "'$permissionid1'",
            "isEnabled": true,
            "type": "Admin",
            "userConsentDescription": null,
            "userConsentDisplayName": null,
            "value": "ToDo.Delete"
        },
   
        {
            "adminConsentDescription": "Allows authenticated users to write the ToDo data",
            "adminConsentDisplayName": "Write the ToDo data",
            "id": "'$permissionid2'",
            "isEnabled": true,
            "type": "Admin",
            "userConsentDescription": null,
            "userConsentDisplayName": null,
            "value": "ToDo.Write"
        },
        {
            "adminConsentDescription": "Allows authenticated users to read the ToDo data",
            "adminConsentDisplayName": "Read the ToDo data",
            "id": "'$permissionid3'",
            "isEnabled": true,
            "type": "Admin",
            "userConsentDescription": null,
            "userConsentDisplayName": null,
            "value": "ToDo.Read"
        }
    ]}')
   

5. Hatókörök hozzáadásához használja a következő parancsot:

   az ad app update \
       --id ${TODO_APP_URL} \
       --set api="$api"
   

6. A következő paranccsal kérje le a bérlőazonosítót a következő lépésben:

   az account show --query "tenantId" --output tsv
   

7. A következő paranccsal kérje le az alkalmazásazonosítót a következő lépésekben:

   appid=$(az ad app show \
       --id ${TODO_APP_URL} \
       --query appId \
       --output tsv);
   echo $appid
   

3.8. Az alkalmazáskonfiguráció frissítése

Az alábbi lépésekkel frissítheti a YAML-fájlt a Microsoft Entra által regisztrált alkalmazásadatok használatával a RESTful API-alkalmazással való kapcsolat létesítéséhez:

1. Keresse meg az alkalmazás src/main/resources/application.yml fájlját simple-todo-api . Frissítse a szakasz konfigurációját az spring.cloud.azure.active-directory alábbi példának megfelelően. Mindenképpen cserélje le a helyőrzőket a korábban létrehozott értékekre.

   spring:
     cloud:
       azure:
         active-directory:
           profile:
             tenant-id: <tenant>
           credential:
             client-id: <your-application-ID-of-ToDo>
           app-id-uri: <your-application-ID-URI-of-ToDo>
   

   Feljegyzés

   Az 1.0-s verziójú jogkivonatok esetében a konfigurációhoz az API ügyfél-azonosítója szükséges, míg a 2.0-s verziójú jogkivonatokban használhatja az ügyfél-azonosítót vagy az alkalmazásazonosító URI-ját a kérelemben. Mindkettőt konfigurálhatja úgy, hogy megfelelően végezze el a célközönség érvényesítését.

   Az engedélyezett tenant-id értékek a következők: common, organizations, consumersvagy a bérlőazonosító. Ezekről az értékekről további információt a AADSTS50020 – Az identitásszolgáltatótól származó felhasználói fiók nem létezik a bérlőben című hiba helytelen végpontja (személyes és szervezeti fiókok) című szakaszában talál. Az egybérlős alkalmazás konvertálásával kapcsolatos információkért lásd : Egybérlős alkalmazás átalakítása több-bérlőssé a Microsoft Entra-azonosítón.

2. A mintaprojekt újraépítéséhez használja a következő parancsot:

   ./mvnw clean package
   

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

Azure Portal + Maven beépülő modul

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

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 teljes könyvtárra, majd futtassa a következő parancsot az alkalmazás Azure Spring Appsben való konfigurálásához:

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

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

   • OAuth2-bejelentkezés: Engedélyeznie kell 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 .
   • 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 Üzembe helyezéshez az Azure Spring Appst: Válassza ki a létrehozott Azure Spring Apps-példány számát. Ha az alapértelmezett számot használja, nyomja le közvetlenül az Enter billentyűt .
   • Használja a meglévő alkalmazást az Azure Spring Appsben <a példánynévvel>: Nyomja le az y billentyűt a létrehozott alkalmazás használatá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. Az alkalmazás üzembe helyezéséhez használja a következő parancsot:

   ./mvnw azure-spring-apps:deploy
   

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

   • OAuth2-bejelentkezés: Engedélyeznie kell a bejelentkezést az Azure-ba az OAuth2 protokoll alapján.

   A parancs végrehajtása után a következő naplóüzenetekből láthatja, hogy az üzembe helyezés sikeres volt:

[INFO] Deployment Status: Running
[INFO]   InstanceName:simple-todo-api-default-15-xxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:N/A       
[INFO] Getting public url of app(simple-todo-api)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-simple-todo-api.azuremicroservices.io

Azure CLI

Az alkalmazás forráskódon alapuló üzembe helyezéséhez használja a következő parancsot:

az spring app deploy \
    --service ${AZURE_SPRING_APPS_NAME} \
    --name ${APP_NAME} \
    --build-env BP_JVM_VERSION=17 \
    --source-path .

5. Az alkalmazás ellenőrzése

Azure Portal + Maven beépülő modul

Most már hozzáférhet a RESTful API-hoz, hogy lássa, működik-e.

5.1. Hozzáférési jogkivonat kérése

A RESTful API-k erőforrás-kiszolgálóként működnek, amelyet a Microsoft Entra ID véd. A hozzáférési jogkivonat beszerzése előtt regisztrálnia kell egy másik alkalmazást a Microsoft Entra-azonosítóban, és engedélyeket kell adnia a névvel ellátott ToDoWebügyfélalkalmazásnak.

Az ügyfélalkalmazás regisztrálása

Az alábbi lépésekkel regisztrálhat egy alkalmazást a Microsoft Entra-azonosítóban, amely az alkalmazás engedélyeinek hozzáadására ToDo szolgál:

1. Jelentkezzen be az Azure Portalra.

2. Ha több bérlőhöz van hozzáférése, a Címtár + előfizetés szűrővel ( ) válassza ki azt a bérlőt, amelyben regisztrálni szeretne egy alkalmazást.

3. Keresse meg és válassza ki a Microsoft Entra ID-t.

4. A Kezelés területen válassza a Alkalmazásregisztrációk> New regisztráció lehetőséget.

5. Adja meg az alkalmazás nevét a Név mezőben – például ToDoWeb. Előfordulhat, hogy az alkalmazás felhasználói látják ezt a nevet, és később módosíthatja.

6. Támogatott fióktípusok esetén csak ebben a szervezeti címtárban használja a Fiókok alapértelmezett értékét.

7. Válassza a Regisztráció elemet az alkalmazás létrehozásához.

8. Az Alkalmazás áttekintése lapon keresse meg az alkalmazás (ügyfél) azonosítójának értékét, majd jegyezze fel későbbi használatra. Szüksége van rá egy hozzáférési jogkivonat beszerzéséhez.

9. Válassza az API-engedélyeket>: Engedély>hozzáadása Saját API-k. Jelölje ki a ToDo korábban regisztrált alkalmazást, majd válassza a ToDo.Read, a ToDo.Write és a ToDo.Delete engedélyeket. Jelölje be az Engedélyek hozzáadása lehetőséget.

10. Válassza a Rendszergazdai hozzájárulás megadása a bérlői névhez <> lehetőséget a rendszergazdai hozzájárulás megadásához a hozzáadott engedélyekhez.

    

Felhasználó hozzáadása a RESTful API-k eléréséhez

Az alábbi lépésekkel tagfelhasználót hozhat létre a Microsoft Entra-bérlőben. Ezután a felhasználó RESTful API-kkal kezelheti az ToDo alkalmazás adatait.

1. A Kezelés csoportban válassza a Felhasználók>új felhasználó új felhasználó> létrehozása lehetőséget.

2. Az Új felhasználó létrehozása lapon adja meg a következő adatokat:

   • Egyszerű felhasználónév: Adja meg a felhasználó nevét.
   • Megjelenítendő név: Adja meg a felhasználó megjelenítendő nevét.
   • Jelszó: Másolja ki a Jelszó mezőben megadott automatikus jelszót.

   Feljegyzés

   Az új felhasználóknak be kell fejezniük az első bejelentkezési hitelesítést, és frissíteniük kell a jelszavukat, ellenkező esetben hibaüzenet jelenik AADSTS50055: The password is expired meg a hozzáférési jogkivonat beszerzésekor.

   Amikor egy új felhasználó bejelentkezik, megjelenik egy kötelező művelet. A Későbbi kérés lehetőséget választva kihagyhatják az érvényesítést.

3. Válassza a Véleményezés + létrehozás lehetőséget a kijelölések áttekintéséhez. Válassza a Létrehozás lehetőséget a felhasználó létrehozásához.

Az OAuth2 konfigurációjának frissítése a Swagger felhasználói felületének engedélyezéséhez

Az alábbi lépésekkel frissítheti az OAuth2 konfigurációját a Swagger felhasználói felületének engedélyezéséhez. Ezután engedélyezheti a felhasználóknak, hogy hozzáférési jogkivonatokat szerezzenek be az ToDoWeb alkalmazáson keresztül.

1. Nyissa meg a Microsoft Entra ID-bérlőt az Azure Portalon, és nyissa meg a regisztrált ToDoWeb alkalmazást.

2. A Kezelés területen válassza a Hitelesítés lehetőséget, válassza a Platform hozzáadása, majd az Egyoldalas alkalmazás lehetőséget.

3. Használja a formátumot <your-app-exposed-application-URL-or-endpoint>/swagger-ui/oauth2-redirect.html OAuth2 átirányítási URL-címként az Átirányítási URI-k mezőben, majd válassza a Konfigurálás lehetőséget.

   

Azure CLI

Most már hozzáférhet a RESTful API-hoz, hogy lássa, működik-e.

5.1. Hozzáférési jogkivonat kérése

A RESTful API-k erőforrás-kiszolgálóként működnek, amelyet a Microsoft Entra ID véd. A hozzáférési jogkivonat beszerzése előtt regisztrálnia kell egy másik alkalmazást a Microsoft Entra-azonosítóban, és engedélyeket kell adnia a névvel ellátott ToDoWebügyfélalkalmazásnak.

Az ügyfélalkalmazás regisztrálása

Az ügyfélalkalmazás regisztrálásához kövesse az alábbi lépéseket:

1. Az alábbi paranccsal hozzon létre egy Microsoft Entra ID-alkalmazást, amely az alkalmazás engedélyeinek hozzáadására ToDo szolgál:

   az ad app create \
       --display-name ${TODOWEB_APP_NAME} \
       --sign-in-audience AzureADMyOrg \
       --identifier-uris ${TODOWEB_APP_URL}
   

2. Engedélyek hozzáadásához használja a következő parancsot:

   az ad app permission add \
       --id api://simple-todowebtest2 \
       --api $appid \
       --api-permissions $permissionid1=Scope $permissionid2=Scope $permissionid3=Scope
   

3. A következő paranccsal adjon rendszergazdai hozzájárulást a hozzáadott engedélyekhez:

   az ad app permission admin-consent --id ${TODOWEB_APP_URL}
   

4. A hozzáférési jogkivonat beszerzése lépésben használt alkalmazás ügyfélazonosítójának lekéréséhez ToDoWeb használja a következő parancsot:

   az ad app show \
       --id ${TODOWEB_APP_URL} \
       --query appId \
       --output tsv
   

Felhasználó hozzáadása a RESTful API-k eléréséhez

Az alábbi paranccsal hozzon létre egy tagfelhasználót a Microsoft Entra-bérlőben. Ezután a felhasználó RESTful API-kkal kezelheti az ToDo alkalmazás adatait:

az ad user create \
    --display-name ${NEW_MEMBER_USERNAME} \
    --password ${NEW_MEMBER_PASSWORD} \
    --user-principal-name ${USER_PRINCIPAL_NAME}

Az OAuth2 konfigurációjának frissítése a Swagger felhasználói felületének engedélyezéséhez

Az OAuth2-konfiguráció frissítéséhez kövesse az alábbi lépéseket:

1. Az alkalmazás objektumazonosítójának lekéréséhez használja a ToDoWeb következő parancsot:

   az ad app show --id ${TODOWEB_APP_URL} --query id
   

2. Az alkalmazás URL-címének lekéréséhez simple-todo-api használja a következő parancsot:

   az spring app show \
       --name ${APP_NAME} \
       --service ${AZURE_SPRING_APPS_NAME} \
       --query properties.url
   

3. Az alábbi paranccsal frissítse a Swagger felhasználói felületének engedélyezéséhez szükséges OAuth2-konfigurációt, és <URL> cserélje le a <object-id> helyőrzőket a kapott paraméterértékekre. Ezután engedélyezheti a felhasználóknak, hogy hozzáférési jogkivonatokat szerezzenek be az ToDoWeb alkalmazáson keresztül.

   az rest \
       --method PATCH \
       --uri "https://graph.microsoft.com/v1.0/applications/<object-id>" \
       --headers 'Content-Type=application/json' \
       --body '{"spa":{"redirectUris":["<URL>/swagger-ui/oauth2-redirect.html"]}}'
   

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

A RESTful API-alkalmazás üzembe helyezéséhez az első lépés a Spring-projekt helyi futtatásának előkészítése.

Azure Portal + Maven beépülő modul

Az alkalmazás helyi klónozásához és futtatásához kövesse az alábbi lépéseket:

1. Az alábbi paranccsal klónozza a mintaprojektet a GitHubról:

   git clone https://github.com/Azure-Samples/ASA-Samples-Restful-Application.git
   

2. Ha helyileg szeretné futtatni az alkalmazást, hajtsa végre a RESTful API-k közzététele és az alkalmazáskonfigurációs szakaszok frissítése című szakasz lépéseit, majd a következő paranccsal futtassa a mintaalkalmazást a Mavennel:

   cd ASA-Samples-Restful-Application
   ./mvnw spring-boot:run
   

Azure Developer CLI

Az alábbi lépésekkel inicializálhatja a webalkalmazást az Azure Developer CLI-sablonokból:

1. Nyisson meg egy terminált, hozzon létre egy új üres mappát, majd módosítsa rá a könyvtárat.

2. Futtassa a következő parancsot a projekt inicializálásához:

   azd init --template Azure-Samples/ASA-Samples-Restful-Application
   

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

   • OAuth2-bejelentkezés: Engedélyeznie kell a bejelentkezést az Azure-ba az OAuth2 protokoll alapján.
   • Adjon meg egy új környezetnevet: Adjon meg egy környezetnevet. Ez a név az összes Azure-erőforrás tárolására létrehozott erőforráscsoport utótagjaként használatos. 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

A mintaalkalmazás futtatásához szükséges fő erőforrások egy Azure Spring Apps-példány és egy Azure Database for PostgreSQL-példány. A következő szakaszok ismertetik, hogyan hozhatja létre ezeket az erőforrásokat.

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 következő lépésekkel hozhat létre egy szolgáltatáspéldányt:

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

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

3. Töltse ki az Alapismeretek űrlapot. Az űrlap kitöltéséhez használja az alábbi táblázatot útmutatóként. Az ajánlott csomagérték a Standard consumption > dedikált (előzetes verzió).

   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.
   Terv	Standard felhasználás > dedikált (előzetes verzió)	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.
   Container Apps-környezet	myenvironment	Kiválaszthatja, hogy melyik Container Apps-környezetpéldányt szeretné megosztani ugyanazzal a virtuális hálózattal más szolgáltatásokkal és erőforrásokkal.

   A Container Apps-környezet létrehozásának útmutatójaként használja az alábbi táblázatot:

   Beállítás	Ajánlott érték	Leírás
   Környezet neve	myenvironment	Egyedi név, amely azonosítja az Azure Container Apps Environment szolgáltatást.
   Terv	Fogyasztás	A tarifacsomag határozza meg a példányhoz társított erőforrásokat és költségeket.
   Zónaredundáns	Disabled (Letiltva)	A Container Apps Environment szolgáltatás azure-beli rendelkezésre állási zónában való létrehozásának lehetősége.

4. 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.

5. 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.

6. Válassza az Ugrás az erőforrásra lehetőséget a szolgáltatás Áttekintés lapjának megnyitásához.

   

Fontos

A használatalapú számítási feladatok profilja használatalapú számlázási modellel rendelkezik, kezdő költség nélkül. A kiosztott erőforrások alapján a dedikált számítási feladatprofilért kell fizetnie. További információ: Számítási feladatok profiljai az Azure Container Appsben és az Azure Spring Apps díjszabásában.

3.3. A PostgreSQL-példány előkészítése

Az alábbi lépésekkel hozzon létre egy Azure Database for PostgreSQL-kiszolgálót:

1. Nyissa meg az Azure Portalt, és válassza az Erőforrás létrehozása lehetőséget.

2. Válassza az Adatbázisok>Azure Database for PostgreSQL lehetőséget.

3. Válassza a rugalmas kiszolgálótelepítési lehetőséget.

   

4. Töltse ki az Alapismeretek lapot a következő információkkal:

   • Kiszolgáló neve: my-demo-pgsql
   • Régió: USA keleti régiója
   • PostgreSQL-verzió: 14
   • Számítási feladat típusa: Fejlesztés
   • Magas rendelkezésre állás engedélyezése: nincs kiválasztva
   • Hitelesítési módszer: Csak PostgreSQL-hitelesítés
   • Rendszergazda felhasználónév: myadmin
   • Jelszó és jelszó megerősítése: Adjon meg egy jelszót.

5. A Hálózatkezelés lap konfigurálásához használja az alábbi információkat:

   • Csatlakozás ivity metódus: Nyilvános hozzáférés (engedélyezett IP-címek)
   • Nyilvános hozzáférés engedélyezése bármely Azure-szolgáltatásból ehhez a kiszolgálóhoz: kiválasztva

6. A kiválasztások áttekintéséhez válassza a Véleményezés + létrehozás lehetőséget, majd a Kiszolgáló kiépítéséhez válassza a Létrehozás lehetőséget . Ez a művelet eltarthat néhány percig.

7. Nyissa meg a PostgreSQL-kiszolgálót az Azure Portalon. Az Áttekintés lapon keresse meg a kiszolgálónév értékét, majd jegyezze fel későbbi használatra. Ehhez konfigurálnia kell az alkalmazás környezeti változóit az Azure Spring Appsben.

8. Adatbázis létrehozásához válassza az Adatbázisok lehetőséget a navigációs menüből – például teendő.

   

3.4. alkalmazáspéldány Csatlakozás PostgreSQL-példányba

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

1. Nyissa meg az Azure Spring Apps-példányt az Azure Portalon.

2. A navigációs menüben nyissa meg az Alkalmazások elemet, majd válassza az Alkalmazás létrehozása lehetőséget.

3. Az Alkalmazás létrehozása lapon adja meg a simple-todo-api alkalmazásnevet, és válassza ki a Java-összetevőket üzembe helyezési típusként.

4. Kattintson a Létrehozás gombra az alkalmazás létrehozásának befejezéséhez, majd válassza ki az alkalmazást a részletek megtekintéséhez.

5. Nyissa meg az Azure Portalon létrehozott alkalmazást. Az Áttekintés lapon válassza a Végpont hozzárendelése lehetőséget az alkalmazás nyilvános végpontjának közzétételéhez. Mentse az URL-címet az alkalmazás eléréséhez az üzembe helyezés után.

6. Nyissa meg a létrehozott alkalmazást, bontsa ki a Gépház és válassza a Konfiguráció lehetőséget a navigációs menüből, majd válassza a Környezeti változók lehetőséget a környezeti változók beállításához.

7. Adja hozzá a következő környezeti változókat a PostgreSQL-kapcsolathoz, majd a Mentés gombra kattintva fejezze be az alkalmazáskonfiguráció frissítését. Mindenképpen cserélje le a helyőrzőket a korábban létrehozott saját értékekre.

   Környezeti változó	Érték
   SPRING_DATASOURCE_URL	jdbc:postgresql://<your-PostgreSQL-server-name>:5432/<your-PostgreSQL-database-name>
   SPRING_DATASOURCE_USERNAME	<your-PostgreSQL-admin-user>
   SPRING_DATASOURCE_PASSWORD	<your-PostgreSQL-admin-password>

   

3.5. RESTful API-k elérhetővé tétele

A RESTful API-k a Microsoft Entra-azonosítóban való közzétételéhez kövesse az alábbi lépéseket:

1. Jelentkezzen be az Azure Portalra.

2. Ha több bérlőhöz van hozzáférése, a Címtár + előfizetés szűrővel ( ) válassza ki azt a bérlőt, amelyben regisztrálni szeretne egy alkalmazást.

3. Keresse meg és válassza ki a Microsoft Entra ID-t.

4. A Kezelés területen válassza a Alkalmazásregisztrációk> New regisztráció lehetőséget.

5. Adja meg az alkalmazás nevét a Név mezőben – például Todo. Előfordulhat, hogy az alkalmazás felhasználói látják ezt a nevet, és később módosíthatja.

6. Támogatott fióktípusok esetén válassza a Bármely szervezeti könyvtárban (Bármely Microsoft Entra könyvtár – Több-bérlős) és a személyes Microsoft-fiókokban lévő Fiókok lehetőséget.

7. Válassza a Regisztráció elemet az alkalmazás létrehozásához.

8. Az Alkalmazás áttekintése lapon keresse meg az alkalmazás (ügyfél) azonosítójának értékét, majd jegyezze fel későbbi használatra. A projekt YAML-konfigurációs fájljának konfigurálásához szükség van rá.

9. A Kezelés területen válassza az API-k felfedése lehetőséget, keresse meg az alkalmazásazonosító URI-ját a lap elején, majd válassza a Hozzáadás lehetőséget.

10. Az alkalmazásazonosító URI-jának szerkesztése lapon fogadja el a javasolt alkalmazásazonosító URI-ját (api://{client ID}), vagy használjon az ügyfélazonosító helyett egy értelmes nevet, példáulapi://simple-todo, majd válassza a Mentés lehetőséget.

11. A Kezelés csoportban válassza az API-k>hatókör hozzáadása lehetőséget, majd adja meg a következő adatokat:

    • A Hatókör neve mezőbe írja be a ToDo.Read nevet.
    • A Ki tud hozzájárulni, csak a Rendszergazda válassza ki.
    • Ha Rendszergazda hozzájárulás megjelenítendő nevét szeretné megadni, írja be a ToDo-adatok olvasását.
    • A Rendszergazda hozzájárulás leírásához írja be a Hitelesített felhasználók számára a ToDo-adatok olvasását.
    • Állapot esetén hagyja engedélyezve.
    • Válassza a Hatókör hozzáadása lehetőséget.

12. Ismételje meg az előző lépéseket a másik két hatókör hozzáadásához: ToDo.Write és ToDo.Delete.

    

3.6. Az alkalmazáskonfiguráció frissítése

Az alábbi lépésekkel frissítheti a YAML-fájlt a Microsoft Entra által regisztrált alkalmazásadatok használatával a RESTful API-alkalmazással való kapcsolat létesítéséhez:

1. Keresse meg az alkalmazás src/main/resources/application.yml fájlját simple-todo-api . Frissítse a szakasz konfigurációját az spring.cloud.azure.active-directory alábbi példának megfelelően. Mindenképpen cserélje le a helyőrzőket a korábban létrehozott értékekre.

   spring:
     cloud:
       azure:
         active-directory:
           profile:
             tenant-id: <tenant>
           credential:
             client-id: <your-application-ID-of-ToDo>
           app-id-uri: <your-application-ID-URI-of-ToDo>
   

   Feljegyzés

   Az 1.0-s verziójú jogkivonatok esetében a konfigurációhoz az API ügyfél-azonosítója szükséges, míg a 2.0-s verziójú jogkivonatokban használhatja az ügyfél-azonosítót vagy az alkalmazásazonosító URI-ját a kérelemben. Mindkettőt konfigurálhatja úgy, hogy megfelelően végezze el a célközönség érvényesítését.

   Az engedélyezett tenant-id értékek a következők: common, organizations, consumersvagy a bérlőazonosító. Ezekről az értékekről további információt a AADSTS50020 – Az identitásszolgáltatótól származó felhasználói fiók nem létezik a bérlőben című hiba helytelen végpontja (személyes és szervezeti fiókok) című szakaszában talál. Az egybérlős alkalmazás konvertálásával kapcsolatos információkért lásd : Egybérlős alkalmazás átalakítása több-bérlőssé a Microsoft Entra-azonosítón.

2. A mintaprojekt újraépítéséhez használja a következő parancsot:

   ./mvnw clean package
   

Azure Developer CLI

3.1. Az Azure-erőforrások előkészítése

A szükséges Azure-erőforrások kiépítéséhez kövesse az alábbi lépéseket:

1. Futtassa az alábbi parancsot az Azure-ba való bejelentkezéshez az OAuth2 használatával. Ha már bejelentkezett, hagyja figyelmen kívül ezt a lépést.

   azd auth login
   

2. Futtassa a következő parancsot az Azure Spring Apps szolgáltatás engedélyezéséhez:

   azd config set alpha.springapp on
   

3. Futtassa a következő parancsot az alkalmazás üzembe helyezhető másolatának csomagolásához, a sablon infrastruktúrájának az Azure-ba való üzembe helyezéséhez, valamint az alkalmazáskód üzembe helyezéséhez az újonnan kiépített erőforrásokra:

   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/<your-resource-group>/overview
   

   Feljegyzés

   A parancs végrehajtása eltarthat egy ideig. Az Azure-erőforrások üzembe helyezésekor megjelenik egy előrehaladási mutató.

3.2. RESTful API-k elérhetővé tétele

A RESTful API-k a Microsoft Entra-azonosítóban való közzétételéhez kövesse az alábbi lépéseket:

1. Jelentkezzen be az Azure Portalra.

2. Ha több bérlőhöz van hozzáférése, a Címtár + előfizetés szűrővel ( ) válassza ki azt a bérlőt, amelyben regisztrálni szeretne egy alkalmazást.

3. Keresse meg és válassza ki a Microsoft Entra ID-t.

4. A Kezelés területen válassza a Alkalmazásregisztrációk> New regisztráció lehetőséget.

5. Adja meg az alkalmazás nevét a Név mezőben – például Todo. Előfordulhat, hogy az alkalmazás felhasználói látják ezt a nevet, és később módosíthatja.

6. Támogatott fióktípusok esetén válassza a Bármely szervezeti könyvtárban (Bármely Microsoft Entra könyvtár – Több-bérlős) és a személyes Microsoft-fiókokban lévő Fiókok lehetőséget.

7. Válassza a Regisztráció elemet az alkalmazás létrehozásához.

8. Az Alkalmazás áttekintése lapon keresse meg az alkalmazás (ügyfél) azonosítójának értékét, majd jegyezze fel későbbi használatra. A projekt YAML-konfigurációs fájljának konfigurálásához szükség van rá.

9. A Kezelés területen válassza az API-k felfedése lehetőséget, keresse meg az alkalmazásazonosító URI-ját a lap elején, majd válassza a Hozzáadás lehetőséget.

10. Az alkalmazásazonosító URI-jának szerkesztése lapon fogadja el a javasolt alkalmazásazonosító URI-ját (api://{client ID}), vagy használjon az ügyfélazonosító helyett egy értelmes nevet, példáulapi://simple-todo, majd válassza a Mentés lehetőséget.

11. A Kezelés csoportban válassza az API-k>hatókör hozzáadása lehetőséget, majd adja meg a következő adatokat:

    • A Hatókör neve mezőbe írja be a ToDo.Read nevet.
    • A Ki tud hozzájárulni, csak a Rendszergazda válassza ki.
    • Ha Rendszergazda hozzájárulás megjelenítendő nevét szeretné megadni, írja be a ToDo-adatok olvasását.
    • A Rendszergazda hozzájárulás leírásához írja be a Hitelesített felhasználók számára a ToDo-adatok olvasását.
    • Állapot esetén hagyja engedélyezve.
    • Válassza a Hatókör hozzáadása lehetőséget.

12. Ismételje meg az előző lépéseket a másik két hatókör hozzáadásához: ToDo.Write és ToDo.Delete.

    

3.3. Az alkalmazáskonfiguráció frissítése

Az alábbi lépésekkel frissítheti a YAML-fájlt a Microsoft Entra által regisztrált alkalmazásadatok használatával a RESTful API-alkalmazással való kapcsolat létesítéséhez:

1. Keresse meg az alkalmazás src/main/resources/application.yml fájlját simple-todo-api . Frissítse a szakasz konfigurációját az spring.cloud.azure.active-directory alábbi példának megfelelően. Mindenképpen cserélje le a helyőrzőket a korábban létrehozott értékekre.

   spring:
     cloud:
       azure:
         active-directory:
           profile:
             tenant-id: <tenant>
           credential:
             client-id: <your-application-ID-of-ToDo>
           app-id-uri: <your-application-ID-URI-of-ToDo>
   

   Feljegyzés

   Az 1.0-s verziójú jogkivonatok esetében a konfigurációhoz az API ügyfél-azonosítója szükséges, míg a 2.0-s verziójú jogkivonatokban használhatja az ügyfél-azonosítót vagy az alkalmazásazonosító URI-ját a kérelemben. Mindkettőt konfigurálhatja úgy, hogy megfelelően végezze el a célközönség érvényesítését.

   Az engedélyezett tenant-id értékek a következők: common, organizations, consumersvagy a bérlőazonosító. Ezekről az értékekről további információt a AADSTS50020 – Az identitásszolgáltatótól származó felhasználói fiók nem létezik a bérlőben című hiba helytelen végpontja (személyes és szervezeti fiókok) című szakaszában talál. Az egybérlős alkalmazás konvertálásával kapcsolatos információkért lásd : Egybérlős alkalmazás átalakítása több-bérlőssé a Microsoft Entra-azonosítón.

2. A mintaprojekt újraépítéséhez használja a következő parancsot:

   ./mvnw clean package
   

4. Az alkalmazás ü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

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 teljes könyvtárra, majd futtassa a következő parancsot az alkalmazás Azure Spring Appsben való konfigurálásához:

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

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

   • OAuth2-bejelentkezés: Engedélyeznie kell 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 .
   • 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 Üzembe helyezéshez az Azure Spring Appst: Válassza ki a létrehozott Azure Spring Apps-példány számát. Ha az alapértelmezett számot használja, nyomja le közvetlenül az Enter billentyűt .
   • Használja a meglévő alkalmazást az Azure Spring Appsben <a példánynévvel>: Nyomja le az y billentyűt a létrehozott alkalmazás használatá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. Az alkalmazás üzembe helyezéséhez használja a következő parancsot:

   ./mvnw azure-spring-apps:deploy
   

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

   • OAuth2-bejelentkezés: Engedélyeznie kell a bejelentkezést az Azure-ba az OAuth2 protokoll alapján.

   A parancs végrehajtása után a következő naplóüzenetekből láthatja, hogy az üzembe helyezés sikeres volt:

[INFO] Deployment(default) is successfully created
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
[INFO]   InstanceName:demo--default-xxxxxxx-xxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:NONE
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://demo.<unique-identifier>.<region-name>.azurecontainerapps.io

Azure Developer CLI

Az alábbi lépésekkel csomagolhatja az alkalmazást, kiépítheti a webalkalmazáshoz szükséges Azure-erőforrásokat, majd üzembe helyezheti az Azure Spring Appsben.

1. Futtassa a következő parancsot az alkalmazás üzembe helyezhető másolatának csomagolásához:

   azd package
   

2. Futtassa a következő parancsot az alkalmazáskód üzembe helyezéséhez 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)
   
   WARNING: Feature 'springapp' is in alpha stage.
   To learn more about alpha features and their support, visit https://aka.ms/azd-feature-stages.
   
   ...
   
   Deploying service simple-todo-api (Fetching endpoints for spring app service)
   - Endpoint: https://simple-todo-api.xxxxxxxx-xxxxxxxx.xxxxxx.azurecontainerapps.io
   
   
   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
   

   A kimeneti végpont az alapvégpont a ToDo API-alkalmazás eléréséhez.

Feljegyzés

Az előző három parancs kombinálására is használható azd up : azd provision (Azure-erőforrások kikötése), azd package (az alkalmazás üzembe helyezhető másolatának csomagja) és azd deploy (az alkalmazás kódjának üzembe helyezése). További információ: Azure-Samples/ASA-Samples-Restful-Application.

5. Az alkalmazás ellenőrzése

Most már hozzáférhet a RESTful API-hoz, hogy lássa, működik-e.

5.1. Hozzáférési jogkivonat kérése

A RESTful API-k erőforrás-kiszolgálóként működnek, amelyet a Microsoft Entra ID véd. A hozzáférési jogkivonat beszerzése előtt regisztrálnia kell egy másik alkalmazást a Microsoft Entra-azonosítóban, és engedélyeket kell adnia a névvel ellátott ToDoWebügyfélalkalmazásnak.

Az ügyfélalkalmazás regisztrálása

Az alábbi lépésekkel regisztrálhat egy alkalmazást a Microsoft Entra-azonosítóban, amely az alkalmazás engedélyeinek hozzáadására ToDo szolgál:

1. Jelentkezzen be az Azure Portalra.

2. Ha több bérlőhöz van hozzáférése, a Címtár + előfizetés szűrővel ( ) válassza ki azt a bérlőt, amelyben regisztrálni szeretne egy alkalmazást.

3. Keresse meg és válassza ki a Microsoft Entra ID-t.

4. A Kezelés területen válassza a Alkalmazásregisztrációk> New regisztráció lehetőséget.

5. Adja meg az alkalmazás nevét a Név mezőben – például ToDoWeb. Előfordulhat, hogy az alkalmazás felhasználói látják ezt a nevet, és később módosíthatja.

6. Támogatott fióktípusok esetén csak ebben a szervezeti címtárban használja a Fiókok alapértelmezett értékét.

7. Válassza a Regisztráció elemet az alkalmazás létrehozásához.

8. Az Alkalmazás áttekintése lapon keresse meg az alkalmazás (ügyfél) azonosítójának értékét, majd jegyezze fel későbbi használatra. Szüksége van rá egy hozzáférési jogkivonat beszerzéséhez.

9. Válassza az API-engedélyeket>: Engedély>hozzáadása Saját API-k. Jelölje ki a ToDo korábban regisztrált alkalmazást, majd válassza a ToDo.Read, a ToDo.Write és a ToDo.Delete engedélyeket. Jelölje be az Engedélyek hozzáadása lehetőséget.

10. Válassza a Rendszergazdai hozzájárulás megadása a bérlői névhez <> lehetőséget a rendszergazdai hozzájárulás megadásához a hozzáadott engedélyekhez.

    

Felhasználó hozzáadása a RESTful API-k eléréséhez

Az alábbi lépésekkel tagfelhasználót hozhat létre a Microsoft Entra-bérlőben. Ezután a felhasználó RESTful API-kkal kezelheti az ToDo alkalmazás adatait.

1. A Kezelés csoportban válassza a Felhasználók>új felhasználó új felhasználó> létrehozása lehetőséget.

2. Az Új felhasználó létrehozása lapon adja meg a következő adatokat:

   • Egyszerű felhasználónév: Adja meg a felhasználó nevét.
   • Megjelenítendő név: Adja meg a felhasználó megjelenítendő nevét.
   • Jelszó: Másolja ki a Jelszó mezőben megadott automatikus jelszót.

   Feljegyzés

   Az új felhasználóknak be kell fejezniük az első bejelentkezési hitelesítést, és frissíteniük kell a jelszavukat, ellenkező esetben hibaüzenet jelenik AADSTS50055: The password is expired meg a hozzáférési jogkivonat beszerzésekor.

   Amikor egy új felhasználó bejelentkezik, megjelenik egy kötelező művelet. A Későbbi kérés lehetőséget választva kihagyhatják az érvényesítést.

3. Válassza a Véleményezés + létrehozás lehetőséget a kijelölések áttekintéséhez. Válassza a Létrehozás lehetőséget a felhasználó létrehozásához.

Az OAuth2 konfigurációjának frissítése a Swagger felhasználói felületének engedélyezéséhez

Az alábbi lépésekkel frissítheti az OAuth2 konfigurációját a Swagger felhasználói felületének engedélyezéséhez. Ezután engedélyezheti a felhasználóknak, hogy hozzáférési jogkivonatokat szerezzenek be az ToDoWeb alkalmazáson keresztül.

1. Nyissa meg a Microsoft Entra ID-bérlőt az Azure Portalon, és nyissa meg a regisztrált ToDoWeb alkalmazást.

2. A Kezelés területen válassza a Hitelesítés lehetőséget, válassza a Platform hozzáadása, majd az Egyoldalas alkalmazás lehetőséget.

3. Használja a formátumot <your-app-exposed-application-URL-or-endpoint>/swagger-ui/oauth2-redirect.html OAuth2 átirányítási URL-címként az Átirányítási URI-k mezőben, majd válassza a Konfigurálás lehetőséget.

   

A hozzáférési jogkivonat beszerzése

A következő lépésekkel OAuth 2.0 engedélyezési kódfolyamat-metódussal szerezhet be egy hozzáférési jogkivonatot a Microsoft Entra-azonosítóval, majd hozzáférhet az ToDo alkalmazás RESTful API-jaihoz:

1. Nyissa meg az alkalmazás által közzétett URL-címet, majd válassza az Engedélyezés lehetőséget az OAuth2-hitelesítés előkészítéséhez.

2. Az Elérhető engedélyek ablakban adja meg az ToDoWeb alkalmazás ügyfél-azonosítóját a client_id mezőben, jelölje ki a Hatókörök mező összes hatókörét, hagyja figyelmen kívül a client_secret mezőt, majd válassza az Engedélyezés lehetőséget a Microsoft Entra bejelentkezési lapra való átirányításhoz.

Miután befejezte az előző felhasználóval való bejelentkezést, a rendszer visszalép az Elérhető engedélyek ablakba.

5.2. Hozzáférés a RESTful API-khoz

Az alábbi lépésekkel érheti el az alkalmazás RESTful API-jait a ToDo Swagger felhasználói felületén:

1. Válassza ki az API POST /api/simple-todo/lists elemet , majd válassza a Kipróbálás lehetőséget. Írja be a következő kérelemtörzset, majd válassza az Execute (Végrehajtás ) lehetőséget toDo-lista létrehozásához.

   {
     "name": "My List"
   }
   

   A végrehajtás befejezése után a következő válasz törzs jelenik meg:

   {
     "id": "<ID-of-the-ToDo-list>",
     "name": "My List",
     "description": null
   }
   

2. Válassza ki az API POST /api/simple-todo/lists/{listId}/items elemet, majd válassza a Kipróbálás lehetőséget. ListId esetén adja meg a korábban létrehozott ToDo listaazonosítót, írja be a következő kérelemtörzset, majd válassza a Végrehajtás elemet a ToDo-elem létrehozásához.

   {
     "name": "My first ToDo item", 
     "listId": "<ID-of-the-ToDo-list>",
     "state": "todo"
   }
   

   Ez a művelet a következő ToDo-elemet adja vissza:

   {
     "id": "<ID-of-the-ToDo-item>",
     "listId": "<ID-of-the-ToDo-list>",
     "name": "My first ToDo item",
     "description": null,
     "state": "todo",
     "dueDate": "2023-07-11T13:59:24.9033069+08:00",
     "completedDate": null
   }
   

3. Válassza ki az API GET /api/simple-todo/lists, majd a ToDo-listák lekérdezéséhez a Végrehajtás lehetőséget. Ez a művelet a következő ToDo-listákat adja vissza:

   [
     {
       "id": "<ID-of-the-ToDo-list>",
       "name": "My List",
       "description": null
     }
   ]
   

4. Válassza ki az API GET /api/simple-todo/lists/{listId}/items elemet, majd válassza a Kipróbálás lehetőséget. A listId mezőbe írja be a korábban létrehozott ToDo listaazonosítót, majd válassza az Execute (Végrehajtás) lehetőséget a ToDo-elemek lekérdezéséhez. Ez a művelet a következő ToDo-elemet adja vissza:

   [
     {
       "id": "<ID-of-the-ToDo-item>",
       "listId": "<ID-of-the-ToDo-list>",
       "name": "My first ToDo item",
       "description": null,
       "state": "todo",
       "dueDate": "2023-07-11T13:59:24.903307+08:00",
       "completedDate": null
     }
   ]
   

5. Válassza a PUT /api/simple-todo/lists/{listId}/items/{itemId} API-t, majd válassza a Kipróbálás lehetőséget. A listId mezőbe írja be a ToDo listaazonosítót. ItemId esetén adja meg a ToDo elem azonosítóját, írja be a következő kérelemtörzset, majd válassza az Végrehajtás lehetőséget a ToDo elem frissítéséhez.

   {
     "id": "<ID-of-the-ToDo-item>",
     "listId": "<ID-of-the-ToDo-list>",
     "name": "My first ToDo item",
     "description": "Updated description.",
     "dueDate": "2023-07-11T13:59:24.903307+08:00",
     "state": "inprogress"
   }
   

   Ez a művelet a következő frissített ToDo-elemet adja vissza:

   {
     "id": "<ID-of-the-ToDo-item>",
     "listId": "<ID-of-the-ToDo-list>",
     "name": "My first ToDo item",
     "description": "Updated description.",
     "state": "inprogress",
     "dueDate": "2023-07-11T05:59:24.903307Z",
     "completedDate": null
   }
   

6. Válassza az API DELETE /api/simple-todo/lists/{listId}/items/{itemId} lehetőséget, majd válassza a Kipróbálás lehetőséget. A listId mezőbe írja be a ToDo listaazonosítót. Az itemId mezőben adja meg a ToDo elem azonosítóját, majd válassza a Végrehajtás lehetőséget a ToDo elem törléséhez. Látnia kell, hogy a kiszolgáló válaszkódja .204

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

Törölheti az Azure-erőforráscsoportot, amely tartalmazza az erőforráscsoportban lévő összes erőforrást.

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ást is:

1. Keresse meg az erőforráscsoportot az Azure Portalon.

2. A navigációs menüben válassza az Erőforráscsoportok lehetőséget. Ezután válassza ki az erőforráscsoport nevét – például a myresourcegroupot.

3. Az erőforráscsoport oldalán kattintson a Törlés parancsra. A törlés megerősítéséhez írja be az erőforráscsoport nevét a szövegmezőbe – például myresourcegroup. Ezután válassza a Törlés lehetőséget.

Azure CLI

Az alábbi paranccsal törölheti a teljes erőforráscsoportot, beleértve az újonnan létrehozott szolgáltatást is:

az group delete --name ${RESOURCE_GROUP}

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ást is:

1. Keresse meg az erőforráscsoportot az Azure Portalon.

2. A navigációs menüben válassza az Erőforráscsoportok lehetőséget. Ezután válassza ki az erőforráscsoport nevét – például a myresourcegroupot.

3. Az erőforráscsoport oldalán kattintson a Törlés parancsra. A törlés megerősítéséhez írja be az erőforráscsoport nevét a szövegmezőbe – például myresourcegroup. Ezután 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: [a-resources-total], biztosan folytatja?: 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.

7. Következő lépések

Rövid útmutató: Eseményvezérelt alkalmazás üzembe helyezése az Azure Spring Appsben

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

Strukturált alkalmazásnapló az Azure Spring Appshez

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

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

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

• Azure Spring Apps-minták.
• A Spring használata az Azure-ban
• Spring Cloud Azure