Valeurs-clés à un instant donné

Azure App Configuration conserve un enregistrement des modifications apportées aux valeurs clés. Cet enregistrement fournit une chronologie des modifications apportées aux paires clé-valeur. Vous pouvez reconstruire l’historique de n’importe quelle clé et fournir sa valeur passée à tout moment dans la période d’historique des clés (7 jours pour les magasins de niveau Développeur et Gratuit, ou 30 jours pour les magasins de niveau Standard et Premium). À l’aide de cette fonctionnalité, vous pouvez « parcourir le temps » vers l’arrière et récupérer une ancienne valeur clé. Par exemple, vous pouvez récupérer les paramètres de configuration utilisés avant le déploiement le plus récent afin de restaurer l’application dans la configuration précédente.

Restaurer des paires clé-valeur

Vous pouvez utiliser le portail Azure ou Azure CLI pour récupérer les valeurs de clé passées.

portail

1. Connectez-vous au portail Azure. Sélectionnez toutes les ressources, puis sélectionnez l’instance du magasin App Configuration où votre clé-valeur est stockée.

2. Dans le menu Opérations , sélectionnez Restaurer.

   

3. Sélectionnez Date : Sélectionnez la date à laquelle vous souhaitez revenir avec l'heure.

4. Cliquez en dehors des champs de date et d’heure ou appuyez sur Tab pour valider votre choix. Vous pouvez maintenant voir quelles valeurs de clé ont changé entre la date et l’heure sélectionnées et l’heure actuelle. Cette étape vous aide à comprendre les clés et les valeurs auxquelles vous vous préparez à retrouver.

   

   Le portail affiche une table des valeurs clés. La première colonne comprend des symboles indiquant ce qui se passera si vous restaurez les données pour la date et l’heure choisies :

   • Le signe moins rouge (–) signifie que la clé-valeur n’existe pas à votre date et heure sélectionnées et sera supprimée.
   • Le signe plus vert (+) signifie que la valeur clé existait à la date et à l’heure sélectionnées et qu’elle n’existe pas maintenant. Si vous rétablissez la date et l’heure sélectionnées, elle sera ajoutée à votre configuration.
   • Le signe de puce orange (•) signifie que la clé-valeur a été modifiée depuis la date et l’heure sélectionnées. La clé rétablit la valeur qu’elle avait à la date et à l’heure sélectionnées.

5. Activez la case à cocher dans la ligne pour sélectionner ou désélectionner la valeur de clé afin d’agir. Lorsque la valeur est sélectionnée, elle affiche la différence pour la valeur de clé entre les dates et heures actuelles et sélectionnées.

   

   Dans l’exemple ci-dessus, l’aperçu montre la clé TestApp :Settings :BackgroundColor, qui a actuellement une valeur de #FFF. Cette valeur sera modifiée pour #45288E si nous procédons à la restauration des données.

   Vous pouvez sélectionner une ou plusieurs cases à cocher dans le tableau pour prendre des mesures sur la valeur clé de votre choix. Vous pouvez également utiliser la case à cocher "sélectionner tout" en haut de la liste pour sélectionner/désélectionner tous les couples clé-valeur.

6. Sélectionnez Restaurer pour restaurer la ou les valeurs clés sélectionnées sur les données sélectionnées et l’heure.

   

Azure CLI

Utilisez Azure CLI comme expliqué ci-dessous pour récupérer et restaurer les valeurs de clé passées. Si azure CLI n’est pas installé localement, vous pouvez éventuellement utiliser Azure Cloud Shell.

Dans l’interface CLI, utilisez cette option az appconfig revision list pour afficher les modifications ou az appconfig kv restore restaurer des valeurs clés, en ajoutant des paramètres appropriés. Spécifiez l’instance Azure App Configuration en fournissant le nom du magasin (--name <app-config-store-name>) ou à l’aide d’une chaîne de connexion (--connection-string <your-connection-string>). Limitez la sortie en spécifiant un point spécifique dans le temps (--datetime), une étiquette (--label) et le nombre maximal d’éléments à retourner (--top). et en spécifiant le nombre maximal d’éléments à retourner (--top).

