Udostępnij przez

Niezawodność w usłudze Azure API Management

Azure API Management. to w pełni zarządzana usługa, która ułatwia organizacjom publikowanie, zabezpieczanie, przekształcanie, konserwację i monitorowanie interfejsów API. Jako usługa platformy Azure usługa API Management oferuje szereg możliwości obsługi wymagań dotyczących niezawodności.

W przypadku korzystania z platformy Azure niezawodność jest wspólną odpowiedzialnością. Firma Microsoft oferuje szereg możliwości wspierania odporności systemów i odzyskiwania. Odpowiadasz za zrozumienie sposobu działania tych możliwości we wszystkich używanych usługach oraz wybór możliwości potrzebnych do osiągnięcia twoich celów biznesowych i celów dostępności.

W tym artykule opisano, jak usługa API Management jest odporna na różne potencjalne awarie i problemy, w tym przejściowe błędy, awarie stref dostępności, awarie regionów i konserwacja usługi. Opisano w nim również sposób używania kopii zapasowych do odzyskiwania po innych typach problemów oraz wyróżnia niektóre kluczowe informacje o umowie dotyczącej poziomu usług (SLA) usługi API Management.

Omówienie architektury niezawodności

Usługa API Management używa architektury opartej na jednostkach skalowania w celu zapewnienia wbudowanej nadmiarowości i skalowalności. Podczas wdrażania wystąpienia usługi API Management należy skonfigurować jedną lub więcej jednostek skalowania lub jednostek. Każda jednostka jest logiczną reprezentacją pojemności, która zawiera niezbędne zasoby obliczeniowe do obsługi żądań interfejsu API.

Podczas konfigurowania wystąpienia z co najmniej dwiema jednostkami dostępne jednostki współpracują ze sobą w celu przetwarzania żądań i zapewnienia automatycznego równoważenia obciążenia. Jeśli jedna z jednostek stanie się niedostępna, pozostałe jednostki będą nadal obsługiwać ruch, ale z potencjalnie zmniejszoną pojemnością.

Aby uzyskać wyższy poziom niezawodności, usługa API Management obsługuje dystrybucję jednostek w różnych strefach dostępności w regionie i w wielu regionach.

Warstwy usług API Management zapewniają różne poziomy niezawodności:

  • Warstwa Premium (klasyczna): Obsługuje wiele jednostek, które można dystrybuować między strefami dostępności i regionami w celu zapewnienia maksymalnej odporności. W warstwie Premium każda jednostka składa się z dwóch maszyn wirtualnych, które zapewniają zasoby obliczeniowe do obsługi żądań interfejsu API.

  • Warstwy Podstawowa, 2, Standardowa, 2 i Premium w wersji 2 (wersja zapoznawcza): Wszystkie obsługują wiele jednostek w jednym centrum danych. Nie obsługują stref dostępności ani wdrożeń w wielu regionach.

  • Warstwa dewelopera: Obsługuje tylko jedną jednostkę i nie zapewnia obsługi strefy dostępności ani obsługi wielu regionów. Ta warstwa jest przeznaczona dla scenariuszy programowania i testowania. Nie nadaje się do obciążeń produkcyjnych.

  • Warstwa Zużycie: Ma wbudowane możliwości odporności i jest odporny na szereg błędów w jednym centrum danych platformy Azure. Jednak warstwa Zużycie nie zapewnia obsługi stref dostępności ani wdrożeń w wielu regionach. Aby zrozumieć oczekiwany czas działania wystąpienia usługi API Management w warstwie Zużycie, zapoznaj się z umową dotyczącą poziomu usług (SLA).

Jednostki w ramach wystąpienia współpracują ze sobą w celu przetwarzania żądań i automatycznego równoważenia obciążenia między dostępnymi jednostkami. Jeśli jednostka stanie się niedostępna, pozostałe jednostki będą nadal obsługiwać ruch, ale z potencjalnie zmniejszoną pojemnością.

Uwaga / Notatka

Warstwy Developer i Premium usługi API Management obsługują własne bramy, które można uruchamiać we własnej infrastrukturze. W przypadku korzystania z bram hostowanych samodzielnie odpowiadasz za ich skonfigurowanie w celu spełnienia wymagań dotyczących niezawodności. Bramy hostowane samodzielnie znajdują się poza zakresem tego artykułu.

Zalecenia dotyczące wdrażania produkcyjnego

