Konfiguracja aplikacja systemu Azure — często zadawane pytania

Usługa App Configuration ułatwia deweloperom zarządzanie ustawieniami aplikacji i kontrolowanie dostępności funkcji. Ma na celu uproszczenie wielu zadań związanych z pracą ze złożonymi danymi konfiguracji.

Usługa App Configuration obsługuje:

• Hierarchiczne przestrzenie nazw
• Etykietowanie
• Obszerne zapytania
• Pobieranie wsadowe
• Wyspecjalizowane operacje zarządzania
• Interfejs użytkownika zarządzania funkcjami

Usługa App Configuration uzupełnia usługę Key Vault, a obie powinny być używane obok siebie we większości wdrożeń aplikacji.

Mimo że usługa App Configuration zapewnia zabezpieczenia ze wzmocnionymi zabezpieczeniami, usługa Key Vault jest nadal najlepszym miejscem do przechowywania wpisów tajnych aplikacji. Usługa Key Vault zapewnia szyfrowanie na poziomie sprzętu, szczegółowe zasady dostępu i operacje zarządzania, takie jak rotacja certyfikatów.

Możesz utworzyć wartości kluczy usługi App Configuration odwołujące się do wpisów tajnych przechowywanych w usłudze Key Vault. Aby uzyskać więcej informacji, zobacz Use Key Vault references in an ASP.NET Core app (Używanie odwołań do usługi Key Vault w aplikacji ASP.NET Core).

Tak. Usługa App Configuration zawsze szyfruje wszystkie dane przesyłane i magazynowane. Cała komunikacja sieciowa odbywa się za pośrednictwem protokołu TLS 1.2 lub TLS 1.3. Usługa App Configuration obsługuje szyfrowanie magazynowane przy użyciu kluczy zarządzanych przez firmę Microsoft lub kluczy zarządzanych przez klienta.

aplikacja systemu Azure Service umożliwia definiowanie ustawień aplikacji dla każdego wystąpienia usługi App Service. Te ustawienia są przekazywane jako zmienne środowiskowe do kodu aplikacji. Jeśli chcesz, możesz skojarzyć ustawienie z określonym miejscem wdrożenia. Aby uzyskać więcej informacji, zobacz Konfigurowanie ustawień aplikacji.

Natomiast aplikacja systemu Azure Configuration umożliwia zdefiniowanie ustawień, które mogą być współużytkowane przez wiele aplikacji. Obejmuje to aplikacje uruchomione w usłudze App Service, a także inne platformy. Kod aplikacji uzyskuje dostęp do tych ustawień za pośrednictwem dostawców konfiguracji dla platformy .NET i języka Java, za pośrednictwem zestawu Azure SDK lub bezpośrednio za pośrednictwem interfejsów API REST.

Odwołania do danych usługi App Configuration można dodawać w ustawieniach aplikacji usługi App Service. Możesz również zaimportować i wyeksportować ustawienia między usługą App Service i usługą App Configuration. Ta funkcja umożliwia szybkie skonfigurowanie nowego magazynu usługi App Configuration na podstawie istniejących ustawień usługi App Service. Możesz również udostępnić konfigurację istniejącej aplikacji, która opiera się na ustawieniach usługi App Service.

Istnieje limit 10 KB dla pojedynczej wartości klucza, w tym atrybutów, takich jak etykieta, typ zawartości, tagi i inne metadane. Nie ma limitu liczby kluczy i etykiet, o ile ich całkowity rozmiar jest niższy niż limit magazynu.

Ten limit klucz-wartość powinien być wystarczający dla pojedynczego ustawienia w większości aplikacji. Jeśli okaże się, że ustawienie jest większe niż ten limit, możesz rozważyć przechowywanie danych w innym miejscu i dodać odwołanie do tych danych w usłudze App Configuration.

Aby uzyskać pełną listę limitów, zobacz Limity subskrypcji i usług platformy Azure.

