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

In dieser Schnellstartanleitung stellen Sie eine Azure Developer CLI-Vorlage (AZD) bereit. Die Vorlage stellt eine statische Azure-Web-App bereit, die den Daten-API-Generator mit Datenbankverbindungen Feature hostet. Die Vorlage enthält auch eine Beispielanwendung, die Sie als Ausgangspunkt für Ihre Lösungen verwenden können.

Voraussetzungen

• Azure-Abonnement. Wenn Sie kein Azure-Abonnement haben, erstellen Sie ein kostenloses Testkonto.
• .NET 8
• Azure Developer CLI

Tipp

Alternativ können Sie diese Schnellstartanleitung in GitHub Codespaces öffnen, wobei alle Entwicklervoraussetzungen bereits installiert sind. Bringen Sie einfach Ihr eigenes Azure-Abonnement mit. GitHub-Konten enthalten eine Berechtigung für Speicher und Kernstunden ohne Kosten. Weitere Informationen finden Sie unter Eingeschlossener Speicher und Kernstunden für GitHub-Konten.

Bereitstellen der Vorlage

Stellen Sie zunächst alle erforderlichen Dienste mithilfe der AZD-Vorlage bereit.

1. Öffnen Sie ein Terminal im Stammverzeichnis des Projekts.

2. Authentifizieren Sie sich beim Azure Developer CLI mithilfe von azd auth login. 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 zum Initialisieren des Projekts.

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

   Wichtig

   Wenn Sie in GitHub Codespaces ausführen, können Sie das --template Argument sicher weglassen, da der Code bereits in Ihre Umgebung geklont wurde.

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

   Tipp

   Der Umgebungsname wird auch als Name der Zielressourcengruppe verwendet. Erwägen Sie für diese Schnellstartanleitung die Verwendung von msdocs-swa-dab.

5. Stellen Sie die Azure Static Web Apps-Lösung mithilfe von azd upbereit. Die Bicep-Vorlagen stellen ein Azure Cosmos DB for NoSQL-Konto zusammen mit den unterstützenden Speicher-, Identitäts- und Hostdiensten bereit. Eine Beispielwebanwendung wird auf dem Webhost bereitgestellt.

   azd up
   

6. Wählen Sie während des Bereitstellungsprozesses Ihr Abonnement und den gewünschten Standort aus. Warten Sie auf den Abschluss des Bereitstellungsvorgangs. Der Vorgang kann ungefähr fünf Minuten dauern.

7. Sobald die Bereitstellung Ihrer Azure-Ressourcen abgeschlossen ist, gibt die Vorlage eine SUCCESS-Meldung zusammen mit der Dauer der Ausführung aus.

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

Konfigurieren der Datenbankverbindung

Verwenden Sie nun das Datenbankverbindungen-Feature von Azure Static Web Apps, um eine Verbindung zwischen der bereitgestellten statischen Web-App und der bereitgestellten Datenbank herzustellen. Dieses Feature verwendet den Daten-API-Generator nahtlos, um mithilfe der von Ihnen angegebenen Anmeldeinformationen eine Verbindung mit einem ausgeführten Azure Cosmos DB for NoSQL-Konto herzustellen.

1. Navigieren Sie zur Azure Static Web App-Ressource im Azure-Portal.

2. Konfigurieren Sie die statische Web-App, um dem Azure Cosmos DB for NoSQL-Konto mithilfe dieser Einstellungen eine Datenbankverbindung hinzuzufügen. Wählen Sie dann Link aus.

   	Wert
   Datenbanktyp	Azure Cosmos DB for NoSQL
   Abonnement	Wählen Sie das Abonnement aus, das Sie für die AZD-Bereitstellung verwendet haben.
   Ressourcengruppe	Wählen Sie die Ressourcengruppe (Umgebung) aus, die Sie für die AZD-Bereitstellung verwendet haben.
   Ressourcenname	Wählen Sie die einzige Azure Cosmos DB for NoSQL-Ressource mit dem Präfix aus. nosql-*
   Datenbankname	cosmicworks
   Authentifizierungstyp	User-assigned managed identity
   Benutzerseitig zugewiesene verwaltete Identität	*Wählen Sie die einzige verwaltete Identitätsressource mit dem Präfix aus. ua-id-*

   

3. Wählen Sie nun die Option Durchsuchen auf der Ressourcenseite aus, um die Ausführung der Webanwendung zu beobachten.

   

Bereinigung

Wenn Sie die Beispielanwendung oder die Beispielressourcen 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

GraphQL Endpunkte