Platforma Azure Well-Architected Framework udostępnia zalecenia dotyczące niezawodności, wydajności, zabezpieczeń, kosztów i operacji. Aby dowiedzieć się, jak te obszary wpływają na siebie i współtworzyć niezawodne rozwiązanie API Management, zobacz Najlepsze rozwiązania dotyczące architektury dla usługi API Management.

Odporność na błędy przejściowe

Błędy przejściowe to krótkotrwałe, sporadyczne awarie w komponentach. Występują one często w środowisku rozproszonym, takich jak chmura, i są one normalną częścią operacji. Błędy przejściowe naprawiają się po krótkim czasie. Ważne jest, aby aplikacje mogły obsługiwać błędy przejściowe, zwykle ponawiając próby żądań, których dotyczy problem.

Wszystkie aplikacje hostowane w chmurze powinny postępować zgodnie ze wskazówkami dotyczącymi obsługi błędów przejściowych platformy Azure podczas komunikowania się z dowolnymi interfejsami API hostowanymi w chmurze, bazami danych i innymi składnikami. Aby uzyskać więcej informacji, zobacz Zalecenia dotyczące obsługi błędów przejściowych.

W przypadku korzystania z usługi API Management przed interfejsem API może być konieczne ponawianie żądań, które kończą się niepowodzeniem z powodu przejściowych błędów. Aby chronić interfejs API zaplecza przed przeciążeniem nadmierną liczbą żądań, usługa API Management zapewnia zasady ponawiania prób, ograniczania szybkości i przydziału. Można również skonfigurować równoważenie obciążenia i możliwości wyłącznika przy użyciu zasobów zaplecza.

Odporność na błędy strefy dostępności

Strefy dostępności są fizycznie oddzielnymi grupami centrów danych w regionie świadczenia usługi Azure. Gdy jedna strefa ulegnie awarii, usługi mogą przejść w tryb failover do jednej z pozostałych stref.

Usługa API Management udostępnia dwa typy obsługi stref dostępności podczas wdrażania wystąpienia usługi API Management w warstwie Premium (klasycznej) w obsługiwanym regionie:

  • Automatyczne: Usługa API Management zapewnia automatyczną obsługę stref dostępności, gdy nie określisz stref dostępności, które mają być używane.

  • Ręcznie: Usługa API Management zapewnia ręczną obsługę stref dostępności, gdy jawnie określisz strefy dostępności, które mają być używane.

Dzięki obsłudze stref dostępności usługa API Management replikuje składniki usługi między strefami w celu zapewnienia wysokiej dostępności. W regionie podstawowym te komponenty obejmują bramę (jednostki skalowania), warstwę zarządzania i portal dewelopera. W regionach pomocniczych replikowane są tylko jednostki bram. Aby uzyskać więcej informacji na temat regionów pomocniczych, zobacz odporność na awarie całego regionu.

Obsługa automatycznej strefy dostępności

Możesz użyć automatycznej obsługi strefy dostępności, aby wybrać pojedynczą jednostkę lub konfigurację wystąpienia wielonitowego w celu osiągnięcia nadmiarowości strefy:

  • Konfiguracja wielodostępna (zalecane): jeśli wystąpienie ma co najmniej dwie jednostki, usługa API Management podejmuje najlepszą próbę rozłożenia jednostek wystąpienia między strefy dostępności regionu. Nie ma możliwości określenia stref dostępności, w których znajdują się jednostki. Zalecamy wdrożenie co najmniej dwóch jednostek, które można dystrybuować w dwóch strefach.

    Na poniższym diagramie przedstawiono wystąpienie usługi API Management z trzema jednostkami skonfigurowanymi do obsługi automatycznej strefy dostępności:

    Diagram przedstawiający trzy jednostki usługi API Management rozproszone w różnych strefach dostępności na potrzeby automatycznej obsługi stref dostępności.

  • Konfiguracja pojedynczej jednostki: Jeśli wystąpienie ma jedną jednostkę, bazowe maszyny wirtualne jednostki są dystrybuowane do dwóch stref dostępności. Nie ma możliwości określenia, do których stref dostępności są przypisane maszyny wirtualne jednostki.

    Diagram przedstawiający pojedynczą jednostkę usługi API Management dystrybuowaną w dwóch strefach dostępności na potrzeby automatycznej obsługi stref dostępności.

Obsługa manualna stref dostępności

