Gestire e usare gli snapshot

Questo articolo illustra come creare, usare e gestire snapshot in Configurazione app di Azure. Lo snapshot è un set di impostazioni di Configurazione app archiviate in uno stato non modificabile.

Prerequisiti

• Un archivio di Configurazione app, come illustrato nell'esercitazione per la creazione di un archivio.
• Ruolo "DataOwner" nell'archivio di Configurazione dell'app. Informazioni dettagliate sul ruolo e sulle autorizzazioni necessarie per gli snapshot

Aggiungere valori chiave all'archivio di configurazione dell'app

Nell'archivio di Configurazione app, passare a Operazioni>Esplora configurazioni e aggiungere le coppie chiave-valore seguenti. Lasciare Content Type con il valore predefinito. Per altre informazioni su come aggiungere valori chiave a un archivio usando il portale di Azure o l’interfaccia della riga di comando, andare a Creare un valore chiave.

Chiave	Valore	Etichetta
app2/bgcolor	Grigio chiaro	label2
app1/color	nero	Nessuna etichetta
app1/color	Blu	label1
app1/color	Verde	label2
app1/color	Giallo	label3
app1/message	Hello	label1
app1/message	Ciao!	label2
app2/message	Buongiorno!	label1

Creare uno snapshot

In Operazioni>Snapshot, selezionare Crea un nuovo snapshot.

1. Immettere un nome di snapshot e facoltativamente anche aggiungere tag.

2. In Scegli il tipo di composizione, mantenere il valore predefinito Chiave (impostazione predefinita).

   • Con il tipo di composizione chiave , se l'archivio ha chiavi identiche con etichette diverse, nello snapshot viene incluso solo il valore della chiave specificato nell'ultimo filtro applicabile. Le stesse coppie chiave-valore con altre etichette vengono lasciati fuori dallo snapshot.
   • Con il tipo di composizione Key-Label, se il tuo store ha chiavi identiche ma etichette diverse, tutti i valori chiave con chiavi identiche e etichette diverse vengono inclusi nello snapshot a seconda dei filtri specificati.

3. Selezionare Aggiungi filtri per selezionare i valori chiave per lo snapshot. Il filtro viene eseguito selezionando filtri: Uguale a, Inizia con, Qualsiasi e Tutti per le chiavi e le etichette. È possibile immettere tra uno e tre filtri.

   1. Aggiungere il primo filtro:
      • In Chiave selezionare Inizia con e immettere app1
      • In Etichetta, selezionare Uguale a e selezionare label2 dal menu a discesa.
   2. Aggiungere il secondo filtro:
      • In Chiave selezionare Inizia con e immettere app1
      • In Etichetta, selezionare Uguale a e selezionare label1 dal menu a discesa.

4. Se si archivia uno snapshot, per impostazione predefinita verrà conservato per 30 giorni dopo l'archiviazione. Facoltativamente, in Opzioni di ripristino ridurre il numero di giorni di conservazione per cui lo snapshot sarà disponibile dopo l'archiviazione.

   Annotazioni

   La durata del periodo di conservazione non può essere aggiornata dopo la creazione dello snapshot.

5. Selezionare Crea per generare lo snapshot. In questo esempio lo snapshot creato ha il tipo di composizione chiave e i filtri seguenti:

   • Chiavi che iniziano con app1, con etichetta label2
   • Chiavi che iniziano con app1, con etichetta label1.

   

6. Controllare la tabella per comprendere quali valori chiave dell'archivio di configurazione finiscono nello snapshot in base ai parametri specificati.

   Chiave	Valore	Etichetta	Elemento incluso nello snapshot
   app2/bgcolor	Grigio chiaro	label2	No: non inizia con app1.
   app1/color	nero	Nessuna etichetta	No: non ha l'etichetta label2 o label1.
   app1/color	Blu	label1	Sì: ha l'etichetta label1 corretta dall'ultimo dei filtri applicabili.
   app1/color	Verde	label2	No: la stessa chiave con etichetta label1 selezionata dal secondo filtro ha la precedenza su questa, nonostante abbia l'etichetta selezionata, label2.
   app1/color	Giallo	label3	No: non ha l'etichetta label2 o label1.
   app1/message	Hello	label1	Sì: ha l'etichetta label1 corretta dall'ultimo dei filtri applicabili.
   app1/message	Ciao!	label2	No: la stessa chiave con etichetta label1 selezionata dal secondo filtro ha la precedenza su questa, nonostante abbia l'etichetta selezionata, label2.
   app2/message	Buongiorno!	label1	No: non inizia con app1.

Creare snapshot campione

Per creare snapshot di esempio e verificare il funzionamento della funzionalità snapshot, usare la sandbox snapshot. Questa sandbox contiene dati di esempio che è possibile riprodurre per comprendere meglio il funzionamento del tipo di composizione e dei filtri dello snapshot.

