Ögonblicksbilder

En ögonblicksbild är en namngiven, oföränderlig delmängd av ett appkonfigurationsarkivs nyckelvärden. De nyckelvärden som utgör en ögonblicksbild väljs under skapandetiden genom användning av nyckel- och etikettfilter. När en ögonblicksbild har skapats kommer nyckelvärdena inom garanterat att förbli oförändrade.

En kort översikt är tillgänglig i den här videon, som belyser tre orsaker till att ögonblicksbilder kan vara till hjälp för dig.

Distribuera på ett säkert sätt med ögonblicksbilder

Ögonblicksbilder är utformade för att distribuera konfigurationsändringar på ett säkert sätt. Om du distribuerar felaktiga konfigurationsändringar i en miljö som körs kan det orsaka problem som avbrott i tjänsten och dataförlust. För att undvika sådana problem är det viktigt att kunna granska konfigurationsändringar innan du flyttar till produktionsmiljöer. Om ett sådant problem uppstår är det viktigt att kunna återställa eventuella felaktiga konfigurationsändringar för att återställa tjänsten. Ögonblicksbilder skapas för att hantera dessa scenarier.

Konfigurationsändringar bör distribueras på ett kontrollerat och konsekvent sätt. Utvecklare kan använda ögonblicksbilder för att utföra kontrollerad distribution. Den enda ändring som krävs i ett program för att starta en kontrollerad distribution är att uppdatera namnet på ögonblicksbilden som programmet refererar till. När programmet flyttas till produktion finns det en garanti för att konfigurationen i den refererade ögonblicksbilden förblir oförändrad. Den här garantin mot alla ändringar i en ögonblicksbild skyddar mot oväntade inställningar som tar sig in i produktion. Ögonblicksbildernas oföränderlighet och att de är lätta att referera till gör det enkelt att säkerställa att rätt uppsättning konfigurationsändringar rullas ut på ett säkert sätt.

Scenarier för användning av ögonblicksbilder

• Kontrollerad distribution: Ögonblicksbilder lämpar sig väl för att stödja kontrollerad distribution på grund av deras oföränderliga natur. När utvecklare använder ögonblicksbilder för konfiguration kan de vara säkra på att konfigurationen förblir oförändrad när lanseringen fortskrider genom olika faser i distributionen.

• Konfigurationen Last Known Good (LKG): Ögonblicksbilder kan användas för att stödja säkra distributionsrutiner för Configuration. Med ögonblicksbilder kan utvecklare se till att en LKG-konfiguration (Last known Good) är tillgänglig för återställning om det uppstod något problem under distributionen.

• Versionshantering av konfiguration: Ögonblicksbilder kan användas för att skapa en versionshistorik över konfigurationsinställningar som kan synkroniseras med releaseversioner. Inställningar som samlas in i varje ögonblicksbild kan jämföras för att identifiera ändringar mellan versioner.

• Granskning: Använd ögonblicksbilder för granskning och regelefterlevnad. Utvecklare kan föra en logg över konfigurationsändringar mellan releaser genom att använda snapshots för releaserna.

• Test- och mellanlagringsmiljöer: Ögonblicksbilder kan användas för att skapa konsekventa test- och mellanlagringsmiljöer. Utvecklare kan se till att samma konfiguration används i olika miljöer genom att använda samma ögonblicksbild, vilket kan hjälpa dig med felsökning och testning.

• Förenklad klientkonfigurationssammansättning: Vanligtvis behöver App Configuration-klienter en delmängd av nyckelvärdena från en App Configuration-instans. Utan snapshots behöver klienter frågelogik i kod för att hämta de nödvändiga nyckelvärdena. Eftersom snapshots stöder filter vid skapandet kan klienter hänvisa till den nödvändiga uppsättningen nyckelvärden med namn.

Åtgärder för ögonblicksbilder

Eftersom snapshots är oföränderliga kan du skapa och arkivera dem, men du kan inte radera, rensa eller redigera dem.

• Skapa ögonblicksbild: Ögonblicksbilder kan skapas genom att definiera nyckel- och etikettfilter för att samla in nödvändiga nyckelvärden från appkonfigurationsinstansen. De filtrerade nyckelvärdena lagras som en ögonblicksbild med namnet som angavs när du skapade.

• Arkivögonblicksbild: Om du arkiverar en ögonblicksbild hamnar den i ett arkiverat tillstånd. Även om en ögonblicksbild arkiveras är den fortfarande fullt fungerande. När ögonblicksbilden arkiveras anges en förfallotid baserat på den kvarhållningsperiod som konfigurerades när ögonblicksbilden skapades. Om ögonblicksbilden förblir i det arkiverade tillståndet fram till förfallotiden försvinner den automatiskt från systemet när förfallotiden går. Arkivering används för att fasa ut ögonblicksbilder som inte längre används.

• Återställ ögonblicksbild: När du återställer en ögonblicksbild återgår den i ett aktivt tillstånd. I det här läget är ögonblicksbilden inte längre föremål för förfallodatum baserat på dess konfigurerade kvarhållningsperiod. Återställning är endast möjligt under kvarhållningsperioden efter arkivering.

Krav för ögonblicksbildsåtgärder

I följande avsnitt beskrivs de behörigheter som krävs för att utföra åtgärder relaterade till ögonblicksbilder med Microsoft Entra-ID och HMAC-autentisering.

Skapa en ögonblicksbild

För att skapa en ögonblicksbild i butiker med Microsoft Entra-autentisering krävs följande behörigheter. Rollen appkonfigurationsdataägare har redan dessa behörigheter.

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

Om du vill skapa en ögonblicksbild med hjälp av HMAC-autentisering måste en läs-och skrivåtkomstnyckel användas.

Arkivera och återställa en ögonblicksbild

För att arkivera och/eller återställa en ögonblicksbild med Microsoft Entra-autentisering krävs följande behörighet. Rollen appkonfigurationsdataägare har redan den här behörigheten.

• Microsoft.AppConfiguration/configurationStores/snapshots/archive/action

Om du vill arkivera och/eller återställa en ögonblicksbild med HMAC-autentisering måste en läs-och-skrivåtkomstnyckel användas.

Läsa och lista ögonblicksbilder

För att lista alla snapshots eller få alla nyckelvärden i en enskild snapshot efter namn behöver du följande behörighet för butiker som använder Microsoft Entra-autentisering. De inbyggda rollerna Data Owner och Data Reader inkluderar redan denna behörighet.

• Microsoft.AppConfiguration/configurationStores/snapshots/read

För lager som använder HMAC-autentisering kan både åtgärden "läs ögonblicksbild" (för att läsa nyckel/värde-paren från en ögonblicksbild) och åtgärden "lista ögonblicksbilder" utföras med antingen åtkomstnycklar med läs- och skrivbehörighet eller skrivskyddade åtkomstnycklar.

Överväganden och gränser för fakturering

Appkonfigurationen har fyra nivåer: Kostnadsfri, Utvecklare, Standard och Premium. I följande tabell sammanfattas lagringskvoterna för ögonblicksbilder för varje nivå:

Du kan skapa så många ögonblicksbilder som behövs, så länge den totala lagringsstorleken för alla aktiva och arkiverade ögonblicksbilder inte överskrider kvoten för din nivå. Den maximala storleken för en enskild ögonblicksbild är 1 MB.

Nästa steg