Jeśli chcesz jawnie wybrać strefy dostępności do użycia, możesz wybrać konfigurację strefowo nadmiarową i strefową:

  • Strefowo nadmiarowy: Ręcznie skonfiguruj nadmiarowość strefy dla wystąpienia usługi API Management w obsługiwanym regionie, aby zapewnić nadmiarowość składników usługi. Po wybraniu co najmniej dwóch stref dostępności do użycia platforma Azure automatycznie replikuje składniki usługi w wybranych strefach.

    Diagram przedstawiający trzy jednostki usługi API Management rozproszone w różnych strefach dostępności na potrzeby nadmiarowości strefy ręcznej.

  • Strefowego: Składniki usługi API Management są wdrażane w pojedynczej strefie wybranej w regionie świadczenia usługi Azure. Wszystkie jednostki są umieszczane w tej samej strefie dostępności.

    Diagram przedstawiający strefowy wdrożenie usługi API Management, które obejmuje dwie jednostki w jednej strefie dostępności.

    Ważne

    Przypnij do pojedynczej strefy dostępności tylko wtedy, gdy opóźnienie między strefami jest zbyt wysokie dla Twoich potrzeb i po sprawdzeniu, czy opóźnienie nie spełnia wymagań. Samo wystąpienie strefowe nie zapewnia odporności na awarię strefy dostępności. Aby zwiększyć rezyliencję wdrożenia usługi API Management strefowego, należy jawnie wdrożyć oddzielne wystąpienia w wielu strefach dostępności i skonfigurować routing ruchu oraz przełączanie awaryjne.

Wymagania

  • Obsługa regionów: Usługa API Management obsługuje strefy dostępności dla warstwy Premium (klasycznej) we wszystkich regionach świadczenia usługi Azure, które obsługują strefy dostępności.

  • Wymaganie dotyczące warstwy: Aby skonfigurować obsługę stref dostępności, musisz użyć warstwy Premium (klasycznej). Usługa API Management obecnie nie obsługuje stref dostępności w klasycznych warstwach Zużycie, Deweloper, Podstawowa i Standardowa ani w warstwach Podstawowa, 2, Standardowa v2 i Premium w wersji 2. Aby uaktualnić wystąpienie do warstwy Premium (klasycznej), zobacz Uaktualnianie do warstwy Premium.

Uwaga / Notatka

Warstwa Premium v2 z możliwościami przedsiębiorstwa jest dostępna w wersji zapoznawczej. Aby określić, czy projekt powinien polegać na funkcjach wczesnego dostępu, czy ogólnie dostępnych możliwościach, oceń osie czasu projektowania i implementacji w odniesieniu do dostępnych informacji o wersjach i ścieżkach migracji premium w wersji 2.

Rozważania

  • Liczba jednostek dla wystąpień strefowo nadmiarowych: W przypadku ręcznego skonfigurowania nadmiarowości strefy dla wystąpienia należy również skonfigurować wiele jednostek usługi API Management, które można równomiernie dystrybuować we wszystkich wybranych strefach dostępności. Jeśli na przykład wybierzesz dwie strefy, musisz skonfigurować co najmniej dwie jednostki. Zamiast tego można skonfigurować cztery jednostki lub inną wielokrotność dwóch jednostek. W przypadku wybrania trzech stref dostępności należy skonfigurować trzy jednostki, sześć jednostek lub inną wielokrotność trzech jednostek.

    Jeśli używasz obsługi automatycznej strefy dostępności, nie trzeba używać określonej liczby jednostek. Wdrażane jednostki są dystrybuowane między strefy dostępności w najlepszy sposób. W przypadku maksymalnej nadmiarowości strefy zalecamy użycie co najmniej dwóch jednostek w celu zapewnienia, że awaria strefy dostępności nie ma wpływu na wystąpienie.

    Aby określić liczbę jednostek zapewniających wymaganą wydajność bramy, użyj metryk pojemności i własnych testów. Aby uzyskać więcej informacji na temat skalowania i uaktualniania wystąpienia usługi, zobacz Uaktualnianie i skalowanie wystąpienia usługi API Management.

  • Skalowanie automatyczne: Jeśli ręcznie skonfigurujesz strefy dostępności w wystąpieniu usługi API Management skonfigurowanym za pomocą skalowania automatycznego, może być konieczne dostosowanie ustawień autoskalowania po konfiguracji. W takim przypadku liczba jednostek usługi API Management w regułach automatycznego skalowania i limitach musi być wielokrotną liczbą stref. Jeśli używasz obsługi automatycznej strefy dostępności, nie musisz dostosowywać ustawień autoskalowania.

  • Wymagania dotyczące adresów IP: Po włączeniu obsługi strefy dostępności w wystąpieniu usługi API Management wdrożonym w zewnętrznej lub wewnętrznej sieci wirtualnej należy określić zasób publicznego adresu IP, który ma być używany przez wystąpienie. W wewnętrznej sieci wirtualnej publiczny adres IP jest używany tylko dla operacji zarządzania, a nie dla żądań interfejsu API. Aby uzyskać więcej informacji, zobacz Adresy IP w usłudze API Management.

