Démarrage rapide : Créer une application .NET Core avec App Configuration

Dans ce guide de démarrage rapide, vous intégrez Azure App Configuration dans une application console .NET Core pour centraliser le stockage et la gestion des paramètres d’application en dehors de votre code.

Prérequis

Créer un magasin App Configuration

  1. Pour créer un magasin App Configuration, connectez-vous au portail Azure. En haut à gauche de la page d’accueil, sélectionnez Créer une ressource. Dans la zone Rechercher dans la Place de marché, entrez App Configuration et sélectionnez Entrée.

    Rechercher App Configuration

  2. Sélectionnez Configuration d’application dans les résultats de la recherche, puis Créer.

    Sélectionner Créer

  3. Dans le volet Créer une ressource App Configuration, entrez les paramètres suivants :

    Paramètre Valeur suggérée Description
    Abonnement Votre abonnement Sélectionnez l’abonnement Azure à utiliser pour tester App Configuration. Si votre compte n’a qu’un seul abonnement, il est automatiquement sélectionné et la liste Abonnement n’est pas affichée.
    Groupe de ressources AppConfigTestResources Sélectionnez ou créez un groupe de ressources pour votre ressource du magasin App Configuration. Ce groupe est utile pour organiser plusieurs ressources que vous souhaitez supprimer en même temps que vous supprimez ce groupe de ressources. Pour plus d’informations, consultez Utilisation des groupes de ressources pour gérer vos ressources Azure.
    Nom de la ressource Nom globalement unique Entrez un nom de ressource unique à utiliser pour la ressource du magasin App Configuration. Le nom doit être une chaîne de 5 à 50 caractères. Il doit contenir uniquement des chiffres, des lettres et le caractère -. Le nom ne peut ni commencer ni finir par le caractère -.
    Lieu USA Centre Utilisez Emplacement pour indiquer l’emplacement géographique de l’hébergement de votre magasin de configuration d’application. Pour des performances optimales, créez la ressource dans la même région que les autres composants de votre application.
    Niveau tarifaire Gratuit Sélectionnez le niveau tarifaire souhaité. Pour plus d’informations, consultez la page de tarification App Configuration.
  4. Sélectionnez Vérifier + créer pour valider vos paramètres.

  5. Sélectionnez Create (Créer). Le déploiement peut prendre quelques minutes.

  6. Une fois le déploiement terminé, accédez à la ressource App Configuration. Sélectionnez Paramètres > Clés d’accès. Notez la chaîne de connexion de la clé primaire en lecture seule. Vous utilisez cette chaîne de connexion plus tard pour configurer votre application, afin qu’elle communique avec le magasin App Configuration que vous avez créé.

  1. Sélectionnez Explorateur de configurations > Créer > Clé-valeur pour ajouter les paires clé-valeur suivantes :

    Clé Valeur
    TestApp:Settings:Message Data from Azure App Configuration

    Laissez Étiquette et Type de contenu vides pour l’instant.

  2. Sélectionnez Appliquer.

Créer une application console .NET Core

Vous utilisez l’interface de ligne de commande (CLI) .NET Core pour créer un projet d’application console .NET Core. Par rapport à Visual Studio, l’interface CLI .NET Core offre l’avantage d’être disponible sur les plateformes Windows, macOS et Linux. Vous pouvez également utiliser les outils préinstallés qui sont disponibles dans Azure Cloud Shell.

  1. Créez un nouveau dossier pour votre projet.

  2. Dans le nouveau dossier, exécutez la commande suivante pour créer un projet d’application console .NET Core :

    dotnet new console
    

Se connecter à un magasin App Configuration

  1. Ajoutez une référence au package NuGet Microsoft.Extensions.Configuration.AzureAppConfiguration en exécutant la commande suivante :

    dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
    
  2. Exécutez la commande suivante pour restaurer les packages de votre projet :

    dotnet restore
    
  3. Ouvrez Program.cs, puis ajoutez une référence au fournisseur App Configuration .NET Core.

    using Microsoft.Extensions.Configuration;
    using Microsoft.Extensions.Configuration.AzureAppConfiguration;
    
  4. Mettez à jour la méthode Main pour utiliser App Configuration en appelant la méthode builder.AddAzureAppConfiguration().

    static void Main(string[] args)
    {
        var builder = new ConfigurationBuilder();
        builder.AddAzureAppConfiguration(Environment.GetEnvironmentVariable("ConnectionString"));
    
        var config = builder.Build();
        Console.WriteLine(config["TestApp:Settings:Message"] ?? "Hello world!");
    }
    

Générer et exécuter l’application localement

  1. Définissez une variable d’environnement nommée ConnectionString et affectez-lui la valeur de la clé d’accès à votre magasin App Configuration. Sur la ligne de commande, exécutez la commande suivante :

    setx ConnectionString "connection-string-of-your-app-configuration-store"
    

    Si vous utilisez Windows PowerShell, exécutez la commande suivante :

    $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
    

    Si vous utilisez macOS ou Linux, exécutez la commande suivante :

    export ConnectionString='connection-string-of-your-app-configuration-store'
    

    Redémarrez l’invite de commandes pour que la modification soit prise en compte. Imprimez la valeur de la variable d’environnement pour confirmer qu’elle est correctement définie.

  2. Exécutez la commande suivante pour générer l’application console :

    dotnet build
    
  3. La génération terminée correctement, lancez la commande suivante pour exécuter l’application localement :

    dotnet run
    

Nettoyer les ressources

Si vous ne souhaitez plus utiliser les ressources créées dans cet article, supprimez le groupe de ressources que vous avez créé ici afin d’éviter des frais.

Important

La suppression d’un groupe de ressources est irréversible. Le groupe de ressources et toutes les ressources qu’il contient sont supprimés définitivement. Veillez à ne pas supprimer accidentellement les mauvaises ressources ou le mauvais groupe de ressources. Si vous avez créé les ressources pour cet article dans un groupe de ressources contenant d’autres ressources que vous souhaitez conserver, supprimez chaque ressource individuellement à partir de son volet, au lieu de supprimer l’intégralité du groupe de ressources.

  1. Connectez-vous au portail Azure, puis sélectionnez Groupes de ressources.
  2. Dans la zone Filtrer par nom, entrez le nom de votre groupe de ressources.
  3. Dans la liste de résultats, sélectionnez le nom du groupe de ressources pour afficher une vue d’ensemble.
  4. Sélectionnez Supprimer le groupe de ressources.
  5. Vous êtes invité à confirmer la suppression du groupe de ressources. Entrez le nom de votre groupe de ressources à confirmer, puis sélectionnez Supprimer.

Après quelques instants, le groupe de ressources et toutes ses ressources sont supprimés.

Étapes suivantes

En suivant ce guide de démarrage rapide, vous avez créé un magasin App Configuration et l’avez utilisé avec une application console .NET Core par l’intermédiaire du fournisseur App Configuration. Pour savoir comment configurer votre application .NET Core afin d’actualiser dynamiquement les paramètres de configuration, passez au tutoriel suivant.