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 zawarte w niej pary klucz-wartość pozostają niezmienione.

Krótkie omówienie można znaleźć w tym filmie, który przedstawia trzy powody, dla których snapshoty mogą Ci się przydać.

Wdrażaj bezpiecznie 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. Snapshoty tworzy się, aby zarządzać tymi scenariuszami.

Zmiany konfiguracji powinny być wdrażane w kontrolowany, spójny sposób. Deweloperzy mogą używać obrazów stanu do przeprowadzania kontrolowanego wdrożenia. Jedyną zmianą potrzebną w aplikacji, aby rozpocząć kontrolowane wdrażanie, jest zaktualizowanie nazwy migawki, do której odwołuje się aplikacja. W miarę wdrażania aplikacji do środowiska produkcyjnego jest gwarancja, że konfiguracja we wskazanej migawce pozostaje niezmieniona. Ta gwarancja, że w migawce nie zostaną wprowadzone żadne zmiany, chroni przed trafieniem nieoczekiwanych ustawień do środowiska produkcyjnego. Niezmienność i łatwość odwoływania się do migawek ułatwiają bezpieczne wdrażanie właściwego 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.

• Konfiguracja ostatniego znanego dobrego stanu (LKG): migawki mogą być używane do wspierania bezpiecznych praktyk wdrażania w obszarze konfiguracji. Dzięki migawkom deweloperzy mogą mieć pewność, że ostatnia znana dobra konfiguracja (LKG) jest dostępna na potrzeby wycofania, jeśli podczas wdrażania wystąpi jakikolwiek problem.

• Wersjonowanie konfiguracji: migawki mogą służyć do tworzenia historii wersji ustawień konfiguracyjnych w celu synchronizacji z wersjami wydań. Ustawienia zapisane w poszczególnych migawkach można porównać, aby zidentyfikować zmiany między wersjami.

• Audyt: Używaj migawek na potrzeby audytu i zapewnienia zgodności. Deweloperzy mogą prowadzić rejestr zmian konfiguracji między wydaniami, korzystając z migawek dla tych wydań.

• Środowiska testowe i przejściowe: migawki można wykorzystać 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 konfiguracji aplikacji potrzebują podzbioru wartości kluczy z instancji konfiguracji aplikacji. Bez snapshotów klienci potrzebują logiki zapytań w kodzie, aby pobrać wymagane wartości klucza. Ponieważ snapshoty obsługują filtry już przy tworzeniu danych, klienci mogą odwoływać się do wymaganego zestawu wartości kluczy po nazwie.

Operacje migawek

Ponieważ migawki są niezmienne, można je tworzyć i archiwizować, ale nie można ich 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.

• Archiwizacja migawki: Archiwizacja migawki powoduje przejście jej do stanu zarchiwizowanego. 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 służy do wycofywania z użycia 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.

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.

Utwórz migawkę

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/read
• Microsoft.AppConfiguration/configurationStores/snapshots/write

Aby utworzyć migawkę przy użyciu uwierzytelniania HMAC, należy użyć klucza dostępu do odczytu i zapisu.

Archiwizować i odzyskać migawkę

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.

Odczytaj i wyświetl listę migawek

Aby wyświetlić wszystkie migawki lub uzyskać wszystkie pary klucz-wartość w pojedynczej migawce na podstawie nazwy, wymagane jest następujące uprawnienie dla magazynów korzystających z uwierzytelniania Microsoft Entra. Wbudowane role Data Owner i Data Reader już zawierają to uprawnienia.

• 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 cztery warstwy: Bezpłatna, Deweloper, Standardowa i Premium. W poniższej tabeli przedstawiono podsumowanie limitów pamięci na migawki dla każdej warstwy.

Można utworzyć dowolną liczbę migawek, o ile całkowity rozmiar magazynu wszystkich aktywnych i zarchiwizowanych migawek nie przekracza limitu przydziału dla warstwy. Maksymalny rozmiar pojedynczej migawki to 1 MB.

Następne kroki