Możesz kontrolować, kto może uzyskiwać dostęp do usługi App Configuration na poziomie poszczególnych sklepów. Użyj oddzielnego magazynu dla każdego środowiska, które wymaga różnych uprawnień. Takie podejście zapewnia najlepszą izolację zabezpieczeń.

Jeśli nie potrzebujesz izolacji zabezpieczeń między środowiskami, możesz użyć etykiet, aby odróżnić wartości konfiguracji. Użyj etykiet, aby włączyć różne konfiguracje dla różnych środowisk , zawiera kompletny przykład.

Zobacz najlepsze rozwiązania.

Istnieją trzy warstwy cenowe: Bezpłatna, Standardowa i Premium. Aby uzyskać szczegółowe informacje o cenach, zapoznaj się ze stroną cennika usługi App Configuration.

Wszystkie warstwy konfiguracji aplikacji oferują podstawowe funkcje, w tym ustawienia konfiguracji, flagi funkcji, odwołania do usługi Key Vault, migawki konfiguracji, podstawowe operacje zarządzania, metryki i dzienniki.

Poniżej przedstawiono zagadnienia dotyczące wybierania warstwy.

• Cel: Warstwa Bezpłatna jest idealna do oceny usługi w środowiskach nieprodukcyjnych, umożliwiając eksplorowanie jej funkcji bez żadnych kosztów. Warstwa Standardowa jest dostosowana do średnich przypadków użycia w środowisku produkcyjnym, zapewniając równowagę wydajności i wydajności. W przypadku dużych lub korporacyjnych potrzeb produkcyjnych warstwa Premium oferuje najwyższy poziom wydajności i skalowalności, zapewniając bezproblemowe działanie aplikacji nawet pod dużym obciążeniem.

• Zasoby na subskrypcję: zasób składa się z jednego magazynu konfiguracji. Każda subskrypcja jest ograniczona do jednego magazynu konfiguracji na region w warstwie Bezpłatna. Subskrypcje mogą mieć nieograniczoną liczbę magazynów konfiguracji w warstwach Standardowa i Premium.

• Magazyn na zasób: w warstwie Bezpłatna każdy magazyn konfiguracji jest ograniczony do 10 MB zwykłego magazynu i 10 MB magazynu migawek. W warstwie Standardowa każdy magazyn konfiguracji może używać do 1 GB zwykłego magazynu i dodatkowego 1 GB magazynu migawek. W warstwie Premium każdy magazyn konfiguracji może używać do 4 GB zwykłego magazynu i dodatkowego 4 GB magazynu migawek.

• Historia poprawek: usługa App Configuration przechowuje historię wszystkich zmian wprowadzonych w kluczach. W warstwie Bezpłatna ta historia jest przechowywana przez siedem dni. W warstwach Standardowa i Premium ta historia jest przechowywana przez 30 dni.

• Limit przydziału żądań: magazyny w warstwie Bezpłatna są ograniczone do 1000 żądań dziennie. Gdy sklep osiągnie 1000 żądań, zwraca kod stanu HTTP 429 dla wszystkich żądań do północy CZASU UTC.

  Magazyny w warstwie Standardowa są ograniczone do 30 000 żądań na godzinę. Po wyczerpaniu limitu przydziału godzinowego dodatkowe żądania mogą zwrócić kod stanu HTTP 429, wskazując zbyt wiele żądań do końca godziny. W miarę wysyłania większej liczby żądań, które są powyżej limitu przydziału, wyższy procent z nich może zwrócić kod stanu 429.

  Magazyny w warstwie Premium nie mają limitu przydziału dla żądań, zapewniając, że dostęp do magazynu nigdy nie jest blokowany.

• Przepływność: magazyny usługi App Configuration we wszystkich warstwach mają limit przepływności. Żądania przekraczające ten zasiłek otrzymują odpowiedź z kodem stanu HTTP 429. Magazyny w warstwie Bezpłatna nie mają gwarantowanej przepływności.

  Magazyny w warstwie Standardowa zezwalają na szybkość uruchamiania† do 300 żądań na sekundę (RPS) dla żądań odczytu i do 60 RPS dla żądań zapisu.

  Magazyny w warstwie Premium umożliwiają uruchamianie† do 450 RPS dla żądań odczytu i do 100 RPS dla żądań zapisu.

  † Szybkość uruchamiania jest zwykle mierzona jako średnia liczba żądań obsługiwanych przez magazyn usługi App Configuration bez ograniczania przepustowości w określonym przedziale czasu.

