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. Un instantané est un ensemble de paramètres d'App Configuration stockés dans un état immuable.

Conditions préalables

• Un magasin App Configuration, comme illustré dans le didacticiel pour la création d’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 de clé au magasin de configuration d’application

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

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

Créer un instantané

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

1. Entrez un nom d’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 différentes étiquettes, seule la valeur de clé spécifiée dans le dernier filtre applicable est incluse dans l’instantané. Les valeurs de clé identiques avec d’autres étiquettes sont exclues de l’instantané.
   • Avec le type de composition Key-Label, si votre magasin dispose de clés identiques avec des étiquettes différentes, toutes les valeurs de clés avec des clés identiques mais des étiquettes distinctes 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 est effectué en sélectionnant des filtres : Égal, Commence par, n'importe lequel 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 Démarrer avec et entrer l’application1
      • Sous Étiquette, sélectionnez Égal à et sélectionnez label2 dans le menu déroulant.
   2. Ajoutez le deuxième filtre :
      • Sous Clé, sélectionnez Démarrer avec et entrer l’application1
      • Sous Étiquette, sélectionnez Equals et sélectionnez label1 dans le menu déroulant.

4. Si vous archivez un instantané, par défaut, il sera conservé pendant 30 jours après l’archivage. Si vous le souhaitez, sous Options de récupération, diminuez le nombre de jours de rétention pendant lesquels l’instantané sera disponible après l’archivage.

   Remarque

   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 de clé et les filtres ci-dessous :

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

   

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

   Clé	Valeur	Étiquette	Inclus dans l’instantané
   app2/bgcolor	Gris clair	label2	Non : ne commence pas par app1.
   app1/color	noir	Aucune étiquette	Non, n’a pas l’étiquette label2 ou label1.
   app1/color	Bleu	label1	Oui : a l’étiquette appropriée label1 à partir du dernier filtre applicable.
   app1/color	Vert	label2	Non : la même clé que l’étiquette 1 sélectionnée par le deuxième filtre remplace celle-ci, bien qu’elle ait l’étiquette sélectionnée, étiquette2.
   app1/color	Jaune	label3	Non, n’a pas l’étiquette label2 ou label1.
   app1/message	Bonjour	label1	Oui : a l’étiquette appropriée label1 à partir du dernier filtre applicable.
   app1/message	Salut!	label2	Non : la même clé que l’étiquette 1 sélectionnée par le deuxième filtre remplace celle-ci, bien qu’elle ait l’étiquette sélectionnée, étiquette2.
   app2/message	Bonjour!	label1	Non : ne commence pas par app1.

Créer des instantanés d'échantillons

Pour créer des exemples d’instantanés et vérifier le fonctionnement de la fonctionnalité d’instantanés, utilisez le bac à sable d’instantané. 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 capture instantanée.

1. Dans Opérations>Snapshots>Snapshots actifs, sélectionnez Tester dans le bac à sable.
2. Passez en revue les exemples de données et pratiquez la création d’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 l’exemple d’instantané.
4. Consultez le résultat de l’instantané généré sous Exemple d’instantané généré. L’exemple d’instantané affiche toutes les clés incluses dans l’exemple d’instantané, en fonction de votre sélection.

Utiliser des instantanés

Vous pouvez sélectionner n’importe quel nombre d’instantanés pour la configuration de l’application. La sélection d’un instantané ajoute toutes ses valeurs de clé. Une fois ajoutées à une configuration, les valeurs clés des captures instantanées sont traitées de la même façon que toute autre valeur clé.

Si vous disposez d’une application à l’aide d’Azure App Configuration, vous pouvez la mettre à jour avec l’exemple de code suivant pour utiliser des instantanés. Vous devez uniquement fournir 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 principale ASP.NET avec Azure App Configuration.

Ajouter des instantanés à votre configuration

configurationBuilder.AddAzureAppConfiguration(options =>
{
    string endpoint = Environment.GetEnvironmentVariable("Endpoint"); 
    options.Connect(new Uri(endpoint), new DefaultAzureCredential());
    // 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

Python

Modifiez l’appel à la load méthode dans votre application. Si vous n’avez pas d’application, vous pouvez référencer le guide de démarrage rapide Python pour Azure App Configuration.

Ajouter des instantanés à votre configuration

from azure.appconfiguration.provider import load, SettingSelector
from azure.identity import DefaultAzureCredential
import os

endpoint = os.environ["APPCONFIGURATION_ENDPOINT_STRING"]

# Load configuration settings from a snapshot
config = load(
    endpoint=endpoint,
    credential=DefaultAzureCredential(),
    selects=[SettingSelector(snapshot_name="SnapshotName")]
)

Remarque

La prise en charge des instantanés est disponible si vous utilisez la version 2.3.0 ou ultérieure du azure-appconfiguration-provider package.

Printemps

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

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

Remarque

Tout préfixe /application/ qui est automatiquement supprimé lors de l’utilisation d’un filtre de clés doit être spécifié pour les instantanés, sinon ils ne seront pas correctement mappés aux classes @ConfigurationProperties correctes. La prise en charge des instantanés 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 Key composition peuvent être chargés à l’aide des exemples de code indiqué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 Captures instantanées actives pour afficher la liste de tous les instantanés actifs dans un magasin App Configuration.

Afficher l’instantané existant

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 de détails d’instantané qui affiche les paramètres de l’instantané et les valeurs clés incluses dans l’instantané.

Archiver un instantané

Sous l’onglet Instantanés actifs , sélectionnez les points de suspension ... à droite d’un instantané existant et sélectionnez Archiver pour archiver un instantané. Confirmez l’archivage en sélectionnant Oui ou Annuler avec 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 à Operations>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 l’instantané archivé

La vue détaillée de l’instantané est également disponible dans l’état d’archivage. 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 de détails d’instantané qui affiche les paramètres de l’instantané et les valeurs clés incluses dans l’instantané.

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

Captures instantanées dans Azure App Configuration