Snabbstart: Använda Data API Builder med Azure Cosmos DB för NoSQL och Azure Static Web Apps

Artikel
01/23/2025

I den här snabbstarten distribuerar du Data API Builder (DAB) som en Docker-container till Azure Container Apps. Du använder en AZD-mall (Azure Developer CLI) för att distribuera DAB tillsammans med en Azure Cosmos DB for NoSQL-databas med hjälp av de senaste metodtipsen. Mallen distribuerar också ett exempelwebbprogram som ansluter till DAB-slutpunkten med hjälp av GraphQL.

Förutsättningar

Azure Developer CLI
.NET 9.0

Om du inte har något Azure-konto skapar du ett kostnadsfritt konto innan du börjar.

Initiera projektet

Använd Azure Developer CLI (azd) för att skapa ett Azure Cosmos DB för NoSQL-konto, distribuera DAB som en containerbaserad lösning och distribuera ett containerbaserat exempelprogram. Exempelprogrammet använder DAB för att fråga efter exempeldata.

Öppna en terminal i en tom katalog.
Om du inte redan är autentiserad autentiserar du till Azure Developer CLI med hjälp av azd auth login. Följ stegen som anges av verktyget för att autentisera till CLI med dina önskade Azure-autentiseringsuppgifter.
```
azd auth login
```

Använd azd init för att initiera projektet.

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

Under initieringen konfigurerar du ett unikt miljönamn.
Distribuera den fullständiga lösningen till Azure med hjälp av azd up. Bicep-mallarna implementerar ett Azure Cosmos DB för NoSQL-konto DAB till Azure Container Apps och en exempelwebbapplikation.
```
azd up
```
Under konfigureringsprocessen väljer du din prenumeration och önskad plats. Vänta tills etableringsprocessen har slutförts. Processen kan ta cirka sju minuter.

När etableringen av dina Azure-resurser är klar inkluderas en URL till det webbprogram som körs i utdata.

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.

Registrera värdena för URL:en för API- och webbtjänsterna -. Du använder dessa värden senare i den här guiden.

Konfigurera databasanslutningen

Bläddra nu till varje containerbaserat program i Azure Container Apps för att verifiera att de fungerar som förväntat.

Gå först till URL:en för API-tjänsten . Den här URL:en länkar till den DAB-instans som körs.
Observera JSON-utdata från DAB. Det ska visa att DAB-containern körs och att statusen är felfri.
```
{
  "status": "healthy",
  "version": "1.1.7",
  "app-name": "dab_oss_1.1.7"
}
```
Navigera till den relativa /graphql sökvägen för DAB-instansen. Den här URL:en bör öppna Nitro GraphQL Integrated Development Environment (IDE).
I Nitro IDE skapar du ett nytt dokument och kör den här frågan för att hämta alla 100 objekt i Containern Azure Cosmos DB for NoSQL products.
```
query {
  products {
    items {
    id
    name
    description
    sku
    price
    cost
    }
  }
}
```
Gå slutligen till URL:en för webbtjänst. Den här URL:en länkar till det webbprogram som körs och som ansluter till GraphQL-slutpunkten som du kom åt i föregående steg.
Observera webbprogrammet som körs och granska utdata.

Rensa

När du inte längre behöver exempelprogrammet eller resurserna tar du bort motsvarande distribution och alla resurser.

Ta bort distributionen från din Azure-prenumeration.
```
azd down
```
Ta bort det kodområde som körs för att maximera dina lagrings- och kärnrättigheter om du använder GitHub Codespaces.

Nästa steg

GraphQL-slutpunkter

Dela via