• Umowa dotycząca poziomu usług: warstwa Bezpłatna nie ma umowy SLA. Warstwa Standardowa ma umowę SLA gwarantującą dostępność na poziomie 99,9% i dostępność na poziomie 99,95% z włączoną replikacją geograficzną. Warstwa Premium ma umowę SLA gwarantującą dostępność na poziomie 99,9% i dostępność na poziomie 99,99% z włączoną replikacją geograficzną.

• Funkcje: Wszystkie warstwy obejmują funkcje, w tym szyfrowanie za pomocą kluczy zarządzanych przez firmę Microsoft, uwierzytelnianie za pośrednictwem klucza dostępu lub identyfikatora Entra firmy Microsoft, kontroli dostępu opartej na rolach (RBAC), tożsamości zarządzanej, tagów usługi i nadmiarowości strefy dostępności. Warstwy Standardowa i Premium oferują więcej funkcji, w tym obsługę usługi Private Link, szyfrowanie za pomocą kluczy zarządzanych przez klienta, ochronę przed usuwaniem nietrwałym i możliwość replikacji geograficznej.

• Koszt: korzystanie z magazynu w warstwie Bezpłatna nie jest kosztowne.

  Magazyny w warstwie Standardowa mają opłatę za dzienne użycie, która obejmuje pierwsze 200 000 żądań każdego dnia. Żądania wykraczające poza tę dzienną alokację powodują naliczanie opłat za nadwyżkę.

  Magazyny w warstwie Premium mają również opłatę za dzienne użycie i obejmują replikę. Pierwsze 800 000 żądań dla źródła i pierwszych 800 000 żądań repliki każdego dnia jest uwzględnianych w opłatach dziennych. Żądania przekraczające tę dzienną alokację powodują naliczanie opłat za nadwyżkę.

Magazyn usługi App Configuration można uaktualnić w dowolnym momencie, na przykład z warstwy Bezpłatna do warstwy Standardowa lub Premium albo z warstwy Standardowa do warstwy Premium.

Nie można obniżyć poziomu magazynu usługi App Configuration, na przykład z warstwy Premium do warstwy Standardowa lub z warstwy Standardowa do warstwy Bezpłatna. Można jednak utworzyć nowy magazyn w żądanej warstwie, a następnie zaimportować dane konfiguracji do tego magazynu.

Dane klienta przechowywane w usłudze App Configuration znajdują się w regionie, w którym został utworzony magazyn app configuration klienta. Dane klienta są replikowane do innego regionu tylko wtedy, gdy klient włączy replikację geograficzną dla tego regionu. Dotyczy to wszystkich dostępnych regionów. Klienci mogą przenosić, kopiować lub uzyskiwać dostęp do danych z dowolnej lokalizacji na całym świecie.

aplikacja systemu Azure Configuration obsługuje replikację geograficzną w celu zwiększenia odporności na awarie regionalne.

aplikacja systemu Azure Configuration obsługuje strefy dostępności platformy Azure w celu ochrony aplikacji i danych przed pojedynczymi awariami centrum danych. Wszystkie regiony z obsługą strefy dostępności składają się z co najmniej trzech stref dostępności, w których każde z nich jest fizycznie niezależnym centrum danych. W przypadku odporności ta obsługa w usłudze App Configuration jest włączona dla wszystkich klientów bez dodatkowych kosztów. Poniżej przedstawiono regiony, w których usługa App Configuration włączyła obsługę stref dostępności. Aby uzyskać więcej informacji, zobacz Regiony platformy Azure z obsługą stref dostępności.

Poniżej przedstawiono regiony, w których usługa App Configuration włączyła obsługę strefy dostępności.

