Ajout d’Azure App Configuration à l’aide des services connectés de Visual Studio
Dans ce tutoriel, vous allez apprendre à ajouter facilement tout ce dont vous avez besoin pour commencer à utiliser Azure App Configuration afin de gérer les paramètres de configuration et les indicateurs de fonctionnalités des projets web dans Visual Studio. Quand vous utilisez la fonctionnalité Services connectés de Visual Studio, vous pouvez faire en sorte que Visual Studio ajoute automatiquement l’ensemble du code, des packages NuGet et des paramètres de configuration dont vous avez besoin pour vous connecter à votre ressource App Configuration dans Azure. Pour utiliser cette fonctionnalité, vous devez utiliser Visual Studio 2019 version 16.9 ou ultérieure.
Vous pouvez utiliser la fonctionnalité Services connectés App Configuration dans les types de projets suivants :
- ASP.NET Core
- Console .NET Core
- Projets .NET Framework.
Prérequis
- Visual Studio (voir [téléchargements de Visual Studio] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) avec la charge de travail Développement Azure installée.
- Un projet d’un des types pris en charge
- Un compte Azure. Si vous n’avez pas de compte Azure, activez vos avantages Azure pour les abonnés Visual Studio ou démarrez votre essai gratuit.
Se connecter à Azure App Configuration à l’aide des services connectés
Ouvrez votre projet dans Visual Studio.
Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le nœud Services connectés, puis, dans le menu contextuel, sélectionnez Ajouter un service connecté.
Sous l’onglet Services connectés, sélectionnez l’icône + pour les Dépendances de service.
Dans la page Ajouter une dépendance, sélectionnez Azure App Configuration.
Si vous n’êtes pas déjà connecté, connectez-vous à votre compte Azure. Si vous n’en avez pas, vous pouvez demander un essai gratuit.
Dans l’écran Configurer Azure App Configuration, sélectionnez votre abonnement et un magasin de configuration existant. Sélectionnez ensuite Suivant.
Si vous devez créer un magasin App Configuration, passez à l’étape suivante. Sinon, passez à l’étape 6.
Pour créer un magasin App Configuration :
Sélectionnez l’icône + à droite du titre Magasins App Configuration.
Renseignez la boîte de dialogue Azure App Configuration : Créer, puis sélectionnez Créer. Notez que le champ Nom de la ressource doit être unique.
Quand la boîte de dialogue Azure App Configuration s’affiche, le nouveau magasin de configuration apparaît dans la liste. Sélectionnez ce nouveau magasin, puis sélectionnez Suivant.
Entrez un nom de chaîne de connexion, puis indiquez si vous souhaitez que la chaîne de connexion soit stockée dans un fichier de secrets local ou dans Azure Key Vault.
L’écran Résumé des modifications affiche toutes les modifications qui seront apportées à votre projet si vous terminez le processus. Si les modifications semblent correctes, choisissez Terminer.
À la fin du processus de configuration des dépendances, Azure App Configuration s’affiche sous le nœud Dépendances de service de votre projet.
Ouvrez votre projet dans Visual Studio.
Dans Explorateur de solutions, cliquez avec le bouton de droite sur le nœud Services connectés, puis, dans le menu contextuel, sélectionnez Ajouter pour ouvrir le menu des services disponibles.
Choisissez Azure App Configuration. La page Se connecter à la dépendance s’affiche.
Si vous n’êtes pas déjà connecté, connectez-vous à votre compte Azure. Si vous n’en avez pas, vous pouvez demander un essai gratuit.
Dans l’écran Configurer Azure App Configuration, sélectionnez votre abonnement et un magasin de configuration existant. Sélectionnez ensuite Suivant.
Si vous devez créer un magasin App Configuration, passez à l’étape suivante. Sinon, passez à l’étape 6.
Pour créer un magasin App Configuration :
Sélectionnez l’icône + à droite du titre Magasins App Configuration.
Renseignez la boîte de dialogue Azure App Configuration : Créer, puis sélectionnez Créer. Notez que le champ Nom de la ressource doit être unique.
Quand la boîte de dialogue Azure App Configuration s’affiche, le nouveau magasin de configuration apparaît dans la liste. Sélectionnez ce nouveau magasin, puis sélectionnez Suivant.
Entrez un nom de chaîne de connexion, puis indiquez si vous souhaitez que la chaîne de connexion soit stockée dans un fichier de secrets local ou dans Azure Key Vault.
L’écran Résumé des modifications affiche toutes les modifications qui seront apportées à votre projet si vous terminez le processus. Si les modifications semblent correctes, choisissez Terminer.
À la fin du processus de configuration des dépendances, Azure App Configuration s’affiche sous le nœud Dépendances de service de votre projet.
Dans Explorateur de solutions, double-cliquez sur le nœud Services connectés pour ouvrir l’onglet Services connectés. La connexion apparaît sous la section Dépendances de service :
Il existe également une entrée Secrets.json qui prend en charge le stockage sécurisé de la chaîne de connexion localement. Découvrez comment cela fonctionne dans Capture d’écran montrant le stockage sécurisé des secrets d’application en cours de développement dans ASP.NET Core.
Si vous cliquez sur les trois points en regard des dépendances que vous avez ajoutées, vous pouvez voir différentes options telles que Se connecter pour rouvrir l’Assistant et modifier la connexion et pour Secrets.json, l’option de gestion des secrets. Vous pouvez également cliquer sur les trois points en haut à droite de la fenêtre pour afficher les options permettant de démarrer les dépendances locales, de modifier les paramètres, etc.