Koszt

Niezależnie od konfiguracji strefy dostępności, jeśli dodasz więcej jednostek, poniesiesz więcej kosztów. Aby uzyskać informacje, zobacz Cennik usługi API Management.

Konfiguruj obsługę stref dostępności

W tej sekcji wyjaśniono, jak skonfigurować obsługę strefy dostępności dla wystąpienia usługi API Management.

Uwaga / Notatka

Wybierając, które strefy dostępności chcesz używać, faktycznie wybierasz logiczną strefę dostępności. W przypadku wdrażania innych składników obciążenia w innej subskrypcji platformy Azure mogą one użyć innego logicznego numeru strefy dostępności, aby uzyskać dostęp do tej samej fizycznej strefy dostępności. Aby uzyskać więcej informacji, zobacz Strefy dostępności fizycznej i logicznej.

  • Utwórz wystąpienie usługi API Management obsługujące strefy dostępności: Podczas tworzenia wystąpienia usługi API Management w warstwie Premium (klasycznej) w regionie obsługującym strefy dostępności wystąpienie domyślnie obsługuje strefy dostępności. Możesz wybrać automatyczne wsparcie dla stref dostępności lub ręcznie skonfigurować wsparcie strefowe bądź nadmiarowe strefowe.

  • Włącz lub skonfiguruj ponownie obsługę strefy dostępności: Możesz zmienić konfigurację strefy dostępności dla wystąpienia usługi API Management, w tym dodać strefy dostępności i przenieść wystąpienie strefowe między strefami dostępności. Aby dowiedzieć się, jak skonfigurować obsługę strefy dostępności w wystąpieniu usługi API Management, zobacz Włączanie obsługi stref dostępności w wystąpieniach usługi API Management. Nie ma żadnych wymagań dotyczących przestojów dla żadnej z opcji konfiguracji.

    Zmiana konfiguracji strefy dostępności może potrwać od 15 do 45 minut lub więcej. Brama zarządzania API może nadal obsługiwać żądania API w tym czasie.

    Zmiana konfiguracji strefy dostępności powoduje zmianę publicznego i prywatnego adresu IP.

Planowanie pojemności i zarządzanie nimi

W scenariuszu w dół strefy nie ma gwarancji, że żądania większej pojemności w innej strefie dostępności powiedzą się. Wypełnianie utraconych jednostek odbywa się w oparciu o najlepsze nakłady pracy. Jeśli potrzebujesz gwarantowanej pojemności, gdy strefa dostępności zakończy się niepowodzeniem, utwórz i skonfiguruj wystąpienie usługi API Management, aby uwzględnić utratę strefy, wykonując wszystkie następujące akcje:

  • Nadmierna aprowizacja jednostek wystąpienia usługi API Management.

  • Użyj konfiguracji strefy dostępności automatycznej lub strefowo nadmiarowej.

Aby uzyskać więcej informacji, zobacz Zarządzanie pojemnością za pomocą nadmiernej aprowizacji.

Użyj metryk pojemności i własnego testowania, aby określić liczbę jednostek zapewniających wymaganą wydajność bramy. Aby uzyskać więcej informacji na temat skalowania i uaktualniania wystąpienia usługi, zobacz Uaktualnianie i skalowanie wystąpienia usługi API Management.

Zachowanie, gdy wszystkie strefy są w dobrej kondycji

W tej sekcji opisano, czego można oczekiwać, gdy wystąpienia usługi API Management są skonfigurowane z obsługą strefy dostępności, a wszystkie strefy dostępności działają.

  • Routing ruchu między strefami: Podczas normalnych operacji ruch jest kierowany między wszystkimi dostępnymi jednostkami zarządzania API we wszystkich wybranych strefach dostępności.

  • Replikacja danych między strefami: Usługa API Management przechowuje i replikuje następujące dane.

    • Konfiguracja bramy, taka jak interfejsy API i definicje zasad, są regularnie synchronizowane między strefami dostępności wybranymi dla wystąpienia. Propagacja aktualizacji między strefami dostępności zwykle trwa mniej niż 10 sekund.

    • Dane w wewnętrznej pamięci podręcznej, jeśli używasz wewnętrznej pamięci podręcznej, którą udostępnia usługa API Management. Wpisy pamięci podręcznej są dystrybuowane między strefami dostępności. Wewnętrzna pamięć podręczna jest niestabilna i nie ma gwarancji, że dane będą utrwalane. Rozważ użycie zewnętrznej pamięci podręcznej, jeśli chcesz utrwalać buforowane dane.

    • Liczniki limitu szybkości, jeśli używasz możliwości ograniczania szybkości oferowanych przez usługę API Management. Liczniki limitu szybkości są asynchroniczne replikowane między strefami dostępności wybranymi dla wystąpienia.