Magazyny usługi App Configuration mają różne limity przydziału żądań na podstawie ich warstwy. Magazyny w warstwie Bezpłatna są ograniczone do 1000 żądań dziennie, magazyny w warstwie Standardowa do 30 000 żądań na godzinę, a magazyny w warstwie Premium nie mają limitów żądań, zapewniając nieprzerwany dostęp.

Magazyny usługi App Configuration mają przydziały przepływności na podstawie ich warstwy. Magazyny w warstwie Bezpłatna nie mają gwarantowanej przepływności. Magazyny w warstwie Standardowa obsługują szybkość uruchamiania do 300 żądań na sekundę (RPS) dla operacji odczytu i do 60 RPS dla operacji zapisu. Magazyny w warstwie Premium obsługują szybkość uruchamiania do 450 RPS dla operacji odczytu i do 100 RPS dla operacji zapisu.

Załóżmy, że masz aplikację z 1000 ustawieniami konfiguracji. Aplikacja ładuje wszystkie te ustawienia z usługi App Configuration po uruchomieniu. Następnie sprawdza klucz sentinel pod kątem zmian konfiguracji co 30 sekund. Niezależnie od tego, czy korzystasz z platformy Kubernetes, usługi App Service, czy maszyn wirtualnych, załóżmy, że masz 50 wystąpień aplikacji uruchomionych jednocześnie.

Najpierw szacujmy żądania monitorowania konfiguracji. Każde wystąpienie aplikacji wysyła jedno żądanie klucza sentinel do usługi App Configuration co 30 sekund, dlatego wysyła 120 żądań (=3600/30) w ciągu godziny. Jeśli masz 50 wystąpień aplikacji, aplikacja wysyła 6000 (=120x50) łącznych żądań co godzinę na potrzeby monitorowania konfiguracji. Należy pamiętać, że ponieważ żądania kluczy sentinel są częste i w większości niezmienione, większość z nich nie liczy się z limitami przydziału godzinowego magazynu† dla magazynu warstwy Standardowa.

Po drugie szacujmy żądania ładowania/ponownego ładowania konfiguracji. Aplikacja ładuje wszystkie ustawienia podczas uruchamiania lub za każdym razem, gdy zostanie wykryta zmiana klucza sentinel. Każde żądanie do usługi App Configuration może pobrać maksymalnie 100 klucz-wartości, więc ładowanie wszystkich ustawień trwa 10 (=1000/100). Jeśli masz 50 wystąpień aplikacji, wysyłasz 500 (=10x50) łącznych żądań po ponownym uruchomieniu aplikacji lub ponownym załadowaniu jej konfiguracji.

Na koniec połączmy ją. Przy założeniu, że klucz sentinel został zaktualizowany dwa razy w ciągu godziny, magazyn usługi App Configuration otrzyma zatem 7000 (=6 000+500x2) łącznych żądań dla tej godziny. Należy pamiętać, że z tych żądań tylko około 1000 żądań (=500x2) używa dostępnego limitu przydziału godzinowego dla magazynu warstwy Standardowa. Zaktualizuj liczby w tym przykładzie, aby pasowały do określonej konfiguracji i odpowiednio zaprojektować, aby mieć wystarczający bufor względem limitu przydziału godzinowego.

† Sklepy w warstwie Bezpłatna nie mają częstych, powtarzających się żądań wykluczonych z dziennego limitu.

Aplikacja może otrzymać odpowiedź http o kodzie stanu 429 w następujących okolicznościach:

• Przekroczenie dziennego limitu przydziału żądań dla magazynu w warstwie Bezpłatna.
• Przekroczenie limitu przydziału żądań godzinowych dla magazynu w warstwie Standardowa.
• Przekroczenie limitu przepływności magazynu w dowolnej warstwie.
• Przekroczenie limitu przepustowości magazynu w dowolnej warstwie.
• Próba utworzenia lub zmodyfikowania wartości klucza po przekroczeniu limitu przydziału magazynu.

