Snapshots
Uno snapshot è un subset non modificabile denominato di valori chiave di un archivio Configurazione app. I valori chiave che costituiscono uno snapshot vengono scelti durante la fase di creazione tramite l'utilizzo dei filtri di chiave e etichetta. Dopo aver creato uno snapshot, i valori chiave all'interno di sono garantiti per rimanere invariati.
Una breve panoramica è disponibile in questo video, evidenziando tre motivi per cui gli snapshot possono essere utili.
Distribuire in modo sicuro con gli snapshot
Gli snapshot sono progettati per distribuire in modo sicuro le modifiche di configurazione. La distribuzione di modifiche di configurazione non riuscite in un ambiente in esecuzione può causare problemi come l'interruzione del servizio e la perdita di dati. Per evitare questi problemi, è importante essere in grado di controllare le modifiche di configurazione prima di passare agli ambienti di produzione. Se si verifica un problema di questo tipo, è importante poter eseguire il rollback di eventuali modifiche di configurazione difettose per ripristinare il servizio. Gli snapshot vengono creati per la gestione di questi scenari.
Le modifiche alla configurazione devono essere distribuite in modo controllato e coerente. Gli sviluppatori possono usare gli snapshot per eseguire l'implementazione controllata. L'unica modifica necessaria in un'applicazione per avviare un'implementazione controllata consiste nell'aggiornare il nome dello snapshot a cui fa riferimento l'applicazione. Man mano che l'applicazione passa all'ambiente di produzione, esiste una garanzia che la configurazione nello snapshot a cui si fa riferimento rimanga invariata. Questa garanzia contro qualsiasi modifica in uno snapshot protegge da impostazioni impreviste che ne fanno il modo nell'ambiente di produzione. L'immutabilità e la facilità di riferimento degli snapshot semplificano l'implementazione sicura del set corretto di modifiche alla configurazione.
Scenari per l'uso di snapshot
Implementazione controllata: gli snapshot sono ideali per supportare l'implementazione controllata a causa della loro natura non modificabile. Quando gli sviluppatori usano snapshot per la configurazione, possono essere certi che la configurazione rimanga invariata man mano che il rilascio procede attraverso diverse fasi dell'implementazione.
Ultima configurazione LKG (Known Good): gli snapshot possono essere usati per supportare procedure di distribuzione sicure per la configurazione. Con gli snapshot, gli sviluppatori possono assicurarsi che sia disponibile una configurazione LKG (Last Known Good) per il rollback in caso di problemi durante la distribuzione.
Controllo delle versioni della configurazione: gli snapshot possono essere usati per creare una cronologia delle versioni delle impostazioni di configurazione da sincronizzare con le versioni di rilascio. Impostazioni acquisiti in ogni snapshot possono essere confrontati per identificare le modifiche tra le versioni.
Controllo: gli snapshot possono essere usati per scopi di controllo e conformità. Gli sviluppatori possono mantenere un record delle modifiche di configurazione tra le versioni usando gli snapshot per le versioni.
Ambienti di test e gestione temporanea: gli snapshot possono essere usati per creare ambienti di test e gestione temporanea coerenti. Gli sviluppatori possono assicurarsi che la stessa configurazione venga usata in ambienti diversi, usando lo stesso snapshot, che può essere utile per il debug e il test.
Composizione semplificata della configurazione client: in genere, i client di Configurazione app necessitano di un subset dei valori chiave dell'istanza di Configurazione app. Per ottenere il set di valori chiave obbligatori, è necessario che la logica di query sia scritta nel codice. Poiché gli snapshot supportano la fornitura di filtri durante la creazione, semplifica la composizione client perché i client possono ora fare riferimento al set di valori chiave richiesti per nome.
Operazioni snapshot
Poiché gli snapshot sono entità non modificabili, gli snapshot possono essere creati e archiviati solo. Non è possibile eliminare, eliminare o modificare.
Crea snapshot: gli snapshot possono essere creati definendo i filtri chiave e etichetta per acquisire i valori di chiave necessari dall'istanza di Configurazione app. I valori di chiave filtrati vengono archiviati come snapshot con il nome specificato durante la creazione.
Snapshot di archiviazione: l'archiviazione di uno snapshot lo inserisce in uno stato archiviato. Mentre uno snapshot è archiviato, è ancora completamente funzionante. Quando lo snapshot viene archiviato, viene impostata una scadenza in base al periodo di conservazione configurato durante la creazione dello snapshot. Se lo snapshot rimane nello stato archiviato fino alla scadenza, scompare automaticamente dal sistema al termine della scadenza. L'archiviazione viene usata per eliminare gradualmente gli snapshot che non sono più in uso.
Ripristina snapshot: il ripristino di uno snapshot lo riporta in uno stato attivo. A questo punto, lo snapshot non è più soggetto alla scadenza in base al periodo di conservazione configurato. Il ripristino è possibile solo nel periodo di conservazione dopo l'archiviazione.
Nota
Il periodo di conservazione può essere impostato solo durante la creazione di uno snapshot. Il valore predefinito per il periodo di conservazione è 30 giorni per i negozi Standard e 7 giorni per i negozi gratuiti.
Requisiti per le operazioni snapshot
Le sezioni seguenti illustrano in dettaglio le autorizzazioni necessarie per eseguire operazioni correlate agli snapshot con l'ID Microsoft Entra e l'autenticazione HMAC.
Creare uno snapshot
Per creare uno snapshot negli archivi usando l'autenticazione Microsoft Entra, sono necessarie le autorizzazioni seguenti. Il ruolo proprietario dati Configurazione app dispone già di queste autorizzazioni.
Microsoft.AppConfiguration/configurationStores/keyvalues/readMicrosoft.AppConfiguration/configurationStores/snapshots/write
Per creare uno snapshot usando l'autenticazione HMAC, è necessario usare una chiave di accesso in lettura/scrittura.
Archiviare e ripristinare uno snapshot
Per archiviare e/o ripristinare uno snapshot usando l'autenticazione di Microsoft Entra, è necessaria l'autorizzazione seguente. Il ruolo Proprietario dati Configurazione app dispone già di questa autorizzazione.
Microsoft.AppConfiguration/configurationStores/snapshots/archive/action
Per archiviare e/o ripristinare uno snapshot tramite l'autenticazione HMAC, è necessario usare una chiave di accesso in lettura/scrittura.
Leggere ed elencare gli snapshot
Per elencare tutti gli snapshot o ottenere tutti i valori chiave in un singolo snapshot in base al nome, è necessaria l'autorizzazione seguente per gli archivi che usano l'autenticazione Microsoft Entra. I ruoli predefiniti Proprietario dati e Lettore dati dispongono già di questa autorizzazione.
Microsoft.AppConfiguration/configurationStores/snapshots/read
Per gli archivi che usano l'autenticazione HMAC, è possibile eseguire sia l'operazione di "lettura snapshot" (per leggere i valori delle chiavi da uno snapshot) che l'operazione "list snapshot" usando le chiavi di accesso in lettura/scrittura o le chiavi di accesso di sola lettura.
Considerazioni e limiti relativi alla fatturazione
Configurazione app ha due livelli, Gratuito e Standard. Controllare i dettagli seguenti per le quote di snapshot in ogni livello.
Livello gratuito: questo livello ha una quota di archiviazione snapshot di 10 MB. È possibile creare il maggior numero possibile di snapshot, purché le dimensioni di archiviazione totali di tutti gli snapshot attivi e archiviati siano inferiori a 10 MB.
Livello Standard: questo livello ha una quota di archiviazione snapshot di 1 GB. È possibile creare il maggior numero possibile di snapshot, purché le dimensioni di archiviazione totali di tutti gli snapshot attivi e archiviati siano inferiori a 1 GB.
La dimensione massima per uno snapshot è di 1 MB.