Zachowanie podczas awarii strefy

W tej sekcji opisano, czego można oczekiwać, gdy wystąpienia usługi API Management są skonfigurowane z obsługą strefy dostępności i występuje awaria strefy dostępności.

  • Wykrywanie i reagowanie: Odpowiedzialność za wykrywanie i reagowanie zależy od konfiguracji strefy dostępności używanej przez wystąpienie.

    • Automatyczne i strefowo nadmiarowe: W przypadku wystąpień skonfigurowanych do korzystania z automatycznej obsługi strefy dostępności lub ręcznie skonfigurowanych do korzystania z nadmiarowości strefy platforma API Management jest odpowiedzialna za wykrywanie awarii w strefie dostępności i odpowiadanie. Nie musisz nic robić, aby zainicjować tryb failover strefy.

    • Strefowy: W przypadku instancji skonfigurowanych jako strefowe, należy wykryć utratę strefy dostępności i zainicjować przełączenie do instancji pomocniczej, którą utworzyłeś w innej strefie dostępności.

  • Aktywne żądania: Gdy strefa dostępności jest niedostępna, wszystkie żądania, które są połączone z jednostką usługi API Management w uszkodzonej strefie dostępności, zostaną zakończone i należy je ponowić.

  • Oczekiwana utrata danych: Usługa API Management przechowuje następujące dane.

    • Zmiany konfiguracji bramy, które są replikowane do każdej wybranej strefy dostępności w ciągu około 10 sekund. Jeśli wystąpi awaria strefy dostępności, możesz utracić zmiany konfiguracji, które nie są replikowane.

    • Dane w wewnętrznej pamięci podręcznej, jeśli używasz funkcji wewnętrznej pamięci podręcznej. Wewnętrzna pamięć podręczna jest niestabilna i nie ma gwarancji, że dane będą utrwalane. Podczas przestoju strefy dostępności niektóre lub wszystkie buforowane dane mogą zostać utracone. Rozważ użycie zewnętrznej pamięci podręcznej, jeśli chcesz utrwalać buforowane dane.

    • Liczniki limitu szybkości, jeśli używasz funkcji limitu szybkości. Podczas awarii strefy dostępności liczniki limitu szybkości mogą nie być up-to-date w strefach ocalałych.

  • Oczekiwany przestój: Oczekiwany przestój zależy od konfiguracji strefy dostępności używanej przez wystąpienie.

    • Automatyczne: Możesz oczekiwać, że wystąpienia korzystające z automatycznej obsługi strefy dostępności nie będą miały przestoju podczas przestoju strefy dostępności. Jednostki w strefie lub strefach, których nie dotyczy, nadal działają.

      Możesz również oczekiwać, że wystąpienia, które korzystają z automatycznej obsługi strefy dostępności, ale mają jedną jednostkę, nie mają przestojów. W takim przypadku usługa API Management dystrybuuje bazowe maszyny wirtualne jednostki do dwóch stref. Maszyna wirtualna w niezmienionej strefie nadal działa.

    • Strefowo nadmiarowy: Wystąpienia strefowo nadmiarowe mogą nie mieć przestojów podczas przestoju strefy dostępności.

    • Strefowe: W przypadku instancji strefowych, gdy strefa jest niedostępna, instancja jest niedostępna do momentu odzyskania strefy dostępności.

  • Przekierowywanie ruchu: Zachowanie przekierowywania ruchu zależy od konfiguracji strefy dostępności, której używa wystąpienie.

    • Automatyczne i strefowo nadmiarowe: W przypadku wystąpień skonfigurowanych do korzystania z automatycznej obsługi strefy dostępności lub ręcznie skonfigurowanych do używania nadmiarowości strefy, gdy strefa jest niedostępna, wszystkie jednostki w strefie, których dotyczy problem, są również niedostępne. Możesz wybrać skalowanie wystąpienia, aby dodać więcej jednostek.

    • Strefowego: W przypadku wystąpień strefowych, gdy strefa jest niedostępna, wystąpienie jest niedostępne. Jeśli masz wystąpienie pomocnicze w innej strefie dostępności, odpowiadasz za przekierowywanie ruchu do tego wystąpienia pomocniczego.

