Momentopnamen
Een momentopname is een benoemde, onveranderbare subset van de sleutelwaarden van een App Configuration-archief. De sleutelwaarden waaruit een momentopname bestaat, worden tijdens het maken gekozen via het gebruik van sleutel- en labelfilters. Zodra een momentopname is gemaakt, blijven de sleutelwaarden binnen gegarandeerd ongewijzigd.
In deze video is een kort overzicht beschikbaar, waarin drie redenen worden benadrukt waarom momentopnamen nuttig voor u kunnen zijn.
Veilig implementeren met momentopnamen
Momentopnamen zijn ontworpen om configuratiewijzigingen veilig te implementeren. Het implementeren van foutieve configuratiewijzigingen in een actieve omgeving kan problemen veroorzaken, zoals serviceonderbreking en gegevensverlies. Om dergelijke problemen te voorkomen, is het belangrijk dat u configuratiewijzigingen kunt controleren voordat u naar productieomgevingen overstapt. Als een dergelijk probleem zich voordoet, is het belangrijk dat u eventuele foutieve configuratiewijzigingen kunt terugdraaien om de service te herstellen. Momentopnamen worden gemaakt voor het beheren van deze scenario's.
Configuratiewijzigingen moeten op een gecontroleerde, consistente manier worden geïmplementeerd. Ontwikkelaars kunnen momentopnamen gebruiken om gecontroleerde implementatie uit te voeren. De enige wijziging die nodig is in een toepassing om een gecontroleerde implementatie te starten, is door de naam van de momentopname bij te werken waarnaar de toepassing verwijst. Naarmate de toepassing in productie gaat, is er een garantie dat de configuratie in de momentopname waarnaar wordt verwezen ongewijzigd blijft. Deze garantie tegen elke wijziging in een momentopname beschermt tegen onverwachte instellingen die hun weg naar productie maken. De onveranderbaarheid en het gemak van momentopnamen maken het eenvoudig om ervoor te zorgen dat de juiste set configuratiewijzigingen veilig wordt geïmplementeerd.
Scenario's voor het gebruik van momentopnamen
Gecontroleerde implementatie: Momentopnamen zijn goed geschikt voor het ondersteunen van gecontroleerde implementatie vanwege hun onveranderbare aard. Wanneer ontwikkelaars momentopnamen voor configuratie gebruiken, kunnen ze erop vertrouwen dat de configuratie ongewijzigd blijft wanneer de release door verschillende fasen van de implementatie verloopt.
Laatst bekende goede configuratie (LKG): Momentopnamen kunnen worden gebruikt ter ondersteuning van veilige implementatieprocedures voor configuratie. Met momentopnamen kunnen ontwikkelaars ervoor zorgen dat een laatst bekende goede configuratie (LKG) beschikbaar is voor terugdraaien als er een probleem is opgetreden tijdens de implementatie.
Configuratieversies: Momentopnamen kunnen worden gebruikt om een versiegeschiedenis van configuratie-instellingen te maken die moet worden gesynchroniseerd met releaseversies. Instellingen vastgelegd in elke momentopname kan worden vergeleken om wijzigingen tussen versies te identificeren.
Controle: Momentopnamen kunnen worden gebruikt voor controle- en nalevingsdoeleinden. Ontwikkelaars kunnen een record bijhouden van configuratiewijzigingen tussen releases met behulp van de momentopnamen voor de releases.
Test- en faseringsomgevingen: Momentopnamen kunnen worden gebruikt om consistente test- en faseringsomgevingen te maken. Ontwikkelaars kunnen ervoor zorgen dat dezelfde configuratie wordt gebruikt in verschillende omgevingen, met behulp van dezelfde momentopname, wat kan helpen bij het opsporen en testen van fouten.
Vereenvoudigde configuratie van client: meestal hebben de clients van App Configuration een subset van de sleutelwaarden van het App Configuration-exemplaar nodig. Als u de set vereiste sleutelwaarden wilt ophalen, moeten ze querylogica hebben geschreven in code. Als momentopnamen ondersteuning bieden voor het leveren van filters tijdens het maken van de tijd, helpt het de samenstelling van de client te vereenvoudigen, omdat clients nu naar de set sleutelwaarden kunnen verwijzen die ze op naam vereisen.
Momentopnamebewerkingen
Omdat momentopnamen onveranderbare entiteiten zijn, kunnen momentopnamen alleen worden gemaakt en gearchiveerd. Verwijderen, opschonen of bewerken is niet mogelijk.
Momentopname maken: Momentopnamen kunnen worden gemaakt door de sleutel- en labelfilters te definiëren om de vereiste sleutelwaarden van het App Configuration-exemplaar vast te leggen. De gefilterde sleutelwaarden worden opgeslagen als een momentopname met de naam die tijdens het maken is opgegeven.
Momentopname van archiveren: als u een momentopname archiveert, krijgt deze een gearchiveerde status. Hoewel een momentopname is gearchiveerd, is deze nog steeds volledig functioneel. Wanneer de momentopname wordt gearchiveerd, wordt een verlooptijd ingesteld op basis van de bewaarperiode die is geconfigureerd tijdens het maken van de momentopname. Als de momentopname in de gearchiveerde status blijft tot de verlooptijd, verdwijnt deze automatisch uit het systeem wanneer de verlooptijd is verstreken. Archivering wordt gebruikt voor het afbouwen van momentopnamen die niet meer in gebruik zijn.
Momentopname herstellen: als u een momentopname herstelt, wordt deze teruggezet in een actieve status. Op dit moment is de momentopname niet langer onderhevig aan vervaldatum op basis van de geconfigureerde bewaarperiode. Herstel is alleen mogelijk in de bewaarperiode na archivering.
Notitie
De bewaarperiode kan alleen worden ingesteld tijdens het maken van een momentopname. De standaardwaarde voor de bewaarperiode is 30 dagen voor Standard-winkels en 7 dagen voor gratis winkels.
Vereisten voor momentopnamebewerkingen
In de volgende secties worden de machtigingen beschreven die vereist zijn voor het uitvoeren van momentopnamebewerkingen met Microsoft Entra-id en HMAC-verificatie.
Een momentopname maken
Als u een momentopname wilt maken in winkels met behulp van Microsoft Entra-verificatie, zijn de volgende machtigingen vereist. De rol App Configuration-gegevenseigenaar heeft al deze machtigingen.
Microsoft.AppConfiguration/configurationStores/keyvalues/readMicrosoft.AppConfiguration/configurationStores/snapshots/write
Als u een momentopname wilt maken met HMAC-verificatie, moet een lees-/schrijftoegangssleutel worden gebruikt.
Een momentopname archiveren en herstellen
Als u een momentopname wilt archiveren en/of herstellen met behulp van Microsoft Entra-verificatie, hebt u de volgende machtiging nodig. De rol App Configuration-gegevenseigenaar heeft deze machtiging al.
Microsoft.AppConfiguration/configurationStores/snapshots/archive/action
Als u een momentopname wilt archiveren en/of herstellen met HMAC-verificatie, moet een lees-/schrijftoegangssleutel worden gebruikt.
Momentopnamen lezen en weergeven
Als u alle momentopnamen wilt weergeven of alle sleutelwaarden in een afzonderlijke momentopname wilt ophalen op naam, is de volgende machtiging nodig voor winkels die gebruikmaken van Microsoft Entra-verificatie. De ingebouwde rollen Gegevenseigenaar en Gegevenslezer hebben deze machtiging al.
Microsoft.AppConfiguration/configurationStores/snapshots/read
Voor winkels die gebruikmaken van HMAC-verificatie, kunnen zowel de bewerking 'momentopname lezen' (om de sleutelwaarden uit een momentopname te lezen) en de bewerking 'momentopnamen van lijsten' worden uitgevoerd met behulp van de lees-/schrijftoegangssleutels of de alleen-lezentoegangssleutels.
Overwegingen en limieten voor facturering
App Configuration heeft twee lagen, Gratis en Standard. Controleer de volgende details voor quota voor momentopnamen in elke laag.
Gratis laag: deze laag heeft een opslagquotum voor momentopnamen van 10 MB. U kunt zoveel mogelijk momentopnamen maken zolang de totale opslaggrootte van alle actieve en gearchiveerde momentopnamen kleiner is dan 10 MB.
Standard-laag: deze laag heeft een opslagquotum voor momentopnamen van 1 GB. U kunt zoveel mogelijk momentopnamen maken zolang de totale opslaggrootte van alle actieve en gearchiveerde momentopnamen kleiner is dan 1 GB.
De maximale grootte voor een momentopname is 1 MB.