Récupérez toutes les modifications enregistrées de vos valeurs de clé.

az appconfig revision list --name <your-app-config-store-name>

Restaurez toutes les paires clé-valeur à un point dans le temps spécifique.

az appconfig kv restore --name <app-config-store-name> --datetime "2019-05-01T11:24:12Z"

Restaurer pour n’importe quelle étiquette commençant par v1. à un point dans le temps spécifique.

az appconfig kv restore --name <app-config-store-name> --label v1.* --datetime "2019-05-01T11:24:12Z"

Pour obtenir d’autres exemples de commandes CLI et de paramètres facultatifs pour restaurer la valeur de clé, consultez la documentation Azure CLI.

Vous pouvez également accéder à l’historique d’une clé-valeur spécifique. Cette fonctionnalité vous permet de vérifier la valeur d’une clé spécifique à un point choisi dans le temps et de revenir à une valeur passée sans mettre à jour aucune autre clé-valeur.

Vue historique/chronologique d’une paire clé-valeur

Conseil / Astuce

Cette méthode est pratique si vous n’avez pas plus de quelques modifications à apporter, car Configuration Explorer vous permet uniquement d’apporter des modifications par clé. Si vous devez restaurer plusieurs valeurs de clé à la fois, utilisez le menu Restaurer à la place.

portail

Vous pouvez également accéder à l’historique de révision d’une clé-valeur spécifique dans le portail.

1. Dans le menu Opérations , sélectionnez Explorateur de configuration.

2. Sélectionnez Plus d’actions pour la clé que vous souhaitez explorer, puis l’historique

   

   Vous pouvez maintenant voir l’historique des révisions de la clé sélectionnée et des informations sur les modifications.

3. Sélectionnez Restaurer pour restaurer la clé et la valeur à ce stade dans le temps.

   

Azure CLI

Utilisez Azure CLI comme expliqué ci-dessous pour récupérer et restaurer une seule clé-valeur. Si azure CLI n’est pas installé localement, vous pouvez éventuellement utiliser Azure Cloud Shell.

Dans l’interface CLI, utilisez az appconfig revision list cette option pour afficher les modifications apportées à une clé-valeur ou az appconfig kv restore pour restaurer une clé-valeur, en ajoutant des paramètres appropriés. Spécifiez l’instance Azure App Configuration en fournissant le nom du magasin (--name <app-config-store-name>) ou à l’aide d’une chaîne de connexion (--connection-string <your-connection-string>). Limitez la sortie en spécifiant une clé spécifique (--key). Si vous le souhaitez, spécifiez une étiquette (--label), un point dans le temps (--datetime) et le nombre maximal d’éléments à retourner (--top).

Listez l’historique des révisions pour la clé « color » avec n'importe quel label.

az appconfig revision list --name <app-config-store-name> --key color

Répertoriez l’historique de révision d’une clé-valeur spécifique avec une étiquette.

az appconfig revision list --name <app-config-store-name> --key color --label test

Répertoriez l’historique de révision d’une clé-valeur avec plusieurs étiquettes.

az appconfig revision list --name <app-config-store-name> --key color --label test,prod,\0

Récupérez toutes les modifications enregistrées pour la clé color à un point précis dans le temps.

az appconfig revision list --name <app-config-store-name> --key color --datetime "2019-05-01T11:24:12Z" 

Récupérez les 10 dernières modifications enregistrées pour la clé color à un moment précis.

az appconfig revision list --name <app-config-store-name> --key color --top 10 --datetime "2019-05-01T11:24:12Z" 

Pour plus d’exemples et de paramètres facultatifs, accédez à la documentation Azure CLI.

Étape suivante

Créer une application web ASP.NET Core