Odzyskiwanie strefy

Zachowanie odzyskiwania stref zależy od konfiguracji strefy dostępności, której używa Twoja instancja.

  • Automatyczne i strefowo nadmiarowe: W przypadku wystąpień skonfigurowanych do korzystania z automatycznej obsługi strefy dostępności lub ręcznie skonfigurowanych do korzystania z nadmiarowości strefy, gdy strefa dostępności zostanie odzyskana, usługa API Management automatycznie przywraca jednostki w strefie dostępności i przekierowuje ruch między jednostkami w zwykły sposób.

  • Strefowego: W przypadku wystąpień strefowych odpowiadasz za przekierowywanie ruchu do wystąpienia w oryginalnej strefie dostępności po odzyskaniu strefy dostępności.

Testowanie pod kątem niepowodzeń strefy

Opcje testowania błędów strefy zależą od konfiguracji strefy dostępności używanej przez wystąpienie.

  • Automatyczne i strefowo nadmiarowe: W przypadku wystąpień skonfigurowanych do korzystania z automatycznej obsługi strefy dostępności lub ręcznie skonfigurowanych do korzystania z nadmiarowości strefy platforma API Management zarządza routingiem ruchu, trybem failover i powrotem po awarii. Ta funkcja jest w pełni zarządzana, więc nie trzeba inicjować ani weryfikować procesów awarii strefy dostępności.

  • Strefowego: W przypadku wystąpień strefowych nie ma możliwości symulowania awarii strefy dostępności zawierającej wystąpienie usługi API Management. Można jednak ręcznie skonfigurować nadrzędne bramy lub moduły równoważenia obciążenia, aby przekierowywać ruch do innego wystąpienia w innej strefie dostępności.

Odporność na awarie całego regionu

Wdrożenie w wielu regionach umożliwia dodawanie regionalnych bram API do istniejącego wystąpienia usługi API Management w co najmniej jednym obsługiwanym regionie Azure. Wdrożenie w wielu regionach pomaga zmniejszyć opóźnienia żądań postrzegane przez geograficznie rozproszonych użytkowników interfejsu API. Wdrożenie w wielu regionach zwiększa również dostępność usługi, jeśli jeden region przejdzie w tryb offline.

Wdrażanie zarządzane przez firmę Microsoft w wielu regionach

Usługa API Management obsługuje tylko wdrożenia w wielu regionach w warstwie Premium (wersja klasyczna). Nie obsługuje wdrożeń w wielu regionach w warstwach Zużycie, Deweloper, Podstawowa, Podstawowa v2, Standardowa, Standardowa v2 i Premium v2 (wersja zapoznawcza). Aby uzyskać więcej informacji, zobacz Wymagania.

Podczas dodawania regionu konfigurujesz:

Wymagania

  • Obsługa regionów: Wdrożenia w wielu regionach można tworzyć w warstwie Premium (wersja klasyczna) z dowolnym regionem platformy Azure obsługującym usługę API Management. Aby zobaczyć, które regiony obsługują wdrożenia w wielu regionach, zobacz Dostępność produktów według regionów.

  • Wymaganie dotyczące warstwy: Aby skonfigurować obsługę wielu regionów, należy użyć warstwy Premium (klasycznej). Aby uaktualnić wystąpienie do warstwy Premium (klasycznej), zobacz Uaktualnianie do warstwy Premium.

Uwaga / Notatka

Warstwa Premium w wersji 2 z możliwościami przedsiębiorstwa jest dostępna w wersji zapoznawczej. Aby określić, czy projekt powinien polegać na funkcjach wczesnego dostępu, czy ogólnie dostępnych możliwościach, oceń osie czasu projektowania i implementacji w odniesieniu do dostępnych informacji o wersjach i ścieżkach migracji premium w wersji 2.

