Momentopnamen beheren en gebruiken

In dit artikel leert u hoe u momentopnamen maakt, gebruikt en beheert in Azure App Configuration. Snapshot is een set App Configuration-instellingen die zijn opgeslagen in onveranderlijke toestand.

Vereiste voorwaarden

• Een App Configuration-winkel, zoals uiteengezet in de zelfstudie voor het maken van een winkel.
• De rol DataOwner in het App Configuration-archief. Details over de vereiste rol en machtigingen voor momentopnamen

Sleutelwaarden toevoegen aan het app-configuratiearchief

Ga in uw App Configuration-archief naar Operations>Configuration Explorer en voeg de volgende sleutelwaarden toe. Laat het inhoudstype met de standaardwaarde staan. Ga naar Een sleutelwaarde maken voor meer informatie over het toevoegen van sleutelwaarden aan een opslag met de Azure Portal of de CLI.

Een momentopname maken

Selecteer onder bewerkingen>momentopnamen>, nieuwe momentopname maken.

1. Voer een naam voor een momentopname in en voeg eventueel ook tags toe.

2. Houd onder Kies het samenstellingstype de standaardwaarde Sleutel (standaard).

   • Met het sleutelsamenstellingstype, als uw winkel identieke sleutels met verschillende labels heeft, wordt alleen de sleutelwaarde die is opgegeven in het laatste toepasselijke filter opgenomen in de momentopname. Identieke sleutelwaarden met andere labels worden uit de momentopname weggelaten.
   • Met het Key-Label samenstellingstype, als uw winkel identieke sleutels met verschillende labels heeft, worden alle sleutelwaarden met identieke sleutels maar verschillende labels opgenomen in de momentopname, afhankelijk van de opgegeven filters.

3. Selecteer Filters toevoegen om de sleutelwaarden voor uw momentopname te selecteren. Filteren wordt uitgevoerd door het selecteren van filters: Gelijk, Begint met, Eén van en Alle voor sleutels en labels. U kunt tussen één en drie filters invoeren.

   1. Voeg het eerste filter toe:
      • Selecteer Onder Sleutelbegint met en voer app1 in
      • Onder Label, selecteer Gelijk aan en kies label2 uit de vervolgkeuzelijst.
   2. Voeg het tweede filter toe:
      • Selecteer onder SleutelBegint met en voer app1 in
      • Selecteer onder Label de optie Equals en kies label1 in de vervolgkeuzelijst.

4. Als u een momentopname standaard archiveert, wordt deze 30 dagen na archivering bewaard. U kunt desgewenst onder Herstelopties het aantal retentiedagen verlagen dat de momentopname na archivering beschikbaar is.

   Opmerking

   De duur van de bewaarperiode kan niet worden bijgewerkt zodra de momentopname is gemaakt.

5. Selecteer Maken om de momentopname te genereren. In dit voorbeeld heeft de gemaakte momentopname het type Sleutelsamenstelling en de onderstaande filters:

   • Sleutels die beginnen met app1, met label2-label
   • Sleutels die beginnen met app1, met label1 label.

   

6. Controleer de tabel om te begrijpen welke sleutelwaarden uit het configuratiearchief in de momentopname terechtkomen op basis van de opgegeven parameters.

   Sleutelcode	Waarde	Etiket	Opgenomen in momentopname
   app2/bgcolor	Lichtgrijze	label2	Nee: begint niet met app1.
   app1/color	Zwart	Geen label	Nee: heeft niet de labels label2 of label1.
   app1/color	Blauw	label1	Ja: Heeft het juiste labellabel1 van de laatste van de toepasselijke filters.
   app1/color	Groen	label2	Nee: Dezelfde sleutel met label1 die door het tweede filter is geselecteerd, overschrijft deze ondanks dat hij het geselecteerde label label2 heeft.
   app1/color	Gele	label3	Nee: heeft het label2 of label1 niet.
   app1/message	Hello-	label1	Ja: Heeft het juiste label label1 van de laatste toepasselijke filters.
   app1/message	Hallo!	label2	Nee: Dezelfde sleutel met het label label1 dat door het tweede filter is geselecteerd, overschrijft deze, ook al heeft het het geselecteerde label label2.
   app2/message	Goedemorgen!	label1	Nee: begint niet met app1.

