Rychlý start: Použití tvůrce rozhraní Data API se službou Azure Cosmos DB for NoSQL a Azure Container Apps

V tomto rychlém startu nasadíte Data API Builder (DAB) jako Docker kontejner do Azure Container Apps. Pomocí šablony Azure Developer CLI (AZD) nasadíte DAB spolu s databází Azure Cosmos DB for NoSQL s využitím nejnovějších osvědčených postupů. Šablona také nasadí ukázkovou webovou aplikaci, která se připojí ke koncovému bodu DAB pomocí GraphQL.

Požadavky

• Azure Developer CLI
• .NET 9.0

Pokud nemáte účet Azure, vytvořte si bezplatný účet před tím, než začnete.

Inicializace projektu

Pomocí Azure Developer CLI (azd) vytvořte účet Služby Azure Cosmos DB for NoSQL, nasaďte DAB jako kontejnerizované řešení a nasaďte kontejnerizovanou ukázkovou aplikaci. Ukázková aplikace používá DAB k dotazování ukázkových dat.

1. Otevřete terminál v prázdném adresáři.

2. Pokud ještě nejste ověřeni, ověřte se v Azure Developer CLI pomocí azd auth login. Postupujte podle kroků určených nástrojem k ověření v rozhraní příkazového řádku pomocí vašich upřednostňovaných přihlašovacích údajů Azure.

   azd auth login
   

3. K inicializaci projektu použijte azd init.

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

4. Během inicializace nakonfigurujte jedinečný název prostředí.

5. Než budete pokračovat dalším krokem, ujistěte se, že na vašem počítači běží Docker.

6. Nasazení úplného řešení do Azure pomocí azd up. Šablony Bicep nasazují účet služby Azure Cosmos DB for NoSQL DAB do Azure Container Apps a ukázkovou webovou aplikaci.

   azd up
   

7. Během procesu zřizování vyberte své předplatné a požadované umístění. Počkejte na dokončení procesu nastavení. Proces může trvat přibližně sedm minut.

8. Po dokončení zřizování prostředků Azure se do výstupu zahrne adresa URL spuštěné webové aplikace.

   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. Poznamenejte si hodnoty adresy URL API a webových služeb. Tyto hodnoty použijete dále v tomto průvodci.

Konfigurace připojení k databázi

Teď přejděte do každé kontejnerizované aplikace v Azure Container Apps a ověřte, že fungují podle očekávání.

1. Nejprve přejděte na URL adresu služby API . Tato adresa URL odkazuje na spuštěnou instanci DAB.

2. Prohlédněte si výstup JSON z DAB. Mělo by to znamenat, že kontejner DAB je spuštěný a stav je v pořádku.

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

3. Přejděte na relativní cestu pro instanci DAB: /graphql. Tato adresa URL by měla otevřít integrované vývojové prostředí (IDE) Nitro GraphQL.

4. V prostředí Nitro IDE vytvořte nový dokument a spusťte tento dotaz, abyste získali všech 100 položek v kontejneru Azure Cosmos DB for NoSQL products.

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

5. Nakonec přejděte na adresu URL pro webovou službu . Tato adresa URL odkazuje na spuštěnou ukázkovou webovou aplikaci, která se připojuje ke koncovému bodu GraphQL, ke kterému jste získali přístup v předchozím kroku.

6. Prohlédněte si spuštěnou webovou aplikaci a zkontrolujte výstupní data.

   

Vyčištění

Pokud už ukázkovou aplikaci nebo prostředky nepotřebujete, odeberte odpovídající nasazení a všechny prostředky.

1. Odeberte nasazení z předplatného Azure.

   azd down
   

2. Pokud používáte GitHub Codespaces, odstraňte spuštěný codespace, abyste maximalizovali nároky na úložiště a jádra.

Další krok

koncových bodů GraphQL