Schnellstart: Verwenden des Daten-API-Generators mit Azure SQL und Azure-Container-Apps

In dieser Schnellstartanleitung stellen Sie den Daten-API-Generator (DAB) als Docker-Container in Azure-Container-Apps bereit. Sie verwenden eine Azure Developer CLI (AZD)-Vorlage, um DAB zusammen mit einer Azure SQL-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 (Befehlszeilenschnittstelle für Entwickler)
• .NET 9.0

Wenn Sie nicht über ein Azure-Konto verfügen, erstellen Sie ein kostenloses Konto , bevor Sie beginnen.

Initialisieren des Projekts

Verwenden Sie die Azure Developer CLI (azd), um ein Azure SQL-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 loginbei 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 azd init, um das Projekt zu initialisieren.

   azd init --template dab-azure-sql-quickstart
   

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

5. Stellen Sie sicher, dass Docker auf Ihrem Computer ausgeführt wird, bevor Sie mit dem nächsten Schritt fortfahren.

6. Stellen Sie die vollständige Lösung in Azure mithilfe von azd upbereit. Die Bicep-Vorlagen stellen ein Azure SQL-Konto DAB für Azure-Container-Apps und eine Beispielwebanwendung bereit.

   azd up
   

7. 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 ungefähr sieben Minutendauern.

8. Sobald die Bereitstellung Ihrer Azure-Ressourcen abgeschlossen ist, enthält die Ausgabe eine URL zur ausgeführten Webanwendung.

   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. 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 erwartungsgemäß 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 läuft und der Status gesundist.

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

3. Navigieren Sie zum relativen /swagger Pfad für die DAB-Instanz. Diese URL sollte die Swagger UI REST integrated development environment (IDE) öffnen.

4. Führen Sie in der Swagger-IDE eine GET Anforderung für alle Zeilen in der Tabelle Azure SQL products aus.

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

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

REST-Endpunkte