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

Article
01/27/2025

Dans ce guide de démarrage rapide, vous déployez le générateur d’API de données (DAB) en tant que conteneur Docker dans Azure Container Apps. Vous utilisez un modèle Azure Developer CLI (AZD) pour déployer DAB avec une base de données Azure Cosmos DB pour NoSQL à l’aide des meilleures pratiques les plus récentes. Le modèle déploie également un exemple d’application web qui se connecte au point de terminaison DAB à l’aide de GraphQL.

Conditions préalables

Azure CLI pour Développeur
.NET 9.0

Si vous n’avez pas de compte Azure, créez un compte gratuit avant de commencer.

Initialiser le projet

Utilisez azure Developer CLI (azd) pour créer un compte Azure Cosmos DB pour NoSQL, déployer DAB en tant que solution conteneurisée et déployer un exemple d’application conteneurisé. L’exemple d’application utilise DAB pour interroger des exemples de données.

Ouvrez un terminal dans un répertoire vide.
Si vous n’êtes pas encore authentifié, authentifiez-vous auprès de l’interface CLI du développeur Azure à 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

Lors de l’initialisation, configurez un nom d’environnement unique.
Déployez la solution complète sur Azure à l’aide de azd up. Les modèles Bicep déploient un compte Azure Cosmos DB pour NoSQL DAB sur Azure Container Apps et un exemple d’application web.
```
azd up
```
Pendant le processus d’approvisionnement, sélectionnez votre abonnement et l’emplacement souhaité. Attendez que le processus d’approvisionnement se termine. Le processus peut prendre environ sept minutes.

Une fois l’approvisionnement de vos ressources Azure terminée, une URL vers l’application web en cours d’exécution est incluse dans la sortie.

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.

Enregistrez les valeurs de l’URL de l’API et des services web . Vous utilisez ces valeurs plus loin dans ce guide.

Configurer la connexion de base de données

À présent, accédez à chaque application conteneurisée dans Azure Container Apps pour vérifier qu’elles fonctionnent comme prévu.

Tout d'abord, accédez à l'URL de l'api du service. Cette URL est liée à l’instance DAB en cours d’exécution.
Observez la sortie JSON de DAB. Il doit indiquer que le conteneur DAB est en cours d’exécution et que l’état est sain.
```
{
  "status": "healthy",
  "version": "1.1.7",
  "app-name": "dab_oss_1.1.7"
}
```
Accédez au chemin relatif /graphql de l'instance DAB. Cette URL doit ouvrir l’environnement de développement intégré (IDE) Nitro GraphQL.
Dans l’IDE Nitro, créez un document et exécutez cette requête pour obtenir tous les 100 éléments du conteneur Azure Cosmos DB pour NoSQL products.
```
query {
  products {
    items {
    id
    name
    description
    sku
    price
    cost
    }
  }
}
```
Enfin, accédez à l’URL du service web . Cette URL est liée à l’exemple d’application web en cours d’exécution qui se connecte au point de terminaison GraphQL auquel vous avez accédé à l’étape précédente.
Observez l’application web en cours d’exécution et examinez les données de sortie.

capture d’écran

Nettoyer

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 l’espace de code 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