Instantanés
Un instantané est un sous-ensemble nommé et immuable des valeurs clés d’un magasin de App Configuration. Les valeurs clés qui composent un instantané sont choisies au moment de la création via l’utilisation de filtres de clé et d’étiquette. Une fois qu’un instantané est créé, les valeurs clés à l’intérieur sont assurés de rester inchangées.
Une rapide vue d’ensemble est disponible dans cette vidéo, qui met en avant trois raisons pour lesquelles les instantanés peuvent vous être utiles.
Déployer en toute sécurité avec des instantanés
Les instantanés sont conçus pour déployer les modifications de configuration en toute sécurité. Déployer des modifications défectueuses de la configuration dans un environnement en cours d’exécution peut entraîner des problèmes tels que l’interruption du service et la perte de données. Pour éviter de tels problèmes, il est important de pouvoir examiner les modifications de la configuration avant de passer aux environnements de production. Si un tel problème se produit, il est important de pouvoir restaurer les modifications défectueuses de la configuration afin de restaurer le service. Des instantanés sont créés pour gérer ces scénarios.
Les modifications de la configuration doivent être déployées de manière contrôlée et cohérente. Les développeurs peuvent utiliser des instantanés pour effectuer un déploiement contrôlé. La seule modification nécessaire dans une application pour commencer un déploiement contrôlé consiste à mettre à jour le nom du instantané auquel l’application fait référence. À mesure que l’application passe en production, la configuration dans le instantané référencé est assurée de rester inchangée. Cette garantie contre toute modification d’un instantané protège contre les paramètres inattendus qui entrent en production. L’immuabilité et la facilité de référence des instantanés facilitent le déploiement sécurisé du bon ensemble de modifications de configuration.
Scénarios d’utilisation des instantanés
Déploiement contrôlé : les instantanés sont bien adaptés à la prise en charge du déploiement contrôlé en raison de leur nature immuable. Lorsque les développeurs utilisent des instantanés pour la configuration, ils peuvent être sûrs que la configuration reste inchangée au fur et à mesure que la version progresse au fil des différentes phases du déploiement.
Dernière configuration LKG (Last Known Good) : les instantanés peuvent être utilisés pour prendre en charge des pratiques de déploiement sécurisées pour la configuration. Avec les instantanés, les développeurs peuvent s’assurer qu’une configuration LKG (Last known Good) est disponible pour la restauration en cas de problème pendant le déploiement.
Contrôle de version de configuration : les instantanés peuvent être utilisés pour créer un historique des versions des paramètres de configuration à synchroniser avec les versions mises en production. Les paramètres capturés dans chaque instantané peuvent être comparés pour identifier les modifications entre les versions.
Audit : les instantanés peuvent être utilisés à des fins d’audit et de conformité. Les développeurs peuvent conserver un enregistrement des modifications de configuration entre les versions en utilisant des instantanés lors des mises en production.
Environnements intermédiaires et de test : les instantanés peuvent être utilisés pour créer des environnements intermédiaires et de test. Les développeurs peuvent s’assurer que la même configuration est utilisée dans différents environnements en utilisant les mêmes instantanés, ce qui peut vous aider à déboguer et à tester.
Composition simplifiée de la configuration du client : en règle générale, les clients d’App Configuration ont besoin d’un sous-ensemble des valeurs clés de l’instance d’App Configuration. Pour obtenir l’ensemble des valeurs de clé requises, ils doivent disposer d’une logique de requête écrite dans du code. Comme les instantanés permettent de fournir de filtres au moment de la création, cela permet de simplifier la composition du client, étant donné qu’ils peuvent désormais se référer à l’ensemble de valeurs clés dont ils ont besoin par nom.
Opérations d’instantané
Étant donné que les instantanés sont des entités immuables, ceux-ci ne peuvent être que créés et archivés. Aucune suppression, purge ou modification n’est possible.
Créer des instantané : vous pouvez créer des instantanés en définissant les filtres de clé et d’étiquette pour capturer les valeurs de clé requises à partir de l’instance d’App Configuration. Les clés-valeurs filtrées sont stockées en tant que instantané avec le nom fourni lors de la création.
Archiver un instantané : l’archivage d’un instantané le place dans un état archivé. Bien qu’un instantané soit archivé, il est toujours entièrement fonctionnel. Lorsque le instantané est archivé, un délai d’expiration est défini en fonction de la période de rétention configurée lors de la création de l’instantané. Si l’instantané reste à l’état archivé jusqu’au délai d’expiration, il disparaît automatiquement du système lorsque le délai d’expiration s’écoule. L’archivage est utilisé pour supprimer progressivement les instantanés qui ne sont plus utilisés.
Récupérer un instantané : la récupération d’un instantané le remet à l’état actif. À ce stade, l’instantané n’est plus soumis à l’expiration en fonction de sa période de rétention configurée. La récupération n’est possible que pendant la période de rétention après l’archivage.
Notes
La période de rétention ne peut être définie que lors de la création d’un instantané. La valeur par défaut pour la période de rétention est de 30 jours pour les stockages standards et de 7 jours pour les stockages gratuits.
Conditions requises pour les opérations d’instantané
Les sections suivantes détaillent les autorisations nécessaires pour effectuer des opérations liées aux instantanés avec les authentifications Microsoft Entra ID et HMAC.
Créer un instantané
Pour créer un instantané dans des magasins à l’aide de l’authentification Microsoft Entra, les autorisations suivantes sont requises. Le rôle propriétaire des données d’App Configuration dispose déjà de ces autorisations.
Microsoft.AppConfiguration/configurationStores/keyvalues/readMicrosoft.AppConfiguration/configurationStores/snapshots/write
Pour créer une capture instantanée à l’aide de l’authentification HMAC, une clé d’accès en lecture-écriture doit être utilisée.
Archiver et récupérer un instantané
Pour archiver et/ou récupérer un instantané à l’aide de l’authentification Microsoft Entra, l’autorisation suivante est nécessaire. Le rôle propriétaire des données d’App Configuration dispose déjà de cette autorisation.
Microsoft.AppConfiguration/configurationStores/snapshots/archive/action
Pour archiver et/ou récupérer un instantané à l’aide de l’authentification HMAC, une clé d’accès en mode lecture-écriture doit être utilisée.
Lecture et liste des instantanés
Pour répertorier tous les instantanés ou obtenir toutes les clés-valeurs d’un instantané par nom, l’autorisation suivante est nécessaire pour les magasins utilisant l’authentification Microsoft Entra. Les rôles propriétaire de données et lecteur de données intégrés disposent déjà de cette autorisation.
Microsoft.AppConfiguration/configurationStores/snapshots/read
Pour les stockages qui utilisent l’authentification HMAC, l’opération « lecture d’instantané » (pour lire les valeurs de clé à partir d’un instantané) et l’opération « lister des instantanés » peuvent être effectuées à l’aide des clés d’accès en mode lecture-écriture ou des clés d’accès en mode lecture seule.
Considérations et limites de facturation
App Configuration dispose de deux niveaux, gratuit et standard. Vérifiez les détails suivants pour les quotas d’instantanés dans chaque niveau.
Niveau gratuit : ce niveau a un quota de stockage instantané de 10 Mo. Vous pouvez créer autant d’instantanés que possible tant que la taille de stockage totale de tous les instantanés actifs et archivés est inférieure à 10 Mo.
Niveau standard : ce niveau a un quota de stockage instantané de 1 Go. Vous pouvez créer autant d’instantanés que possible tant que la taille de stockage totale de tous les instantanés actifs et archivés est inférieure à 1 Go.
La taille maximale d’un instantané est de 1 Mo.