Sprawdź treść odpowiedzi 429 z określonego powodu, dla którego żądanie nie powiodło się. Dzienniki magazynu App Configuration można również zbierać w usłudze Azure Monitor i konfigurować alerty dotyczące metryki Użycie limitu przydziału żądań.

Odbieranie chwilowego kodu stanu HTTP 429 zwykle nie powoduje żadnych szkód, ponieważ klienci usługi App Configuration obsługują je bezpiecznie. Jeśli jednak aplikacja regularnie korzysta z kodu stanu HTTP 429, rozważ następujące opcje:

• Uaktualnij sklep do warstwy Premium: ta warstwa nie ma limitu przydziału dla żądań i zwiększyła limit przydziału magazynu i wyższą przepływność.
• Użyj dostawców konfiguracji aplikacji: dostawcy mają wbudowane funkcje ponawiania i buforowania wraz z wieloma innymi funkcjami odporności. Pamiętaj, aby zaktualizować dostawcę do najnowszej wersji, aby uzyskać wszystkie najnowsze ulepszenia.
• Użyj zestawów SDK usługi App Configuration, jeśli aplikacja musi wysyłać żądania zapisu. Mimo że zestawy SDK mogą nie być tak bogate w funkcje, jak dostawcy, automatycznie ponawiają próby w kodzie stanu HTTP 429 odpowiedzi i innych błędów przejściowych.
• Uwzględnij logikę ponawiania prób w niestandardowych klientach, jeśli nie możesz używać dostawców konfiguracji aplikacji ani zestawów SDK. Nagłówek retry-after-ms w odpowiedzi zawiera sugerowany czas oczekiwania (w milisekundach) przed ponowną próbą żądania.
• Dystrybuuj żądania w wielu wystąpieniach klientów: pomaga to osiągnąć maksymalną przepływność ze sklepu App Configuration.
• Zmniejsz liczbę żądań wysyłanych do usługi App Configuration: postępuj zgodnie ze wskazówkami, aby zminimalizować liczbę żądań.
• Zwiększ odporność aplikacji: rozważ integrację replikacji geograficznej, aby umożliwić przechodzenie w tryb failover i równoważenie obciążenia. Zapoznaj się z najlepszymi rozwiązaniami dotyczącymi tworzenia wysoce odpornych aplikacji.

Wszystkie magazyny usługi App Configuration w warstwach Standardowa i Premium automatycznie włączyły funkcję usuwania nietrwałego. Po usunięciu magazynu usługi App Configuration w warstwie Standardowa lub Premium jego nazwa jest zarezerwowana dla okresu przechowywania. Aby ponownie utworzyć magazyn o tej samej nazwie przed wygaśnięciem okresu przechowywania, należy najpierw przeczyścić magazyn usunięty nietrwale, pod warunkiem, że magazyn nie ma włączonej ochrony przed przeczyszczeniem. Jeśli ochrona przed przeczyszczeniem jest włączona, musisz poczekać na upłynięcie okresu przechowywania. Użyj funkcji przeczyszczania lub ustaw krótszy okres przechowywania, jeśli często trzeba ponownie utworzyć magazyn o tej samej nazwie. Przepływy pracy, które wymagają ponownego utworzenia magazynu o tej samej nazwie, powinny zezwalać na jedną godzinę między przeczyszczeniem magazynu konfiguracji i wykonaniem kolejnej operacji tworzenia. To zalecenie jest wykonywane asynchronicznie, ponieważ po zażądaniu przeczyszczania rzeczywiste czyszczenie zasobów magazynu konfiguracji jest wykonywane asynchronicznie, co wymaga nieco dodatkowego czasu na sfinalizowanie. Aby uniknąć konieczności oczekiwania, zaleca się używanie unikatowych nazw przepływów pracy, które tworzą efemeryczne magazyny konfiguracji.

Wszystkie magazyny usługi App Configuration w warstwach Standardowa i Premium obsługują funkcję usuwania nietrwałego, której nie można wyłączyć. W okresie przechowywania można odzyskać usunięty magazyn. Postępuj zgodnie z tymi instrukcjami , aby odzyskać omyłkowo usunięty magazyn App Configuration.

