Quickstart: Data API Builder gebruiken met Azure Cosmos DB voor NoSQL en Azure Static Web Apps

In deze snelstart implementeert u een AZD-sjabloon (Azure Developer CLI). Met de sjabloon wordt een statische Azure-web-app geïmplementeerd die als host fungeert voor de data-API-opbouwfunctie met behulp van de functie database verbindingen. De sjabloon bevat ook een voorbeeldtoepassing die u als uitgangspunt voor uw oplossingen kunt gebruiken.

Vereisten

• Azure-abonnement. Als u geen Azure-abonnement hebt, maakt u een gratis proefaccount
• .NET 8
• Azure Developer CLI

Tip

U kunt ook deze quickstart openen in GitHub Codespaces met alle vereisten voor ontwikkelaars die al zijn geïnstalleerd. Neem gewoon uw eigen Azure-abonnement mee. GitHub-accounts hebben gratis recht op opslag en kernuren. Zie Inbegrepen opslag- en kernuren voor GitHub-accounts voor meer informatie.

De sjabloon implementeren

Implementeer eerst alle vereiste services met behulp van de AZD-sjabloon.

1. Open een terminal in de hoofdmap van het project.

2. Verifieer bij de Azure Developer CLI met behulp van azd auth login. Volg de stappen die zijn opgegeven door het hulpprogramma om te verifiëren bij de CLI met behulp van de Azure-referenties van uw voorkeur.

   azd auth login
   

3. Gebruik azd init om het project te initialiseren.

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

   Belangrijk

   Als u in GitHub Codespaces uitvoert, kunt u het --template argument veilig weglaten omdat de code al naar uw omgeving is gekloond.

4. Configureer tijdens de initialisatie een unieke omgevingsnaam.

   Tip

   De naam van de omgeving wordt ook gebruikt als de naam van de doelresourcegroep. Voor deze quickstart kunt u overwegen om te gebruiken msdocs-swa-dab.

5. Implementeer de Azure Static Web Apps-oplossing met behulp van azd up. Met de Bicep-sjablonen wordt een Azure Cosmos DB for NoSQL-account geïmplementeerd, samen met de ondersteunende opslag-, identiteits- en hostservices. Er wordt een voorbeeldwebtoepassing geïmplementeerd op de webhost.

   azd up
   

6. Selecteer tijdens het inrichtingsproces uw abonnement en gewenste locatie. Wacht totdat het inrichtingsproces is voltooid. Het proces kan ongeveer vijf minuten duren.

7. Zodra het inrichten van uw Azure-resources is voltooid, wordt met de sjabloon een BERICHT GESLAAGD weergegeven, samen met de duur van de uitvoering.

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

Verbinding met de database configureren

Gebruik nu de database verbindingen-functie van Azure Static Web Apps om een verbinding te maken tussen de geïmplementeerde statische web-app en de geïmplementeerde database. Deze functie maakt naadloos gebruik van Data API Builder om een verbinding te maken met een actief Azure Cosmos DB voor NoSQL-account met behulp van de referenties die u opgeeft.

1. Navigeer naar de azure static web-app-resource in de Azure Portal.

2. Configureer de statische web-app om een databaseverbinding toe te voegen aan het Azure Cosmos DB voor NoSQL-account met behulp van deze instellingen. Selecteer vervolgens Koppelen.

   	Waarde
   Databasetype	Azure Cosmos DB for NoSQL
   Abonnement	Selecteer het abonnement dat u hebt gebruikt voor de AZD-implementatie
   Resourcegroep	Selecteer de resourcegroep (omgeving) die u hebt gebruikt voor de AZD-implementatie
   Resourcenaam	Selecteer de enige Azure Cosmos DB for NoSQL-resource met het voorvoegsel van nosql-*
   Databasenaam	cosmicworks
   Verificatietype	User-assigned managed identity
   Door een gebruiker toegewezen beheerde identiteit	*Selecteer de enige beheerde identiteitsresource met het voorvoegsel van ua-id-*

   

3. Selecteer nu de optie Bladeren op de resourcepagina om de actieve webtoepassing te bekijken.

   

Opschonen

Wanneer u de voorbeeldtoepassing of -resources niet meer nodig hebt, verwijdert u de bijbehorende implementatie en alle resources.

1. Verwijder de implementatie uit uw Azure-abonnement.

   azd down
   

2. Verwijder de actieve codespace om uw opslag- en kernrechten te maximaliseren als u GitHub Codespaces gebruikt.

Volgende stap

GraphQL-eindpunten