Démarrage rapide : Utiliser le générateur d’API de données avec Azure Cosmos DB for NoSQL et Azure Static Web Apps

Article
04/29/2024

Dans ce guide de démarrage rapide, vous déployez un modèle de Azure Developer CLI (AZD). Le modèle déploie une application web statique Azure qui héberge le générateur d’API de données à l’aide de sa fonctionnalité connexions aux bases de données. Le modèle inclut également un exemple d’application que vous pouvez utiliser comme point de départ pour vos solutions.

Prérequis

Abonnement Azure. Si vous n’avez pas d’abonnement Azure, créez un compte d’essai gratuit
.NET 8
Azure Developer CLI

Conseil

Vous pouvez également ouvrir ce guide de démarrage rapide dans GitHub Codespaces avec tous les prérequis pour les développeurs déjà installés. Apportez simplement votre propre abonnement Azure. Les comptes GitHub incluent un droit de stockage et d’heures de base gratuitement. Pour plus d’informations, consultez Heures de stockage et de cœur incluses pour les comptes GitHub.

Déployer le modèle

Tout d’abord, déployez tous les services requis à l’aide du modèle AZD.

Ouvrez un terminal dans le répertoire racine du projet.
Authentifiez-vous auprès du Azure Developer CLI à l’aide de azd auth login. Suivez les étapes spécifiées par l’outil pour vous authentifier auprès de l’interface CLI à l’aide de vos informations d’identification Azure préférées.
```
azd auth login
```
Utilisez azd init pour initialiser le projet.
```
azd init --template dab-azure-cosmos-db-nosql-quickstart
```
Important

Si vous exécutez dans GitHub Codespaces, vous pouvez omettre l’argument --template en toute sécurité, car le code a déjà été cloné dans votre environnement.
Pendant l’initialisation, configurez un nom d’environnement unique.

Conseil

Le nom de l’environnement sera également utilisé comme nom du groupe de ressources cible. Pour ce guide de démarrage rapide, envisagez d’utiliser msdocs-swa-dab.
Déployez la solution Azure Static Web Apps à l’aide de azd up. Les modèles Bicep déploient un compte Azure Cosmos DB for NoSQL , ainsi que les services de stockage, d’identité et d’hôte de prise en charge. Un exemple d’application web est déployé sur l’hôte web.
```
azd up
```
Pendant le processus d’approvisionnement, sélectionnez votre abonnement et l’emplacement souhaité. Attendez la fin du processus de provisionnement. Le processus peut prendre environ cinq minutes.
Une fois l’approvisionnement de vos ressources Azure terminé, le modèle génère un message SUCCESS avec la durée de l’exécution.
```
SUCCESS: Your application was provisioned and deployed to Azure in 5 minutes 0 seconds.
```

Configurer la connexion à la base de données

À présent, utilisez la fonctionnalité connexions aux bases de données de Azure Static Web Apps pour créer une connexion entre l’application web statique déployée et la base de données déployée. Cette fonctionnalité utilise le générateur d’API de données en toute transparence pour créer une connexion à un compte Azure Cosmos DB for NoSQL en cours d’exécution à l’aide des informations d’identification que vous spécifiez.

Accédez à la ressource Azure Static Web App dans le Portail Azure.

Configurez l’application web statique pour ajouter une connexion de base de données au compte Azure Cosmos DB for NoSQL à l’aide de ces paramètres. Ensuite, sélectionnez Lien.

	Valeur
Type de base de données	`Azure Cosmos DB for NoSQL`
Abonnement	Sélectionnez l’abonnement que vous avez utilisé pour le déploiement AZD
Groupe de ressources	Sélectionnez le groupe de ressources (environnement) que vous avez utilisé pour le déploiement AZD
Nom de la ressource	Sélectionnez la seule ressource Azure Cosmos DB for NoSQL avec le préfixe `nosql-`*
Nom de la base de données	`cosmicworks`
Type d’authentification	`User-assigned managed identity`
Identité managée affectée par l’utilisateur	Sélectionnez la seule ressource d’identité managée avec le préfixe `ua-id-`

Capture d’écran de la page de connexion de base de données pour une application web statique dans le Portail Azure.

À présent, sélectionnez l’option Parcourir sur la page de ressources pour observer l’application web en cours d’exécution.

Nettoyage

Lorsque vous n’avez plus besoin de l’exemple d’application ou de ressources, supprimez le déploiement correspondant et toutes les ressources.

Supprimez le déploiement de votre abonnement Azure.
```
azd down
```
Supprimez le codespace en cours d’exécution pour optimiser vos droits de stockage et de base si vous utilisez GitHub Codespaces.

Étape suivante

points de terminaison GraphQL

Partager via