1. In Operazioni>Snapshot>Snapshot attivi, selezionare Testa nella sandbox.
2. Esaminare i dati di esempio e provare a creare snapshot compilando il modulo con un tipo di composizione e uno o più filtri.
3. Selezionare Crea per generare lo snapshot di esempio.
4. Controllare il risultato dello snapshot generato in Snapshot di esempio generato. Lo snapshot di esempio visualizza tutte le chiavi incluse nello snapshot di esempio, in base alla selezione.

Usare gli snapshot

È possibile selezionare un numero qualsiasi di snapshot per la configurazione dell'applicazione. Se si seleziona uno snapshot, vengono aggiunti tutti i relativi valori chiave. Dopo l'aggiunta a una configurazione, i valori chiave degli snapshot vengono considerati uguali a qualsiasi altro valore della chiave.

Se si dispone di un'applicazione con Configurazione app di Azure, è possibile aggiornarla con il codice di esempio seguente per usare gli snapshot. È sufficiente specificare il nome dello snapshot, che fa distinzione tra maiuscole e minuscole.

.NET

Modificare la chiamata al metodo AddAzureAppConfiguration, spesso presente nel file Program.cs dell'applicazione. Se non si ha un'applicazione, è possibile fare riferimento a una delle guide introduttive di .NET, ad esempio creare un'applicazione ASP.NET Core con Azure App Configuration.

Aggiungi snapshot alla tua configurazione

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
});

Annotazioni

Il supporto dello snapshot è disponibile se si usa la versione 7.0.0 o successiva di uno dei pacchetti seguenti.

• Microsoft.Extensions.Configuration.AzureAppConfiguration
• Microsoft.Azure.AppConfiguration.AspNetCore
• Microsoft.Azure.AppConfiguration.Functions.Worker

Primavera

Aggiornare il application.yml file dell'applicazione con le configurazioni seguenti.

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

Annotazioni

Qualsiasi prefisso, /application/ ad esempio che viene tagliato automaticamente quando si usa un filtro di chiave, deve essere specificato per gli snapshot oppure non verrà eseguito correttamente il mapping alle classi corrette @ConfigurationProperties . Il supporto per gli snapshot è disponibile se si usa la versione 4.12.0-beta.1/5.6.0-beta.1 o successiva di uno dei pacchetti seguenti.

• spring-cloud-azure-appconfiguration-config
• spring-cloud-azure-appconfiguration-config-web
• spring-cloud-azure-starter-appconfiguration-config

Annotazioni

È possibile caricare solo gli snapshot creati con il tipo di Key composizione usando gli esempi di codice illustrati in precedenza.

Gestire gli snapshot attivi

Nella pagina Operazioni>Snapshot vengono visualizzate due schede: Snapshot attivi e Snapshot archiviati. Selezionare Snapshot attivi per visualizzare l'elenco di tutti gli snapshot attivi in un archivio di Configurazione app.

Visualizzare uno snapshot esistente

Nella scheda Snapshot attivi selezionare i puntini di sospensione ... a destra di uno snapshot esistente e selezionare Visualizza per visualizzare uno snapshot. Questa azione apre una pagina dei dettagli dello snapshot che visualizza le impostazioni dello snapshot e i valori chiave inclusi nello snapshot.

Archiviare uno snapshot

Nella scheda Snapshot attivi selezionare i puntini di sospensione ... a destra di uno snapshot esistente e selezionare Archivia per archiviare uno snapshot. Confermare l'archiviazione selezionando Sì o annulla con No. Dopo l'archiviazione di uno snapshot, viene visualizzata una notifica per confermare l'operazione e l'elenco degli snapshot attivi viene aggiornato.

Gestire gli snapshot archiviati

Passare a Operazioni>Snapshot>Snapshot archiviati per visualizzare l'elenco di tutti gli snapshot archiviati in un archivio di Configurazione app. Gli snapshot archiviati rimangono accessibili per il periodo di conservazione selezionato durante la creazione.

Visualizzare lo snapshot archiviato

La visualizzazione dettagliata dello snapshot è disponibile anche nello stato di archiviazione. Nella scheda Snapshot archiviati selezionare i puntini di sospensione ... a destra di uno snapshot esistente e selezionare Visualizza per visualizzare uno snapshot. Questa azione apre una pagina dei dettagli dello snapshot che visualizza le impostazioni dello snapshot e i valori chiave inclusi nello snapshot.

Ripristina uno snapshot archiviato

Nella scheda Snapshot archiviati selezionare i puntini di sospensione ... a destra di uno snapshot archiviato e selezionare Ripristina per ripristinare uno snapshot. Dopo aver recuperato uno snapshot, viene visualizzata una notifica per confermare l'operazione e l'elenco degli snapshot archiviati viene aggiornato.

Passaggi successivi

Snapshot in Configurazione app di Azure