Ö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. Den oföränderliga och enkla referensen för ögonblicksbilder gör det enkelt att se till att rätt uppsättning konfigurationsändringar distribueras 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.

• LKG-konfiguration (Last Known Good): Ögonblicksbilder kan användas för att stödja säkra distributionsmetoder för konfiguration. 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.

• Konfigurationsversioner: Ögonblicksbilder kan användas för att skapa en versionshistorik för konfigurationsinställningar för synkronisering med versionsversioner. Inställningar som samlas in i varje ögonblicksbild kan jämföras för att identifiera ändringar mellan versioner.

• Granskning: Ögonblicksbilder kan användas i gransknings- och efterlevnadssyfte. Utvecklare kan underhålla en post med konfigurationsändringar mellan versioner med hjälp av ögonblicksbilderna för versionerna.

• 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 klienterna i App Configuration en delmängd av nyckelvärdena från appkonfigurationsinstansen. För att hämta uppsättningen med nödvändiga nyckelvärden måste de ha frågelogik skriven i kod. Eftersom Ögonblicksbilder har stöd för att tillhandahålla filter under skapandetiden förenklar det klientsammansättningen eftersom klienter nu kan referera till den uppsättning nyckelvärden som de behöver efter namn.

Åtgärder för ögonblicksbilder

Eftersom ögonblicksbilder är oföränderliga entiteter kan ögonblicksbilder bara skapas och arkiveras. Det går inte att ta bort, rensa eller redigera.

• 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.

Kommentar

Kvarhållningsperioden kan bara anges när en ögonblicksbild skapas. Standardvärdet för kvarhållningsperioden är 30 dagar för Standard-butiker och 7 dagar för kostnadsfria butiker.

Krav för åtgärder för ögonblicksbilder

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

Om du vill visa en lista över alla ögonblicksbilder eller hämta alla nyckelvärden i en enskild ögonblicksbild med namn krävs följande behörighet för butiker som använder Microsoft Entra-autentisering. De inbyggda rollerna Dataägare och Dataläsare har redan den här behörigheten.

• Microsoft.AppConfiguration/configurationStores/snapshots/read

För butiker som använder HMAC-autentisering kan både åtgärden "läsögonblicksbild" (för att läsa nyckelvärdena från en ögonblicksbild) och åtgärden "listögonblicksbilder" utföras med hjälp av antingen skrivskyddade åtkomstnycklar eller skrivskyddade åtkomstnycklar.

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

Appkonfigurationen har två nivåer, Kostnadsfri och Standard. Kontrollera följande information om kvoter för ögonblicksbilder på varje nivå.

• Kostnadsfri nivå: Den här nivån har en lagringskvot för ögonblicksbilder på 10 MB. Man kan skapa så många ögonblicksbilder som möjligt så länge den totala lagringsstorleken för alla aktiva och arkiverade ögonblicksbilder är mindre än 10 MB.

• Standardnivå: Den här nivån har en lagringskvot för ögonblicksbilder på 1 GB. Man kan skapa så många ögonblicksbilder som möjligt så länge den totala lagringsstorleken för alla aktiva och arkiverade ögonblicksbilder är mindre än 1 GB.

Den maximala storleken för en ögonblicksbild är 1 MB.

Nästa steg

Skapa en ögonblicksbild