Snapshots
Snímek je pojmenovaná neměnná podmnožina hodnot klíče v App Configuration Storu. Hodnoty klíčů, které tvoří snímek, se vyberou během vytváření prostřednictvím filtrů klíčů a popisků. Po vytvoření snímku se zaručuje, že hodnoty klíče v rámci zůstanou beze změny.
Stručný přehled je k dispozici v tomto videu a zvýrazňuje tři důvody, proč vám můžou být snímky užitečné.
Bezpečné nasazení se snímky
Snímky jsou navržené k bezpečnému nasazení změn konfigurace. Nasazení chybných změn konfigurace do spuštěného prostředí může způsobit problémy, jako je přerušení služeb a ztráta dat. Abyste se těmto problémům vyhnuli, je důležité před přechodem do produkčních prostředí provést změny konfigurace. Pokud k takovému problému dojde, je důležité, abyste mohli vrátit zpět všechny chybné změny konfigurace, aby bylo možné službu obnovit. Snímky se vytvářejí pro správu těchto scénářů.
Změny konfigurace by měly být nasazeny řízeným konzistentním způsobem. Vývojáři můžou k řízenému zavedení použít snímky. Jedinou změnou potřebnou k zahájení řízeného zavedení v aplikaci je aktualizace názvu snímku, na který aplikace odkazuje. Když se aplikace přesune do produkčního prostředí, existuje záruka, že konfigurace v odkazovaném snímku zůstane beze změny. Tato záruka proti jakékoli změně snímku chrání před neočekávanými nastaveními, která se dostanou do produkčního prostředí. Neměnnost a snadné odkazování na snímky usnadňují zajištění bezpečného zpřístupnění správné sady změn konfigurace.
Scénáře použití snímků
Řízené zavedení: Snímky jsou vhodné pro podporu řízeného zavedení z důvodu jejich neměnné povahy. Když vývojáři ke konfiguraci využívají snímky, můžou si být jistí, že konfigurace zůstane beze změny, protože vydání postupuje v různých fázích zavedení.
Poslední známá dobrá konfigurace (LKG): Snímky lze použít k podpoře bezpečných postupů nasazení pro konfiguraci. Díky snímkům můžou vývojáři zajistit, aby byla k dispozici konfigurace poslední známé dobré (LKG) pro vrácení zpět, pokud během nasazování došlo k nějakému problému.
Správa verzí konfigurace: Snímky lze použít k vytvoření historie verzí nastavení konfigurace pro synchronizaci s verzemi. Nastavení zachycené v každém snímku je možné porovnat s identifikací změn mezi verzemi.
Auditování: Snímky lze použít pro účely auditování a dodržování předpisů. Vývojáři můžou udržovat záznam změn konfigurace mezi verzemi pomocí snímků pro vydané verze.
Testovací a přípravná prostředí: Snímky lze použít k vytváření konzistentních testovacích a přípravných prostředí. Vývojáři můžou zajistit, aby se stejná konfigurace používala v různých prostředích pomocí stejného snímku, který může pomoct s laděním a testováním.
Zjednodušené složení konfigurace klienta: Klienti konfigurace aplikace obvykle potřebují podmnožinu hodnot klíče z instance App Configuration. Pokud chcete získat sadu požadovaných hodnot klíčů, musí mít logiku dotazu napsanou v kódu. Vzhledem k tomu, že snímky podporují poskytování filtrů během vytváření, pomáhá zjednodušit složení klienta, protože klienti teď můžou odkazovat na sadu hodnot klíčů, které vyžadují podle názvu.
Operace snímků
Vzhledem k tomu, že snímky jsou neměnné entity, je možné snímky vytvářet a archivovat pouze. Odstranění, vyprázdnění nebo úpravy není možné.
Vytvoření snímku: Snímky je možné vytvořit definováním filtrů klíčů a popisků pro zachycení požadovaných hodnot klíče z instance App Configuration. Filtrované hodnoty klíčů se ukládají jako snímek s názvem zadaným během vytváření.
Snímek archivu: Archivace snímku umístí snímek do archivovaného stavu. Zatímco je snímek archivován, je stále plně funkční. Když se snímek archivuje, nastaví se doba vypršení platnosti na základě doby uchovávání nakonfigurované během vytváření snímku. Pokud snímek zůstane v archivním stavu až do doby vypršení platnosti, po uplynutí doby vypršení platnosti automaticky zmizí ze systému. Archivace se používá k postupnému vyřazení snímků, které se už nepoužívají.
Obnovení snímku: Obnovení snímku se vrátí do aktivního stavu. V tomto okamžiku už snímek podléhá vypršení platnosti na základě nakonfigurovaného období uchovávání. Obnovení je možné pouze v době uchovávání po archivaci.
Poznámka:
Doba uchovávání je možné nastavit pouze při vytváření snímku. Výchozí hodnota doby uchovávání je 30 dnů pro obchody Standard a 7 dní pro obchody Free.
Požadavky na operace snímků
Následující části podrobně uvádějí oprávnění potřebná k provádění operací souvisejících se snímky s ověřováním Microsoft Entra ID a HMAC.
Vytvoření snímku
K vytvoření snímku v úložištích pomocí ověřování Microsoft Entra se vyžadují následující oprávnění. Tato oprávnění už má role Vlastník dat konfigurace aplikace.
Microsoft.AppConfiguration/configurationStores/keyvalues/readMicrosoft.AppConfiguration/configurationStores/snapshots/write
Pokud chcete vytvořit snímek pomocí ověřování HMAC, musíte použít přístupový klíč pro čtení i zápis.
Archivace a obnovení snímku
K archivaci a/nebo obnovení snímku pomocí ověřování Microsoft Entra je potřeba následující oprávnění. Tato oprávnění už má role Vlastník dat konfigurace aplikace.
Microsoft.AppConfiguration/configurationStores/snapshots/archive/action
Pokud chcete archivovat nebo obnovit snímek pomocí ověřování HMAC, musíte použít přístupový klíč pro čtení i zápis.
Čtení a výpis snímků
K výpisu všech snímků nebo získání všech hodnot klíče v jednotlivých snímcích podle názvu je potřeba následující oprávnění pro úložiště využívající ověřování Microsoft Entra. Tato oprávnění už mají předdefinované role Vlastník dat a Čtenář dat.
Microsoft.AppConfiguration/configurationStores/snapshots/read
U úložišť, které používají ověřování HMAC, je možné provést operaci čtení snímku (ke čtení hodnot klíčů ze snímku) i operaci výpisu snímků pomocí přístupových klíčů jen pro čtení nebo přístupových klíčů jen pro čtení.
Aspekty a limity fakturace
App Configuration má dvě úrovně, Free a Standard. Projděte si následující podrobnosti o kvótách snímků v jednotlivých úrovních.
Úroveň Free: Tato úroveň má kvótu úložiště snímků 10 MB. Můžete vytvořit co nejvíce snímků, pokud celková velikost úložiště všech aktivních a archivovaných snímků je menší než 10 MB.
Úroveň Standard: Tato úroveň má kvótu úložiště snímků 1 GB. Můžete vytvořit co nejvíce snímků, pokud celková velikost úložiště všech aktivních a archivovaných snímků je menší než 1 GB.
Maximální velikost snímku je 1 MB.