Tak. Chociaż można zarządzać flagami funkcji i odwołaniami usługi Key Vault w usłudze App Configuration za pośrednictwem witryny Azure Portal lub interfejsu wiersza polecenia, można również tworzyć i aktualizować je programowo przy użyciu zestawów SDK usługi App Configuration. W związku z tym można programowo napisać dostosowany portal zarządzania lub zarządzać nimi w ciągłej integracji/ciągłego wdrażania. Flaga funkcji i interfejsy API odwołań usługi Key Vault są dostępne w zestawach SDK wszystkich obsługiwanych języków. Zapoznaj się z przykładowymi linkami, aby zapoznać się z przykładami w każdym obsługiwanym języku.

Ocena i korzystanie z flag funkcji w aplikacji wymaga dostawcy usługi App Configuration i bibliotek zarządzania funkcjami, które są dostępne na platformie .NET i platformie Java Spring. Aby uzyskać więcej informacji, zapoznaj się z sekcją Zarządzanie funkcjami w obszarze Przewodniki Szybki start i samouczki.

Profile spring umożliwiają oddzielenie części aplikacji, w tym konfiguracji i udostępnienie jej tylko w niektórych środowiskach lub w przypadku użycia określonych bibliotek.

Zaleca się ustawienie etykiety klucz-wartości w celu dopasowania ich do profilów Spring. Domyślnie biblioteka dostawcy App Configuration Spring ładuje wartości kluczy z etykietami zgodnymi z bieżącymi aktywnymi profilami Spring (${spring.profiles.active}), jeśli filtr etykiety nie jest jawnie ustawiony. Jeśli nie ma aktywnego zestawu profilów Spring, zostaną załadowane wartości klucz-wartości bez etykiety.

Na przykład za pomocą profilów dev i prodparametrów należy odpowiednio utworzyć wartości kluczy z następującymi etykietami.

Gdy profil spring jest ustawiony na devwartość , wartość config.message to Hello from dev. Gdy profil spring jest ustawiony na prodwartość , wartość config.message to Hello from prod.

To domyślne zachowanie można zastąpić, ustawiając filtr etykiet w pliku bootstrap. Biblioteka dostawcy spring ładuje wartości kluczy z określonymi etykietami niezależnie od aktywnego profilu Spring.

spring.cloud.azure.appconfiguration.stores[0].selects[0].label-filter: my-label

Aby wybrać inne etykiety i profile spring, możesz użyć filtru etykiet, takiego jak ',${spring.profiles.active}', który wybierze wszystkie klucze bez etykiety i tych pasujących do profilów spring. Etykiety z prawej strony mają priorytet po znalezieniu zduplikowanych kluczy.

Począwszy od wersji 3.1.0 biblioteka Microsoft.FeatureManagement umożliwia uruchamianie usług zarządzania funkcjami, w tym filtrów funkcji, jako usług o określonym zakresie w aplikacjach .NET opartych na iniekcji zależności. Aby skorzystać z tej funkcji, możesz po prostu zastąpić AddFeatureManagement wywołanie w kodzie ciągiem AddScopedFeatureManagement, jak pokazano w poniższym fragmencie kodu:

services.AddScopedFeatureManagement();

Filtry funkcji mogą oceniać flagę funkcji na podstawie właściwości żądania HTTP. Jest to zwykle wykonywane przez inspekcję HttpContext IHttpContextAccessor przez pojedynczy wzorzec. Jednak ten wzorzec nie działa w przypadku aplikacji serwera Blazor, w których należy zamiast tego używać usług o określonym zakresie. W takim przypadku AddScopedFeatureManagement należy użyć metody .

Zasubskrybuj nasze repozytorium z ogłoszeniami usługi GitHub.

Możesz skontaktować się z nami bezpośrednio w usłudze GitHub.

• Informacje o konfiguracji aplikacja systemu Azure