Migawki
Migawka jest nazwanym, niezmiennym podzbiorem kluczy magazynu App Configuration. Wartości klucza tworzące migawkę są wybierane w czasie tworzenia za pomocą filtrów kluczy i etykiet. Po utworzeniu migawki gwarantowane są wartości kluczy w ramach programu .
Krótkie omówienie jest dostępne w tym filmie wideo z wyróżnionymi trzema przyczynami, dla których migawki mogą być przydatne.
Bezpieczne wdrażanie za pomocą migawek
Migawki są przeznaczone do bezpiecznego wdrażania zmian konfiguracji. Wdrażanie wadliwych zmian konfiguracji w uruchomionym środowisku może powodować problemy, takie jak zakłócenia usługi i utrata danych. Aby uniknąć takich problemów, ważne jest, aby móc zweryfikować zmiany konfiguracji przed przejściem do środowisk produkcyjnych. Jeśli wystąpi taki problem, ważne jest, aby można było wycofać wszelkie błędne zmiany konfiguracji w celu przywrócenia usługi. Migawki są tworzone do zarządzania tymi scenariuszami.
Zmiany konfiguracji powinny być wdrażane w kontrolowany, spójny sposób. Deweloperzy mogą używać migawek do wykonywania kontrolowanego wdrażania. Jedyną zmianą wymaganą w aplikacji do rozpoczęcia kontrolowanego wprowadzania jest zaktualizowanie nazwy migawki, do których odwołuje się aplikacja. W miarę przechodzenia aplikacji do środowiska produkcyjnego istnieje gwarancja, że konfiguracja w przywołynej migawki pozostaje niezmieniona. Ta gwarancja przed wszelkimi zmianami w migawce chroni przed nieoczekiwanymi ustawieniami w środowisku produkcyjnym. Niezmienność i łatwość odwoływania się do migawek ułatwiają bezpieczne wdrażanie odpowiedniego zestawu zmian konfiguracji.
Scenariusze używania migawek
Kontrolowane wdrażanie: migawki są dobrze dostosowane do obsługi kontrolowanego wdrażania ze względu na ich niezmienny charakter. Gdy deweloperzy korzystają z migawek do konfiguracji, mogą mieć pewność, że konfiguracja pozostaje niezmieniona w miarę postępu wydania w różnych fazach wdrażania.
Ostatnia znana konfiguracja dobrego (LKG): migawki mogą służyć do obsługi bezpiecznych praktyk wdrażania dla konfiguracji. W przypadku migawek deweloperzy mogą upewnić się, że konfiguracja Ostatniego znanego dobrego (LKG) jest dostępna do wycofania, jeśli wystąpił jakikolwiek problem podczas wdrażania.
Przechowywanie wersji konfiguracji: migawki mogą służyć do tworzenia historii wersji ustawień konfiguracji w celu synchronizacji z wersjami wersji. Ustawienia przechwycone w każdej migawki można porównać do identyfikowania zmian między wersjami.
Inspekcja: migawki mogą być używane do celów inspekcji i zgodności. Deweloperzy mogą zachować rekord zmian konfiguracji między wydaniami przy użyciu migawek dla wydań.
Środowiska testowania i przemieszczania: migawki mogą służyć do tworzenia spójnych środowisk testowych i przejściowych. Deweloperzy mogą mieć pewność, że ta sama konfiguracja jest używana w różnych środowiskach przy użyciu tej samej migawki, co może pomóc w debugowaniu i testowaniu.
Uproszczona kompozycja konfiguracji klienta: zazwyczaj klienci usługi App Configuration potrzebują podzestawu klucz-wartości z wystąpienia usługi App Configuration. Aby uzyskać zestaw wymaganych wartości klucza, muszą mieć logikę zapytań napisaną w kodzie. Ponieważ migawki obsługują udostępnianie filtrów w czasie tworzenia, pomaga uprościć kompozycję klienta, ponieważ klienci mogą teraz odwoływać się do zestawu wartości kluczy, których potrzebują według nazwy.
Operacje migawki
Ponieważ migawki są niezmiennymi jednostkami, migawki można tworzyć i archiwizować tylko. Nie można usuwać, czyścić ani edytować.
Tworzenie migawki: migawki można utworzyć, definiując filtry kluczy i etykiet w celu przechwycenia wymaganych wartości klucza z wystąpienia usługi App Configuration. Filtrowane wartości klucza są przechowywane jako migawka z nazwą podaną podczas tworzenia.
Migawka archiwum: archiwizowanie migawki umieszcza ją w stanie zarchiwizowanym. Chociaż migawka jest zarchiwizowana, nadal jest w pełni funkcjonalna. Gdy migawka jest archiwizowana, czas wygaśnięcia jest ustawiany na podstawie okresu przechowywania skonfigurowanego podczas tworzenia migawki. Jeśli migawka pozostaje w stanie zarchiwizowanym do czasu wygaśnięcia, automatycznie zniknie z systemu po upływie czasu wygaśnięcia. Archiwizacja jest używana do wycofywania migawek, które nie są już używane.
Odzyskiwanie migawki: odzyskiwanie migawki powoduje przywrócenie jej stanu aktywnego. W tym momencie migawka nie podlega już wygaśnięciu na podstawie skonfigurowanego okresu przechowywania. Odzyskiwanie jest możliwe tylko w okresie przechowywania po archiwizacji.
Uwaga
Okres przechowywania można ustawić tylko podczas tworzenia migawki. Wartość domyślna okresu przechowywania to 30 dni dla sklepów w warstwie Standardowa i 7 dni w przypadku bezpłatnych sklepów.
Wymagania dotyczące operacji migawek
W poniższych sekcjach szczegółowo opisano uprawnienia wymagane do wykonywania operacji związanych z migawką przy użyciu identyfikatora Microsoft Entra ID i uwierzytelniania HMAC.
Tworzenie migawki
Aby utworzyć migawkę w sklepach przy użyciu uwierzytelniania firmy Microsoft Entra, wymagane są następujące uprawnienia. Rola Właściciela danych konfiguracji aplikacji ma już te uprawnienia.
Microsoft.AppConfiguration/configurationStores/keyvalues/readMicrosoft.AppConfiguration/configurationStores/snapshots/write
Aby utworzyć migawkę przy użyciu uwierzytelniania HMAC, należy użyć klucza dostępu do odczytu i zapisu.
Archiwizowanie i odzyskiwanie migawki
Aby zarchiwizować i/lub odzyskać migawkę przy użyciu uwierzytelniania firmy Microsoft Entra, potrzebne jest następujące uprawnienie. Rola Właściciel danych konfiguracji aplikacji ma już to uprawnienie.
Microsoft.AppConfiguration/configurationStores/snapshots/archive/action
Aby zarchiwizować i/lub odzyskać migawkę przy użyciu uwierzytelniania HMAC, należy użyć klucza dostępu do odczytu i zapisu.
Odczytywanie i wyświetlanie migawek
Aby wyświetlić listę wszystkich migawek lub pobrać wszystkie wartości kluczy w pojedynczej migawki według nazwy, wymagane jest następujące uprawnienie do przechowywania przy użyciu uwierzytelniania firmy Microsoft Entra. Wbudowane role Właściciel danych i Czytelnik danych mają już to uprawnienie.
Microsoft.AppConfiguration/configurationStores/snapshots/read
W przypadku magazynów korzystających z uwierzytelniania HMAC można wykonać zarówno operację "odczytu migawki" (aby odczytać wartości kluczy z migawki), jak i operację "migawki listy" przy użyciu kluczy dostępu do odczytu i zapisu lub kluczy dostępu tylko do odczytu.
Zagadnienia i limity dotyczące rozliczeń
Usługa App Configuration ma trzy warstwy, Bezpłatna, Standardowa i Premium. Sprawdź następujące szczegóły dotyczące przydziałów migawek w każdej warstwie.
Warstwa Bezpłatna: ta warstwa ma przydział magazynu migawek wynoszący 10 MB. Można utworzyć jak najwięcej migawek, o ile całkowity rozmiar magazynu wszystkich aktywnych i zarchiwizowanych migawek jest mniejszy niż 10 MB.
Warstwa Standardowa: ta warstwa ma przydział magazynu migawek o rozmiarze 1 GB. Można utworzyć jak najwięcej migawek, o ile łączny rozmiar magazynu wszystkich aktywnych i zarchiwizowanych migawek jest mniejszy niż 1 GB.
Warstwa Premium: ta warstwa ma limit przydziału magazynu migawek w wysokości 4 GB. Można utworzyć jak najwięcej migawek, o ile całkowity rozmiar magazynu wszystkich aktywnych i zarchiwizowanych migawek jest mniejszy niż 4 GB.
Maksymalny rozmiar migawki to 1 MB.