Instantanés

Un instantané est un sous-ensemble nommé et immuable des valeurs clés d’un magasin 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éé, ses valeurs clés sont assurées de rester inchangées.

Une vue d’ensemble sommaire 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é. Le déploiement de 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, vous devez pouvoir examiner les modifications de la configuration avant de passer aux environnements de production. Si un tel problème se produit, vous devez 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 lancement contrôlé. La seule modification nécessaire dans une application pour commencer un lancement contrôlé consiste à mettre à jour le nom de l’instantané auquel l’application fait référence. À mesure que l’application passe en production, la configuration dans l’instantané référencé est assurée de rester inchangée. Cette garantie contre toute modification d’un instantané protège contre des paramètres inattendus qui entreraient 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

• Lancement contrôlé : les instantanés sont bien adaptés à la prise en charge du lancement 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 à mesure que la version progresse au fil des différentes phases du lancement.

• Dernière bonne configuration connue (LKG) : les instantanés peuvent être utilisés pour prendre en charge des pratiques de déploiement sécurisées pour la configuration. Grâce aux instantanés, les développeurs peuvent s’assurer qu’une configuration LKG 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 circulation. 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 de version.

• 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 des filtres au moment de la création, cela permet de simplifier la composition du client, étant donné que les clients peuvent désormais se référer par nom à l’ensemble de valeurs clés dont ils ont besoin.

Opérations d’instantanés

Étant donné que les instantanés sont des entités immuables, ils peuvent uniquement être créés et archivés. On ne peut pas les supprimer, purger ou modifier.

• Créer un 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 qu’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 reste entièrement fonctionnel. Lorsque l’instantané est archivé, un délai d’expiration est défini en fonction de la période de rétention configurée lors de sa création. Si l’instantané reste à l’état archivé jusqu’au délai d’expiration, il disparaît automatiquement du système une fois le délai d’expiration écoulé. 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.

Conditions requises pour les opérations d’instantanés

Les sections suivantes explicitent les autorisations requises 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 avec l’authentification Microsoft Entra, les autorisations suivantes sont requises. Le rôle de propriétaire des données d’App Configuration dispose déjà de ces autorisations.

• Microsoft.AppConfiguration/configurationStores/keyvalues/read
• Microsoft.AppConfiguration/configurationStores/snapshots/write

Pour créer un instantané à 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 de 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.

Lire et afficher des instantanés

Pour afficher tous les instantanés ou obtenir toutes les clés-valeurs d’un instantané par nom, l’autorisation suivante est requise pour les magasins utilisant l’authentification Microsoft Entra. Les rôles de propriétaire de données et de 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, les opérations « lire l’instantané » (pour lire les valeurs de clé à partir d’un instantané) et « afficher les instantanés » peuvent être effectuées avec 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 a quatre niveaux : Gratuit, Développeur, Standard et Premium. Le tableau suivant récapitule les quotas de stockage instantanés pour chaque niveau.

Vous pouvez créer autant d’instantanés que nécessaire, tant que la taille de stockage totale de tous les instantanés actifs et archivés ne dépasse pas le quota de votre niveau. La taille maximale d’un instantané individuel est de 1 Mo.

Étapes suivantes