Gérer et utiliser des instantanés

Dans cet article, découvrez comment créer, utiliser et gérer des instantanés dans Azure App Configuration. L’instantané est un ensemble de paramètres d’App Configuration stockés dans un état immuable.

Prérequis

• Un magasin App Configuration. Créez un magasin.
• Rôle « DataOwner « dans le magasin App Configuration. Détails sur le rôle et les autorisations requis pour les instantanés

Ajouter des valeurs clés au magasin de configuration des applications

Dans votre magasin de App Configuration, accédez àOpérations>Explorateur de configurations et ajoutez les valeurs clés suivantes. Laissez la valeur par défaut de type de contenu. Pour plus d’informations sur l’ajout de clés-valeurs à un magasin avec le Portail Azure ou l’interface CLI, consultez Création d’une clé-valeur.

Clé	Valeur	Étiquette
app2/bgcolor	Gris clair	label2
app1/color	Noir	Sans étiquette
app1/color	Bleu	label1
app1/color	Vert	label2
app1/color	Jaune	label3
app1/message	Bonjour	label1
app1/message	Bonjour !	label2
app2/message	Bonjour !	label1

Créer un instantané

Sous Opérations>Instantanés, sélectionnez Créer un instantané.

1. Entrez un nom de l’instantané et ajoutez éventuellement des balises.

2. Sous Choisir le type de composition, conservez la valeur par défaut Clé (par défaut) .

   • Avec le type de composition de clé, si votre magasin a des clés identiques avec des étiquettes différentes, seule la valeur clé spécifiée dans le dernier filtre applicable est incluse dans l’instantané. Les valeurs de clé identiques avec d’autres étiquettes sont laissées en dehors de la instantané.
   • Avec le type de composition Key-Label, si votre magasin a des clés identiques avec des étiquettes différentes, toutes les valeurs de clé avec des clés identiques, mais des étiquettes différentes sont incluses dans l’instantané en fonction des filtres spécifiés.

3. Sélectionnez Ajouter des filtres pour sélectionner les valeurs clés de votre instantané. Le filtrage s’effectue en sélectionnant filtres : Égal à, Commence par, Tout de et Tous pour les clés et pour les étiquettes. Vous pouvez entrer entre un et trois filtres.

   1. Ajoutez le premier filtre :
      • Sous Clé, sélectionnez Commence par et entrez app1
      • Sous Étiquette, sélectionnez Égal à, puis étiquette2 dans le menu déroulant.
   2. Ajoutez le deuxième filtre :
      • Sous Clé, sélectionnez Commence par et entrez app1
      • Sous Étiquette, sélectionnez Égal à, puis label1 dans le menu déroulant.

4. Si vous archivez un instantané, il sera conservé, par défaut, pendant 30 jours après l’archivage. Si vous le souhaitez, sous Options de récupération, réduisez le nombre de jours de rétention où les instantanés seront disponibles après l’archivage.

   Notes

   La durée de la période de rétention ne peut pas être mise à jour une fois l’instantané créé.

5. Sélectionnez Créer pour générer l’instantané. Dans cet exemple, l’instantané créé a le type de composition Key et les filtres ci-dessous :

   • Clés qui commencent par app1, avec l’étiquette label2
   • Clés qui commencent par app1, avec l’étiquette label1.

   

6. Vérifiez la table pour comprendre quelles clés-valeurs du magasin de configuration se retrouvent dans l’instantané en fonction des paramètres fournis.

   Clé	Valeur	Étiquette	Inclus dans instantané
   app2/bgcolor	Gris clair	label2	Non : ne commence pas par app1.
   app1/color	Noir	Sans étiquette	Non : ne dispose pas de l’étiquette label2 ou label1.
   app1/color	Bleu	label1	Oui : dispose de l’étiquette label1 appropriée à partir du dernier des filtres applicables.
   app1/color	Vert	label2	Non : la même clé avec étiquette label1 sélectionnée par le deuxième filtre remplace celle-ci bien qu’elle ait l’étiquette sélectionnée, label2.
   app1/color	Jaune	label3	Non : ne dispose pas de l’étiquette label2 ou label1.
   app1/message	Bonjour	label1	Oui : dispose de l’étiquette label1 appropriée à partir du dernier des filtres applicables.
   app1/message	Bonjour !	label2	Non : la même clé avec étiquette label1 sélectionnée par le deuxième filtre remplace celle-ci bien qu’elle ait l’étiquette sélectionnée, label2.
   app2/message	Bonjour !	label1	Non : ne commence pas par app1.

Créer des exemples d’instantanés

Pour créer des exemples d’instantanés et vérifier le fonctionnement de la fonctionnalité d’instantanés, utilisez le bac à sable des instantanés. Ce bac à sable contient des exemples de données que vous pouvez utiliser pour mieux comprendre le fonctionnement du type de composition et des filtres de l’instantané.

