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.

Notes

Cette rubrique s’applique à Visual Studio sur Windows. Pour Visual Studio pour Mac, consultez Services connectés dans Visual Studio pour Mac.

Prérequis

Se connecter à Azure App Configuration à l’aide des services connectés

  1. Ouvrez votre projet dans Visual Studio.

  2. 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é.

    Screenshot showing

  3. Sous l’onglet Services connectés, sélectionnez l’icône + pour les Dépendances de service.

    Screenshot showing

  4. Dans la page Ajouter une dépendance, sélectionnez Azure App Configuration.

    Screenshot showing

    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.

  5. 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.

    Screenshot showing

  6. Pour créer un magasin App Configuration :

    1. Sélectionnez l’icône + à droite du titre Magasins App Configuration.

    2. 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.

      Screenshot showing New Azure app config store.

    3. 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.

  7. 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.

    Screenshot showing

  8. 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.

    Screenshot showing summary of changes.

  9. À 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.

  1. Ouvrez votre projet dans Visual Studio.

  2. 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.

    Screenshot showing Connected Services context menu options.

  3. Choisissez Azure App Configuration. La page Se connecter à la dépendance s’affiche.

    Screenshot showing Connect to dependency for 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.

  4. 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.

    Screenshot showing 'Add existing configuration account to project

  5. Pour créer un magasin App Configuration :

    1. Sélectionnez l’icône + à droite du titre Magasins App Configuration.

    2. 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.

      Screenshot showing new Azure app config store.

    3. 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.

  6. 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.

    Screenshot showing

  7. 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.

    Screenshot showing summary of changes.

    À 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.

  8. 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 :

    Screenshot of Service Dependencies section showing Azure App Configuration connection.

    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.