Voorbeeldmomentopnamen maken

Als u voorbeeldmomentopnamen wilt maken en wilt controleren hoe de functie momentopnamen werkt, gebruikt u de sandbox voor momentopnamen. Deze sandbox bevat voorbeeldgegevens waarmee u kunt spelen om beter te begrijpen hoe het samenstellingstype en de filters van momentopnamen werken.

1. Selecteer in Operations>Snapshots>Actieve momentopnamen de optie Testen in sandbox.
2. Bekijk de voorbeeldgegevens en oefen met het maken van momentopnamen door het formulier in te vullen met een samenstellingstype en een of meer filters.
3. Selecteer Maken om de voorbeeldmomentopname te genereren.
4. Bekijk het momentopnameresultaat dat is gegenereerd onder Gegenereerde voorbeeldmomentopname. In de voorbeeldmomentopname worden alle sleutels weergegeven die zijn opgenomen in de voorbeeldmomentopname, afhankelijk van uw selectie.

Momentopnamen gebruiken

U kunt een willekeurig aantal momentopnamen selecteren voor de configuratie van de toepassing. Als u een momentopname selecteert, worden alle sleutelwaarden toegevoegd. Zodra deze zijn toegevoegd aan een configuratie, worden de sleutelwaarden van momentopnamen hetzelfde behandeld als elke andere sleutelwaarde.

Als u een toepassing hebt die Gebruikmaakt van Azure App Configuration, kunt u deze bijwerken met de volgende voorbeeldcode om momentopnamen te gebruiken. U hoeft alleen de naam van de momentopname op te geven. Dit is hoofdlettergevoelig.

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

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

Actieve momentopnamen beheren

Op de pagina onderMomentopnamen van bewerkingen> worden twee tabbladen weergegeven: Actieve momentopnamen en gearchiveerde momentopnamen. Selecteer Actieve momentopnamen om de lijst met alle actieve momentopnamen in een App Configuration-archief weer te geven.

Bestaande momentopname weergeven

Selecteer op het tabblad Actieve momentopnamen het beletselteken ... rechts van een bestaande momentopname en selecteer Weergave om een momentopname weer te geven. Met deze actie wordt een pagina Met details van momentopnamen geopend waarin de instellingen van de momentopname en de sleutelwaarden in de momentopname worden weergegeven.

Een momentopname archiveren

Selecteer op het tabblad Actieve momentopnamen het beletselteken ... rechts van een bestaande momentopname en selecteer Archiveren om een momentopname te archiveren. Bevestig archivering door Ja te selecteren of te annuleren met Nee. Zodra een momentopname is gearchiveerd, wordt er een melding weergegeven om de bewerking te bevestigen en wordt de lijst met actieve momentopnamen bijgewerkt.

Gearchiveerde momentopnamen beheren

Ga naargearchiveerde momentopnamen van Operations>Snapshots> om de lijst met alle gearchiveerde momentopnamen in een App Configuration-archief weer te geven. Gearchiveerde momentopnamen blijven toegankelijk voor de retentieperiode die is geselecteerd tijdens het maken ervan.

Gearchiveerde momentopname weergeven

Gedetailleerde weergave van momentopnamen is ook beschikbaar in de archiefstatus. Selecteer op het tabblad Gearchiveerde momentopnamen het beletselteken ... rechts van een bestaande momentopname en selecteer Weergeven om een momentopname weer te geven. Met deze actie wordt een pagina Met details van momentopnamen geopend waarin de instellingen van de momentopname en de sleutelwaarden in de momentopname worden weergegeven.

Een gearchiveerde momentopname herstellen

Selecteer op het tabblad Gearchiveerde momentopnamen het beletselteken ... rechts van een gearchiveerde momentopname en selecteer Herstellen om een momentopname te herstellen. Zodra een momentopname is hersteld, wordt er een melding weergegeven om de bewerking te bevestigen en wordt de lijst met gearchiveerde momentopnamen bijgewerkt.

Volgende stappen