Rozważania

  • Tylko brama: Tylko składnik bramy wystąpienia usługi API Management jest replikowany do wielu regionów. Płaszczyzna zarządzania wystąpienia i portal deweloperów pozostają hostowane tylko w regionie podstawowym, w którym pierwotnie wdrożono usługę.

  • Wymagania dotyczące sieci: Jeśli chcesz skonfigurować lokalizację pomocniczą dla wystąpienia usługi API Management po wdrożeniu (wstrzyknięciu) w sieci wirtualnej, sieć wirtualna i region podsieci powinny być zgodne z skonfigurowaną lokalizacją pomocniczą. Jeśli dodasz, usuniesz lub włączysz strefę dostępności w regionie podstawowym lub zmienisz podsieć regionu podstawowego, zmieni się wirtualny adres IP (VIP) wystąpienia usługi API Management. Aby uzyskać więcej informacji, zobacz Zmiany w adresach IP. Jeśli jednak dodasz region pomocniczy, adres VIP regionu podstawowego nie zmieni się, ponieważ każdy region ma własny prywatny adres VIP.

  • Nazwy systemu nazw domen (DNS): Brama w każdym regionie, w tym region podstawowy, ma regionalną nazwę DNS zgodną ze wzorcem https://<service-name>-<region>-01.regional.azure-api.netadresu URL , na przykład https://contoso-westus2-01.regional.azure-api.net.

Koszt

Dodawanie regionów wiąże się z kosztami. Aby uzyskać informacje, zobacz Cennik usługi API Management.

Konfigurowanie obsługi wielu regionów

Aby skonfigurować obsługę wielu regionów w wystąpieniu usługi API Management, zobacz Wdrażanie wystąpienia usługi API Management w wielu regionach świadczenia usługi Azure.

Aby usunąć region z wystąpienia usługi API Management, zobacz Usuwanie regionu usługi API Management.

Planowanie pojemności i zarządzanie nimi

W scenariuszu w dół regionu nie ma gwarancji, że żądania większej pojemności w innym regionie zostaną wykonane pomyślnie. Jeśli potrzebujesz gwarantowanej pojemności w przypadku awarii regionu, utwórz i skonfiguruj wystąpienie usługi API Management, aby uwzględnić utratę regionu. Można to zrobić, nadmiernie aprowizując pojemność wystąpienia usługi API Management. Aby dowiedzieć się więcej na temat zasady nadmiernej aprowizacji, zobacz Zarządzanie pojemnością za pomocą nadmiernej aprowizacji.

W przypadku wdrożeń obejmujących wiele regionów skalowanie automatyczne ma zastosowanie tylko do regionu podstawowego. Regiony pomocnicze wymagają ręcznej regulacji skalowania lub użycia narzędzi niestandardowych, którymi zarządzasz.

Zachowanie, gdy wszystkie regiony są w dobrej kondycji

W tej sekcji opisano, czego można oczekiwać, gdy wystąpienia usługi API Management są skonfigurowane z obsługą wielu regionów, a wszystkie regiony działają.

  • Routing ruchu między regionami: Usługa API Management automatycznie kieruje żądania przychodzące do bramy regionalnej. Żądanie jest kierowane do bramy regionalnej z najniższym opóźnieniem dla klienta. Jeśli musisz użyć innego podejścia do routingu, możesz skonfigurować własną usługę Traffic Manager przy użyciu niestandardowych reguł routingu. Aby uzyskać więcej informacji, zobacz Używanie routingu niestandardowego do bram regionalnych usługi API Management.

    Gdy żądanie dociera do bramy regionalnej usługi API Management, jest kierowane do interfejsu API zaplecza, chyba że zasady zwracają odpowiedź bezpośrednio z bramy, taką jak buforowana odpowiedź lub kod błędu. W rozwiązaniu z wieloma regionami należy zadbać o kierowanie do wystąpienia interfejsu API zaplecza spełniającego wymagania dotyczące wydajności. Aby uzyskać więcej informacji, zobacz Route API calls to regional backend services (Kierowanie wywołań interfejsu API do regionalnych usług zaplecza).

  • Replikacja danych między regionami: Konfiguracja bramy, taka jak interfejsy API i definicje zasad, jest regularnie synchronizowana między dodanymi regionami podstawowymi i pomocniczymi. Propagacja aktualizacji do bram regionalnych zwykle trwa mniej niż 10 sekund.

    Liczniki limitu szybkości i dane w wewnętrznej pamięci podręcznej są specyficzne dla regionu, więc nie są replikowane między regionami.

Zachowanie podczas awarii regionu

