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

I den här snabbstarten distribuerar du en mall för Azure Developer CLI (AZD). Mallen distribuerar en Azure Static Web App som är värd för data-API-byggaren med hjälp av den Databasanslutningar funktionen. Mallen innehåller också ett exempelprogram som du kan använda som utgångspunkt för dina lösningar.

Förutsättningar

• En Azure-prenumeration. Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt utvärderingskonto
• .NET 8
• Azure Developer CLI

Tips

Du kan också öppna den här snabbstarten i GitHub Codespaces med alla krav för utvecklare som redan är installerade. Ta bara med din egen Azure-prenumeration. GitHub-konton innehåller berättigande till lagring och kärntimmar utan kostnad. Mer information finns i inkluderade lagrings- och kärntimmar för GitHub-konton.

Distribuera mallen

Distribuera först alla nödvändiga tjänster med hjälp av AZD-mallen.

1. Öppna en terminal i projektets rotkatalog.

2. Autentisera till Azure Developer CLI med .azd auth login Följ stegen som anges av verktyget för att autentisera till CLI med dina önskade Azure-autentiseringsuppgifter.

   azd auth login
   

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

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

   Viktigt

   Om du kör i GitHub Codespaces kan du på ett säkert sätt utelämna --template argumentet eftersom koden redan har klonats till din miljö.

4. Under initieringen konfigurerar du ett unikt miljönamn.

   Tips

   Miljönamnet används också som målresursgruppsnamn. För den här snabbstarten bör du överväga att använda msdocs-swa-dab.

5. Distribuera den Azure Static Web Apps lösningen med .azd up Bicep-mallarna distribuerar ett Azure Cosmos DB för NoSQL-konto tillsammans med stödtjänster för lagring, identitet och värdtjänster. Ett exempelwebbprogram distribueras till webbvärden.

   azd up
   

6. Under etableringsprocessen väljer du din prenumeration och önskad plats. Vänta tills etableringsprocessen har slutförts. Processen kan ta cirka fem minuter.

7. När etableringen av dina Azure-resurser är klar matar mallen ut ett SUCCESS-meddelande tillsammans med körningens varaktighet.

   SUCCESS: Your application was provisioned and deployed to Azure in 5 minutes 0 seconds.
   

Konfigurera databasanslutningen

Använd nu funktionen Databasanslutningar i Azure Static Web Apps för att skapa en anslutning mellan den distribuerade statiska webbappen och den distribuerade databasen. Den här funktionen använder Data API Builder sömlöst för att skapa en anslutning till ett Azure Cosmos DB for NoSQL-konto som körs med de autentiseringsuppgifter som du anger.

1. Gå till Azure Static Web App-resursen i Azure Portal.

2. Konfigurera den statiska webbappen för att lägga till en databasanslutning till Azure Cosmos DB för NoSQL-kontot med hjälp av de här inställningarna. Välj sedan Länka.

   	Värde
   Databastyp	Azure Cosmos DB for NoSQL
   Prenumeration	Välj den prenumeration som du använde för AZD-distributionen
   Resursgrupp	Välj den resursgrupp (miljö) som du använde för AZD-distributionen
   Resursnamn	Välj den enda Azure Cosmos DB för NoSQL-resursen med prefixet nosql-*
   Databasnamn	cosmicworks
   Autentiseringstyp	User-assigned managed identity
   Användartilldelad hanterad identitet	*Välj den enda hanterade identitetsresursen med prefixet ua-id-*

   

3. Välj nu alternativet Bläddra på resurssidan för att se hur webbprogrammet körs.

   

Rensa

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

1. Ta bort distributionen från din Azure-prenumeration.

   azd down
   

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