Rövid útmutató: A Data API Builder használata az Azure Cosmos DB for NoSQL-hez és az Azure Container Appshez

Ebben a rövid útmutatóban Docker-tárolóként üzembe helyezi a Data API Buildert (DAB) az Azure Container Appsben. A DAB és az Azure Cosmos DB for NoSQL-adatbázis üzembe helyezéséhez egy Azure Developer CLI-sablont (AZD) használ a legújabb ajánlott eljárások használatával. A sablon egy minta webalkalmazást is üzembe helyez, amely a GraphQL használatával csatlakozik a DAB-végponthoz.

Előfeltételek

• Azure Developer CLI
• .NET 9.0

Ha még nem rendelkezik Azure-fiókkal, első lépésként hozzon létre egy ingyenes fiókot.

A projekt inicializálása

Az Azure Developer CLI (azd) használatával hozzon létre egy Azure Cosmos DB for NoSQL-fiókot, telepítse a DAB-t tárolóalapú megoldásként, és helyezzen üzembe egy tárolóalapú mintaalkalmazást. A mintaalkalmazás a DAB használatával kérdezi le a mintaadatokat.

1. Nyisson meg egy terminált egy üres mappában.

2. Ha még nincs hitelesítve, jelentkezzen be az Azure Developer CLI-be a azd auth loginhasználatával. Kövesse az eszköz által megadott lépéseket a parancssori felületre való hitelesítéshez az ön által előnyben részesített Azure-hitelesítő adatokkal.

   azd auth login
   

3. A projekt inicializálására használható azd init .

   azd init --template dab-azure-cosmos-db-nosql-quickstart
   

4. Az inicializálás során konfiguráljon egy egyedi környezetnevet.

5. A következő lépés folytatása előtt győződjön meg arról, hogy a Docker fut a számítógépen.

6. A teljes megoldás üzembe helyezése az Azure-ban a azd uphasználatával. A Bicep-sablonok üzembe helyeznek egy Azure Cosmos DB for NoSQL-fiókot DAB-ba és egy minta webalkalmazást az Azure Container Appsben.

   azd up
   

7. A kiépítési folyamat során válassza ki az előfizetést és a kívánt helyet. Várja meg, amíg a kiépítési folyamat befejeződik. A folyamat körülbelül hét percig tarthat .

8. Az Azure-erőforrások kiépítése után a kimenet tartalmazza a futó webalkalmazás URL-címét.

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service api
   - Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io>
   
   (✓) Done: Deploying service web
   - Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io>
   
   SUCCESS: Your up workflow to provision and deploy to Azure completed in 7 minutes 0 seconds.
   

9. Jegyezze fel a api és webes szolgáltatások URL-címének értékeit. Ezeket az értékeket az útmutató későbbi részében használhatja.

Az adatbázis-kapcsolat konfigurálása

Most keresse meg az Azure Container Apps összes tárolóalapú alkalmazását, és ellenőrizze, hogy a várt módon működnek-e.

1. Először keresse meg az api szolgáltatás URL-címét. Ez az URL-cím a futó DAB-példányra mutat.

2. Figyelje meg a DAB JSON-kimenetét. Azt kell jeleznie, hogy a DAB-tároló fut, és az állapot kifogástalan.

   {
     "status": "healthy",
     "version": "1.4.35",
     "app-name": "dab_oss_1.4.35"
   }
   

3. Keresse meg a DAB-példány relatív /graphql elérési útját. Ennek az URL-címnek meg kell nyitnia a Nitro GraphQL integrált fejlesztési környezetet (IDE).

4. A Nitro IDE-ben hozzon létre egy új dokumentumot, és futtassa ezt a lekérdezést az Azure Cosmos DB for NoSQL products tároló mind a 100 elemének lekéréséhez.

   query {
     products {
       items {
       id
       name
       description
       sku
       price
       cost
       }
     }
   }
   

5. Végül navigáljon a webes szolgáltatás URL-címére. Ez az URL-cím a futó minta webalkalmazásra mutat, amely az előző lépésben elért GraphQL-végponthoz csatlakozik.

6. Figyelje meg a futó webalkalmazást, és tekintse át a kimeneti adatokat.

   

Takarítás

Ha már nincs szüksége a mintaalkalmazásra vagy erőforrásokra, távolítsa el a megfelelő üzembe helyezést és az összes erőforrást.

1. Távolítsa el az üzembe helyezést az Azure-előfizetésből.

   azd down
   

2. Ha GitHub Codespace-eket használ, törölje a futó kódteret a tárterület és az alapvető jogosultságok maximalizálása érdekében.

Következő lépés

GraphQL-végpontok