W tej sekcji opisano, czego można oczekiwać po skonfigurowaniu wystąpień usługi API Management z obsługą wielu regionów i awarii w jednym z używanych regionów.

  • Wykrywanie i reagowanie: Usługa API Management jest odpowiedzialna za wykrywanie awarii w regionie i automatyczne przełączanie w tryb failover do bramy w jednym z innych skonfigurowanych regionów.

  • Aktywne żądania: Wszystkie aktywne żądania przetwarzane w uszkodzonym regionie mogą zostać usunięte i powinny zostać ponowione przez klienta.

  • Oczekiwana utrata danych: Usługa API Management nie przechowuje danych, z wyjątkiem konfiguracji, pamięci podręcznej i liczników limitu szybkości.

    Zmiany konfiguracji są replikowane do każdego regionu w ciągu około 10 sekund. Jeśli wystąpi awaria regionu podstawowego, możesz utracić zmiany konfiguracji, które nie są replikowane.

    Liczniki limitu szybkości i dane w wewnętrznej pamięci podręcznej są specyficzne dla regionu, więc nie są replikowane między regionami.

  • Oczekiwany przestój: Nie oczekiwano przestoju bramy.

    Jeśli region podstawowy przejdzie w tryb offline, płaszczyzna zarządzania usługą API Management i portal dla deweloperów staną się niedostępne, ale regiony pomocnicze nadal obsługują żądania interfejsu API przy użyciu najnowszej konfiguracji bramy.

  • Przekierowywanie ruchu: Jeśli region przejdzie w tryb offline, żądania interfejsu API są automatycznie kierowane wokół regionu, który zakończył się niepowodzeniem, do następnej najbliższej bramy.

Odzyskiwanie regionów

Po odzyskaniu regionu podstawowego usługa API Management automatycznie przywraca jednostki w regionie i przekierowuje ruch między jednostkami.

Testowanie pod kątem błędów regionów

Aby przygotować się do nieoczekiwanych awarii regionów, zalecamy regularne testowanie odpowiedzi na błędy regionów. Niektóre aspekty awarii regionu można symulować, wyłączając routing do bramy regionalnej.

Tworzenie kopii zapasowej i przywracanie

Usługa API Management nie przechowuje większości danych środowiska uruchomieniowego. Można jednak utworzyć kopię zapasową konfiguracji usługi API Management. Można również użyć operacji tworzenia i przywracania kopii zapasowych, aby replikować konfiguracje usługi API Management między środowiskami operacyjnymi, na przykład programowanie i przemieszczanie.

Ważne

W procedurze tworzenia kopii zapasowej uwzględniane są dane środowiska uruchomieniowego, takie jak użytkownicy i subskrypcje, co może nie zawsze być pożądane.

Tworzenie kopii zapasowych jest obsługiwane w warstwach Developer, Basic, Standard i Premium.

Aby uzyskać więcej informacji, zobacz Jak zaimplementować odzyskiwanie po awarii przy użyciu kopii zapasowej i przywracania usługi w usłudze API Management.

W przypadku tworzenia kopii zapasowych lub przywracania niektórych składników usługi lub zasobów można również rozważyć opcje zarządzane przez klienta, takie jak narzędzia APIOps i infrastruktura jako rozwiązania kodu (IaC).

Odporność usługi na prace konserwacyjne

Usługa API Management wykonuje regularne uaktualnienia usług i inne formy konserwacji.

W warstwach Podstawowa, Standardowa i Premium (wersja klasyczna) można dostosować moment, w którym wystąpienie otrzymuje aktualizację podczas procesu aktualizacji. Jeśli musisz zweryfikować wpływ uaktualnień na obciążenie, rozważ skonfigurowanie wystąpienia testowego w celu otrzymywania aktualizacji na początku cyklu aktualizacji i ustawienie wystąpienia produkcyjnego na odbieranie aktualizacji pod koniec cyklu. Możesz również określić okno obsługi, czyli godzinę dnia, w którym wystąpienie ma stosować aktualizacje usługi.

Aby uzyskać więcej informacji, zobacz Konfigurowanie ustawień aktualizacji usługi dla wystąpień usługi API Management.

Umowa dotycząca poziomu usług

Umowa dotycząca poziomu usług (SLA) dla usług platformy Azure opisuje oczekiwaną dostępność każdej usługi oraz warunki, które rozwiązanie musi spełnić, aby osiągnąć te oczekiwania dotyczące dostępności. Aby uzyskać więcej informacji, zobacz Umowy SLA dotyczące usług online.

Podczas wdrażania wystąpienia usługi API Management w wielu strefach dostępności lub regionach zwiększa się procent czasu działania zdefiniowany w umowie SLA.

Usługa zapewnia własną umowę SLA, ale musisz również uwzględnić przewidywaną niezawodność innych składników obciążenia, takich jak zaplecza interfejsu API.

Treści powiązane

  • Last updated on