Déployer le générateur d’API de données sur Azure Container Apps

Diagramme de la séquence du guide de déploiement, y compris ces emplacements, dans l’ordre : Vue d’ensemble, Plan, Préparation, Publication, Surveillance et Optimisation. L’emplacement « Publier » est actuellement surligné.

Conditions préalables

• Un compte Azure avec un abonnement actif. Créez un compte gratuitement.

• CLI du générateur d'API de données. Installez l’interface CLI.

• Azure CLI. Installer l’interface de ligne de commande Microsoft Azure.

• Base de données prise en charge existante accessible à partir d’Azure.

Générer le fichier de configuration

Pour commencer, créez un fichier de configuration DAB (Data API Builder) pour vous connecter à votre base de données existante. Ce fichier est utilisé ultérieurement avec le conteneur final.

1. Créez un répertoire vide sur votre ordinateur local pour stocker le fichier de configuration.

2. Initialisez un nouveau fichier de configuration de base à l’aide dab initde . Utilisez les paramètres suivants au minimum lors de l’initialisation.

   Réglage	Valeur
   Type de base de données	Sélectionnez un type de base de données pris en charge.
   chaîne de connexion	Utilisez la @env() fonction pour référencer la variable d’environnement DATABASE_CONNECTION_STRING .

   dab init --database-type "<database-type>" --connection-string "@env('DATABASE_CONNECTION_STRING')"
   

   Important

   Certains types de base de données nécessitent des paramètres de configuration supplémentaires lors de l’initialisation.

3. Ajoutez au moins une entité de base de données à la configuration. Utilisez la dab add commande pour configurer une entité. Configurez chaque entité pour autoriser toutes les autorisations pour les utilisateurs anonymes. Répétez dab add autant de fois que vous le souhaitez pour vos entités.

   dab add "<entity-name>" --source "<schema>.<table>" --permissions "anonymous:*"
   

4. Ouvrez et examinez le contenu du fichier dab-config.json . Vous utilisez ce fichier plus loin dans ce guide.

Configuration de l’hôte dans Azure Files

Ensuite, chargez le fichier de configuration dans un partage de fichiers créé dans Azure Files. Ce partage de fichiers est finalement monté sur le conteneur final en tant que volume.