1. Dans Opérations>Instantanés>Instantanés actifs, sélectionnez Tester dans le bac à sable.
2. Passez en revue les exemples de données et entraînez-vous à créer des instantanés en remplissant le formulaire avec un type de composition et un ou plusieurs filtres.
3. Sélectionnez Créer pour générer un exemple d’instantané.
4. Consultez le résultat de l’instantané généré sous Exemple d’instantané généré. L’exemple de l’instantané affiche toutes les clés incluses dans l’exemple en fonction de votre sélection.

Utiliser la fonctionnalité de capture instantanée

Vous pouvez sélectionner un nombre quelconque d'instantanés pour la configuration de l'application. La sélection d’un instantané ajoute toutes ses valeurs clés. Une fois ajoutées à une configuration, les valeurs clés des instantanés sont traitées de la même manière que n'importe quelle autre valeur clé.

Si vous disposez d’une application qui utilise Azure App Configuration, vous pouvez la mettre à jour avec l’exemple de code suivant pour utiliser les instantanés. Il suffit d’indiquer le nom de l’instantané, qui respecte la casse.

.NET

Modifiez l’appel à la méthode AddAzureAppConfiguration, qui se trouve souvent dans le fichier Program.cs de votre application. Si vous n’avez pas d’application, vous pouvez référencer l’un des guides de démarrage rapide .NET, comme la création d’une application de base ASP.NET avec Azure App Configuration.

Ajouter des instantanés à votre configuration

configurationBuilder.AddAzureAppConfiguration(options =>
{
    options.Connect(Environment.GetEnvironmentVariable("ConnectionString"));

    // Select an existing snapshot by name. This will add all of the key-values from the snapshot to this application's configuration.
    options.SelectSnapshot("SnapshotName");
    
    // Other changes to options
});

Remarque

La prise en charge des instantanés est disponible si vous utilisez la version 7.0.0 ou ultérieure de l’un des packages suivants.

• Microsoft.Extensions.Configuration.AzureAppConfiguration
• Microsoft.Azure.AppConfiguration.AspNetCore
• Microsoft.Azure.AppConfiguration.Functions.Worker

Spring

Mettez à jour le fichier bootstrap.yml de votre application avec les configurations suivantes.

spring:
  cloud:
    azure:
      appconfiguration:
        stores:
         -
           endpoint: <your-endpoint>
           selects:
             -
              snapshot-name: <name-of-your-snapshot>
           trim-key-prefix: 
             - <prefix-to-trim>

Remarque

Tout préfixe comme /application/ qui est automatiquement tronqué lors de l’utilisation d’un filtre de clé doit être spécifié pour les instantanés sans quoi ils ne sont pas correctement mappés aux classes @ConfigurationProperties appropriées. La prise en charge de l’instantané est disponible si vous utilisez la version 4.12.0-beta.1/5.6.0-beta.1 ou ultérieure de l’un des packages suivants.

• spring-cloud-azure-appconfiguration-config
• spring-cloud-azure-appconfiguration-config-web
• spring-cloud-azure-starter-appconfiguration-config

Remarque

Seuls les instantanés créés avec le type de composition Key peuvent être chargés à l’aide des exemples de code présentés ci-dessus.

Gérer les instantanés actifs

La page sous Opérations>Instantanés affiche deux onglets : Instantanés actifs et Instantanés archivés. Sélectionnez Instantanés actifs pour afficher la liste de tous les instantanés actifs dans un magasin App Configuration.

Afficher les instantané existants

Sous l’onglet Instantanés actifs, sélectionnez les points de suspension ... à droite d’un instantané existant, puis sélectionnez Affichage pour afficher un instantané. Cette action ouvre une page détails de l’instantané qui affiche ses paramètres et ses valeurs de clé incluses.

Archiver un instantané

Sous l’onglet Instantanés actifs, sélectionnez les points de suspension ... à droite d’un instantané existant, puis sélectionnez Archiver pour archiver un instantané. Confirmez l’archivage en sélectionnant Oui ou annulez en sélectionnant Non. Une fois qu’un instantané a été archivé, une notification s’affiche pour confirmer l’opération et la liste des instantanés actifs est mise à jour.

Gérer les instantanés archivés

Accédez à Opérations>Instantanés>Instantanés archivés pour afficher la liste de tous les instantanés archivés dans un magasin App Configuration. Les instantanés archivés restent accessibles pendant la période de rétention sélectionnée lors de leur création.

Afficher les instantané archivés

Une vue détaillée de l’instantané est également disponible dans l’état archive. Sous l’onglet Instantanés archivés, sélectionnez les points de suspension ... à droite d’un instantané existant, puis sélectionnez Affichage pour afficher un instantané. Cette action ouvre une page détails de l’instantané qui affiche ses paramètres et ses valeurs de clé incluses.

Récupérer un instantané archivé

Sous l’onglet Instantanés archivés, sélectionnez les points de suspension ... à droite d’un instantané archivé, puis sélectionnez Récupérer pour récupérer un instantané. Une fois qu’un instantané a été récupéré, une notification s’affiche pour confirmer l’opération et la liste des instantanés archivés est mise à jour.

Étapes suivantes

Instantanés dans Azure App Configuration