Démarrage rapide : Connecter des services Azure et stocker la configuration dans un magasin App Configuration
Azure App Configuration est un service cloud qui fournit un magasin central pour la gestion des paramètres d’application. La configuration stockée dans App Configuration prend naturellement en charge les outils Infrastructure as Code. Lorsque vous créez une connexion de service à l’aide du Connecteur de services, vous pouvez choisir de stocker votre configuration de connexion dans un magasin App Configuration connecté. Dans ce tutoriel, vous allez effectuer les tâches suivantes à l’aide du portail Azure.
- Créer une connexion de service à Azure App Configuration dans Azure App Service
- Créer une connexion de service au Stockage Blob Azure et stocker la configuration dans Azure App Configuration
- Afficher votre configuration dans App Configuration
- Utiliser votre connexion avec les fournisseurs App Configuration
Prérequis
Pour créer une connexion de service et stocker une configuration dans Azure App Configuration avec le Connecteur de services, vous avez besoin des éléments suivants :
- Connaissance de base de l’utilisation du connecteur de services
- Compte Azure avec un abonnement actif. Créez un compte gratuitement.
- Application hébergée sur App Service. Si vous n’en avez pas, créez et déployez une application sur App Service
- Un magasin Azure App Configuration. Si vous n’en avez pas, Créez un magasin App Configuration
- Stockage Blob Azure. Si vous n’en avez pas, créer un Stockage Blob Azure
- Accès en lecture et écriture au service App Service, App Configuration et au service cible.
Créer une connexion App Configuration dans App Service
Pour stocker votre configuration de connexion dans App Configuration, commencez par connecter votre App Service à un magasin App Configuration.
Dans le Portail Microsoft Azure, tapez App Service dans le menu de recherche et sélectionnez le nom de l'App Service que vous souhaitez utiliser dans la liste.
Sélectionnez Connecteur de services dans la table des matières à gauche. Sélectionnez ensuite Créer.
Sélectionnez ou saisissez les paramètres suivants.
Paramètre Valeur suggérée Description Type de service App Configuration Type du service cible. Si vous n’avez pas de magasin App Configuration, vous pouvez le créer. Nom de connexion Nom unique Nom qui permet d’identifier la connexion entre votre instance App Service et le service cible. Abonnement Abonnement du magasin Azure App Configuration. Abonnement dans lequel votre magasin App Configuration est créé. L’abonnement par défaut est l’abonnement répertorié pour App Service. Configuration de l’application Nom de votre App Configuration App Configuration cible auquel vous souhaitez vous connecter. Type de client La même pile d’applications sur cette instance App Service La pile d’applications qui fonctionne avec le service cible que vous avez sélectionné. La valeur par défaut est issue de la pile d’exécution App Service. Sélectionnez Suivant : Authentification pour sélectionner le type d’authentification. Sélectionnez ensuite Identité managée affectée par le système pour connecter votre App Configuration.
Sélectionnez Suivant : mise en réseau pour sélectionner la configuration réseau. Sélectionnez ensuite Configurer des règles de pare-feu pour activer l’accès au service cible lorsque votre App Configuration est ouvert au réseau public par défaut.
Conseil
Le Connecteur de services écrit directement la configuration dans App Configuration. Vous devez donc activer l’accès public App Configuration lors de l’utilisation de cette fonctionnalité.
Sélectionnez ensuite Suivant : Vérifier + créer pour passer en revue les informations fournies. Sélectionnez Créer pour créer la connexion de service. Cette opération peut prendre 1 minute.
Créer une connexion Stockage Blob dans App Service et stocker une configuration dans App Configuration
Vous pouvez maintenant créer une connexion de service à un autre service cible et stocker une configuration dans un service App Configuration connecté au lieu des paramètres d’application. Nous allons utiliser le Stockage Blob comme exemple ci-dessous. Procédez de la même manière pour les autres services cibles.
Dans le Portail Microsoft Azure, tapez App Service dans le menu de recherche et sélectionnez le nom de l'App Service que vous souhaitez utiliser dans la liste.
Sélectionnez Connecteur de services dans la table des matières à gauche. Sélectionnez ensuite Créer.
Sélectionnez ou saisissez les paramètres suivants.
Paramètre Valeur suggérée Description Type de service Stockage – Blob Type du service cible. Si vous n’avez pas de conteneur Stockage Blob, vous pouvez en créer un ou utiliser un autre type de service. Nom de connexion Nom unique Nom qui permet d’identifier la connexion entre votre instance App Service et le service cible. Abonnement L’un de vos abonnements Abonnement dans lequel votre service cible est déployé. Le service cible est celui auquel vous souhaitez vous connecter. L’abonnement par défaut est l’abonnement répertorié pour App Service. Compte de stockage Votre compte de stockage Compte de stockage cible auquel vous souhaitez vous connecter. Si vous choisissez un autre type de service, sélectionnez l’instance de service cible correspondante. Type de client La même pile d’applications sur cette instance App Service La pile d’applications qui fonctionne avec le service cible que vous avez sélectionné. La valeur par défaut est issue de la pile d’exécution App Service. Sélectionnez Suivant : Authentification pour sélectionner le type d’authentification et sélectionner Identité managée affectée par le système pour connecter votre compte de stockage.
Activez Stocker la configuration dans App Configuration pour permettre au connecteur de services de stocker les informations de configuration dans votre magasin App Configuration. Sélectionnez ensuite l’une de vos connexions App Configuration sous Connexion App Configuration.
Sélectionnez Suivant : Mise en réseau et Configurer des règles de pare-feu pour mettre à jour la liste d’autorisation du pare-feu dans le compte de stockage afin que votre App Service puisse atteindre le compte de stockage.
Sélectionnez ensuite Suivant : Vérifier + créer pour passer en revue les informations fournies.
Sélectionnez Créer pour créer la connexion de service. L'opération peut prendre jusqu'à une minute.
Afficher votre configuration dans App Configuration
Développez le stockage - Connexion d’objets blob, sélectionnez Valeur masquée. Cliquez pour afficher la valeur. Vous pouvez voir la valeur de la configuration à partir du magasin App Configuration.
Sélectionnez la colonne Nom de la ressource de votre connexion App Configuration. Vous êtes redirigé vers la page du portail App Configuration.
Sélectionnez Explorateur de configuration dans le menu de gauche d’App Configuration, puis sélectionnez le nom de configuration du stockage d’objets blob.
Cliquez sur Modifier pour afficher la valeur de cette connexion de stockage d’objets blob.
Utiliser votre connexion avec les fournisseurs App Configuration
Azure App Configuration prend en charge plusieurs fournisseurs ou bibliothèques clientes. L’exemple ci-dessous utilise le code .NET. Pour plus d’informations, reportez-vous à la documentation Azure App Configuration
using Azure.Identity;
using Azure.Storage.Blobs;
using Microsoft.Extensions.Configuration;
var credential = new ManagedIdentityCredential();
var builder = new ConfigurationBuilder();
builder.AddAzureAppConfiguration(options => options.Connect(new Uri(Environment.GetEnvironmentVariable("AZURE_APPCONFIGURATION_RESOURCEENDPOINT")), credential));
var config = builder.Build();
var storageConnectionName = "UserStorage";
var blobServiceClient = new BlobServiceClient(new Uri(config[$"AZURE_STORAGEBLOB_{storageConnectionName.ToUpperInvariant()}_RESOURCEENDPOINT"]), credential);
Nettoyer les ressources
Quand vous n’en avez plus besoin, supprimez le groupe de ressources et toutes les ressources créées pour ce tutoriel. Pour ce faire, sélectionnez le groupe de ressources ou les ressources individuelles que vous avez créées, puis sélectionnez Supprimer.