Schnellstart: Verwenden des Daten-API-Generators mit Azure Cosmos DB für NoSQL und Azure Container Apps

In dieser Schnellstartanleitung stellen Sie den Daten-API-Generator (DAB) als Docker-Container für Azure Container Apps bereit. Sie verwenden eine Azure Developer CLI (AZD)-Vorlage, um DAB zusammen mit einer Azure Cosmos DB für NoSQL Datenbank mithilfe der neuesten bewährten Methoden bereitzustellen. Die Vorlage stellt auch eine Beispielwebanwendung bereit, die mithilfe von GraphQL eine Verbindung mit dem DAB-Endpunkt herstellt.

Voraussetzungen

• Azure Developer CLI
• .NET 9.0
• Azure Abonnement, in dem Sie mindestens über die Rolle Contributor
• Docker läuft lokal

Wenn Sie kein Azure Konto haben, erstellen Sie ein free-Konto bevor Sie beginnen.

Initialisieren des Projekts

Verwenden Sie die Azure Developer CLI (azd), um eine Azure Cosmos DB für NoSQL Konto zu erstellen, DAB als containerisierte Lösung bereitzustellen und eine containerisierte Beispielanwendung bereitzustellen. Die Beispielanwendung verwendet DAB zum Abfragen von Beispieldaten.

1. Öffnen Sie ein Terminal in einem leeren Verzeichnis.

2. Wenn Sie noch nicht authentifiziert sind, authentifizieren Sie sich mit azd auth login bei der Azure Developer CLI. Führen Sie die vom Tool angegebenen Schritte aus, um sich mit Ihren bevorzugten Azure Anmeldeinformationen bei der CLI zu authentifizieren.

   azd auth login
   

3. Verwenden Sie , um das Projekt zu initialisieren.

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

4. Konfigurieren Sie während der Initialisierung einen eindeutigen Umgebungsnamen.

5. Stellen Sie die vollständige Lösung für Azure mithilfe von azd up bereit. Die Bicep Vorlagen stellen eine Azure Cosmos DB für NoSQL Konto, DAB für Azure Container Apps, eine Beispielwebanwendung und eine verwaltete Identität für den sicheren Datenzugriff bereit.

   azd up
   

6. Wählen Sie während des Bereitstellungsprozesses Ihr Abonnement und den gewünschten Standort aus. Warten Sie, bis der Bereitstellungsprozess abgeschlossen ist. Der Vorgang kann je nach Region und Abonnement mehrere Minuten dauern.

7. Sobald die Bereitstellung Ihrer Azure Ressourcen abgeschlossen ist, wird eine URL zur ausgeführten Webanwendung in die Ausgabe eingeschlossen.

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

8. Notieren Sie die Werte für die URL der -API-- und -Web--Dienste. Sie verwenden diese Werte weiter unten in diesem Handbuch.

Konfigurieren der Datenbankverbindung

Navigieren Sie nun zu jeder containerisierten Anwendung in Azure Container Apps, um zu überprüfen, ob sie wie erwartet funktionieren.

1. Navigieren Sie zunächst zur URL für den Dienst der -API. Diese URL verweist auf die ausgeführte DAB-Instanz.

2. Beobachten Sie die JSON-Ausgabe von DAB. Es sollte darauf hinweisen, dass der DAB-Container ausgeführt wird und der Status "Fehlerfrei" lautet.

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

   1. Navigieren Sie zum relativen Pfad für die DAB-Instanz.
   • Wenn die App im Entwicklungsmodus ausgeführt wird, öffnet diese URL die integrierte Nitro GraphQL-Entwicklungsumgebung (IDE).
   • Wenn die App im Produktionsmodus ausgeführt wird, wird Nitro nicht in der Browsernavigation angezeigt. Verwenden Sie in diesem Fall die Beispielweb-App oder einen anderen GraphQL-Client.
   1. Wenn Nitro verfügbar ist, erstellen Sie ein neues Dokument, und führen Sie diese Abfrage aus, um alle 100 Elemente im Azure Cosmos DB für NoSQL products Container abzurufen.

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

3. Navigieren Sie zum Schluss zur URL des Webdienstes . Diese URL verweist auf die ausgeführte Beispielwebanwendung, die eine Verbindung mit dem GraphQL-Endpunkt herstellt, auf den Sie im vorherigen Schritt zugegriffen haben.

4. Beobachten Sie die ausgeführte Webanwendung, und überprüfen Sie die Ausgabedaten.

   

Aufräumen

Wenn Sie die Beispielanwendung oder Ressourcen nicht mehr benötigen, entfernen Sie die entsprechende Bereitstellung und alle Ressourcen.

1. Entfernen Sie die Bereitstellung aus Ihrem Azure-Abonnement.

   azd down
   

2. Löschen Sie den ausgeführten Codespace, um Ihre Speicher- und Kernberechtigungen zu maximieren, wenn Sie GitHub Codespaces verwenden.

Nächster Schritt

Verwandte Inhalte

• Einrichten eines Data API Builders für Azure Cosmos DB für NoSQL
• Featureverfügbarkeit für den Daten-API-Generator