1. Connectez-vous au portail Azure (https://portal.azure.com).

2. Créez un groupe de ressources. Vous allez utiliser ce groupe de ressources pour toutes les nouvelles ressources de ce guide.

   

   Conseil / Astuce

   Nous vous recommandons de nommer le groupe de ressources msdocs-dab-aca. Toutes les captures d’écran de ce guide utilisent ce nom.

3. Créez un compte de stockage Azure. Utilisez ces paramètres pour configurer le compte.

   Réglage	Valeur
   Groupe de ressources	Sélectionnez le groupe de ressources que vous avez créé précédemment
   Nom du compte de stockage	Entrez un nom global unique
   Région	Sélectionner une région Azure
   Niveau de performance	sélectionnez Standard.
   Redondance	Sélectionner Stockage localement redondant (LRS)
   Activer l’accès à la clé du compte de stockage	Sélectionnez Activé

   

4. Accédez au nouveau compte de stockage dans le portail Azure.

5. Sélectionnez Partages de fichiers dans la section Stockage de données du menu de ressources. Ensuite, sélectionnez Partage de fichiers dans la barre de commandes pour créer un partage dans le compte de stockage. Utilisez les paramètres suivants pour configurer le nouveau partage de fichiers.

   Réglage	Valeur
   Nom	Entrez config
   Niveau d’accès	Sélectionnez Favoris
   Activer la sauvegarde	Ne pas sélectionner

   

6. Chargez le dab-config.json et tous les autres fichiers requis dans le partage. Utilisez l’option Charger dans la barre de commandes pour ouvrir la boîte de dialogue Charger des fichiers . Sélectionnez les deux fichiers, puis sélectionnez Charger.

   

7. Sélectionnez les clés d’accès dans la section Sécurité + mise en réseau du menu de ressources. Ensuite, enregistrez le nom du compte de stockage et les valeurs de clé à partir de cette page. Vous utiliserez ces valeurs plus loin dans ce guide.

   

Créer l’application conteneur de base

À présent, créez le conteneur dans Azure à l’aide d’Azure Container Apps. Ce conteneur héberge l’image du générateur d’API de données sans configuration.

1. Créez une ressource Azure Container Apps. Dans le cadre du processus de création de la ressource d’application, vous devez créer un environnement. Utilisez ces paramètres pour configurer les deux ressources.

   Ressource	Réglage	Valeur
   Environment	Nom de l’environnement	Entrez un nom global unique
   Environment	Type d’environnement	Sélectionner consommation uniquement
   Environment	Destination des logs	Sélectionnez Ne pas sauvegarder les logs
   Appli	Groupe de ressources	Sélectionnez le groupe de ressources que vous avez créé précédemment
   Appli	Nom du compte de stockage	Entrez un nom global unique
   Appli	Région	Sélectionnez la même région que le compte de stockage
   Appli	Utiliser l’image de démarrage rapide	Ne pas sélectionner
   Appli	Source de l’image	Sélectionner Docker Hub ou d’autres registres
   Appli	Type d’image	Sélectionnez Public
   Appli	Serveur de connexion au registre	Entrez mcr.microsoft.com
   Appli	Image et étiquette	Entrez azure-databases/data-api-builder:latest
   Appli	Variables d’environnement - Nom	Entrez DATABASE_CONNECTION_STRING
   Appli	Variables d’environnement - Valeur	Entrez la chaîne de connexion de votre base de données.
   Appli	Accès	Vérifiez que Activé est sélectionné
   Appli	Trafic d’entrée	Sélectionner Accepter le trafic n’importe où
   Appli	Mode de certificat client	Sélectionner Ignorer
   Appli	Type d’entrée	Sélectionnez HTTP.
   Appli	Port cible	Entrez 5000

   

   

   Conseil / Astuce

   Nous vous recommandons d’utiliser une chaîne de connexion qui n’inclut pas de clés d’autorisation. Utilisez plutôt des identités managées et un contrôle d’accès en fonction du rôle pour gérer l’accès entre votre base de données et votre hôte. Pour plus d’informations, consultez les services Azure qui utilisent des identités managées.

2. Accédez à la nouvelle application conteneur dans le portail Azure.

3. Utilisez le champ URL de l’application dans la section Essentials pour accéder au site web de l’application conteneur. Observez la réponse indiquant que le conteneur DAB est actif et que l’état est opérationnel.

   {
       "status": "healthy",
       "version": "1.1.7",
       "app-name": "dab_oss_1.1.7"
   }
   

   Remarque

   Le numéro de version et le nom varient en fonction de votre version actuelle du générateur d’API de données. À ce stade, vous ne pouvez pas accéder aux points de terminaison d’API. Ces points de terminaison seront disponibles une fois que vous montez un fichier de configuration DAB.

Monter les fichiers de configuration

Enfin, montez les fichiers de configuration du partage Azure Files vers l’application conteneur. Cette étape permet au générateur d’API de données d’utiliser le fichier de configuration pour se connecter à votre base de données.

1. Accédez à l’environnement de conteneur créé précédemment dans ce guide à l’aide du portail Azure.

2. Sélectionnez les fichiers Azure dans la section Paramètres du menu de ressources. Ensuite, sélectionnez Ajouter à partir de la barre de commandes pour ajouter un partage de fichiers existant à l’environnement de conteneur. Utilisez les paramètres suivants pour configurer le nouveau partage de fichiers. Enregistrez ensuite la nouvelle configuration de partage de fichiers.

   Réglage	Valeur
   Nom	Entrez config-share
   Nom du compte de stockage	Nom du compte de stockage enregistré précédemment dans ce guide.
   Clé du compte de stockage	Clé du compte de stockage enregistré précédemment dans ce guide.
   Partage de fichiers	Entrez config
   Mode d’accès	Sélectionner Lecture seule

   

3. Accédez à nouveau à l’application conteneur dans le portail Azure.

4. Sélectionnez Révisions et réplicas dans la section Application du menu des ressources. Ensuite, sélectionnez Créer une révision à partir de la barre de commandes pour démarrer le processus de configuration d’une nouvelle révision pour votre application conteneur.

5. Accédez à la section Volumes et sélectionnez l’option Ajouter. Utilisez les paramètres suivants pour configurer le nouveau volume. Après avoir configuré le volume, ajoutez le volume à la révision du conteneur.

   Réglage	Valeur
   Type de volume	Sélectionner le volume de fichiers Azure
   Nom	Entrez config-volume
   Partage de fichiers	Entrez config

   

6. Accédez à la section Conteneur , sélectionnez le conteneur actuel unique, puis sélectionnez l’option Modifier . Utilisez les paramètres suivants pour configurer deux montages pour le conteneur. Enregistrer vos modifications.

   Réglage	Valeur
   Nom du volume	Entrez config-volume
   Chemin de montage	Entrez /App/dab-config.json
   Sous-chemin d’accès	Entrez dab-config.json

   Réglage	Valeur
   Nom du volume	Entrez config-volume
   Chemin de montage	Entrez /App/schema.graphql
   Sous-chemin d’accès	Entrez schema.graphql

   

7. Sélectionnez Créer pour créer une révision avec les montages de volume que vous avez spécifiés. Avec la révision pour terminer le déploiement.

8. Utilisez le champ URL de l’application dans la section Essentials pour accéder à nouveau au site web de l’application conteneur. Notez que la réponse indique toujours que le conteneur DAB est sain.

9. Accédez au /api/swagger chemin de l’application en cours d’exécution. Utilisez l’interface utilisateur Swagger pour émettre une requête HTTP GET pour l’une de vos entités.

Nettoyer les ressources

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

1. Accédez au groupe de ressources à l’aide du portail Azure.

2. Dans la barre de commandes, sélectionnez Supprimer.

Étape suivante

Intégrer à Application Insights