Używanie zewnętrznej pamięci podręcznej zgodnej z usługą Redis w usłudze Azure API Management

Artykuł
10/14/2024

DOTYCZY: Wszystkie warstwy usługi API Management

Oprócz korzystania z wbudowanej pamięci podręcznej usługa Azure API Management umożliwia buforowanie odpowiedzi w zewnętrznej pamięci podręcznej zgodnej z usługą Redis, takiej jak usługa Azure Cache for Redis.

Użycie zewnętrznej pamięci podręcznej pozwala przezwyciężyć kilka ograniczeń wbudowanej pamięci podręcznej:

uniknąć okresowego czyszczenia pamięci podręcznej podczas aktualizacji usługi API Management;
mieć większą kontrolę nad konfiguracją pamięci podręcznej;
Buforowanie większej ilości danych niż zezwala warstwa usługi API Management
używać buforowania z warstwą Zużycie usługi API Management.
Włączanie buforowania w bramie samoobsługowej usługi API Management

Aby uzyskać bardziej szczegółowe informacje na temat buforowania, zobacz Zasady buforowania w usłudze API Management i Buforowanie niestandardowe w usłudze Azure API Management.

Uwaga

Obecnie ta funkcja nie jest dostępna w obszarach roboczych.

Dodawanie własnej pamięci podręcznej do usługi APIM

Zawartość:

Dodawanie zewnętrznej pamięci podręcznej w usłudze API Management

Wymagania wstępne

Do ukończenia tego samouczka niezbędne są następujące elementy:

Tworzenie pamięci podręcznej Azure Cache for Redis

W tej sekcji opisano, jak utworzyć pamięć podręczną Azure Cache for Redis na platformie Azure. Jeśli masz już pamięć podręczną Azure Cache for Redis lub inną pamięć podręczną zgodną z usługą Redis lub poza platformą Azure, możesz przejść do następnej sekcji.

Aby utworzyć pamięć podręczną, zaloguj się do witryny Azure Portal. W menu portalu wybierz pozycję Utwórz zasób.
W okienku Wprowadzenie wprowadź ciąg Azure Cache for Redis na pasku wyszukiwania. W wynikach wyszukiwania znajdź usługę Azure Cache for Redis, a następnie wybierz pozycję Utwórz.

W okienku Nowa pamięć podręczna Redis Cache na karcie Podstawy skonfiguruj następujące ustawienia dla pamięci podręcznej:

Ustawienie	Akcja	opis
Subskrypcja	Wybierz subskrypcję platformy Azure.	Subskrypcja do użycia w celu utworzenia nowego wystąpienia usługi Azure Cache for Redis.
Grupa zasobów:	Wybierz grupę zasobów lub wybierz pozycję Utwórz nową i wprowadź nową nazwę grupy zasobów.	Nazwa grupy zasobów, w której ma zostać utworzona pamięć podręczna i inne zasoby. Umieszczając wszystkie zasoby aplikacji w jednej grupie zasobów, można je łatwo zarządzać lub usuwać razem.
Nazwa DNS	Wprowadź unikatową nazwę.	Nazwa pamięci podręcznej musi być ciągiem od 1 do 63 znaków, który zawiera tylko cyfry, litery i łączniki. Nazwa musi zaczynać się i kończyć cyfrą lub literą i nie może zawierać kolejnych łączników. Nazwa hosta wystąpienia pamięci podręcznej to `\<DNS name>.redis.cache.windows.net`.
Lokalizacja	Wybierz lokalizację.	Region platformy Azure, który znajduje się w pobliżu innych usług korzystających z pamięci podręcznej.
Jednostka SKU pamięci podręcznej	Wybierz jednostkę SKU.	Jednostka SKU określa rozmiar, wydajność i parametry funkcji, które są dostępne dla pamięci podręcznej. Aby uzyskać więcej informacji, zobacz Omówienie usługi Azure Cache for Redis.
Rozmiar pamięci podręcznej	Wybierz rozmiar pamięci podręcznej.	Aby uzyskać więcej informacji, zobacz Omówienie usługi Azure Cache for Redis.

Wybierz kartę Sieć lub wybierz pozycję Dalej: Sieć.
Na karcie Sieć wybierz metodę łączności do użycia dla pamięci podręcznej.
Wybierz kartę Zaawansowane lub wybierz pozycję Dalej: Zaawansowane.
W okienku Zaawansowane sprawdź lub wybierz metodę uwierzytelniania na podstawie następujących informacji:
- Domyślnie w przypadku nowej pamięci podręcznej w warstwie Podstawowa, Standardowa lub Premium jest włączone uwierzytelnianie Entra firmy Microsoft, a uwierzytelnianie kluczy dostępu jest wyłączone.
- W przypadku pamięci podręcznych w warstwie Podstawowa lub Standardowa można wybrać opcję portu innego niż TLS.
- W przypadku pamięci podręcznych w warstwie Standardowa i Premium można włączyć strefy dostępności. Po utworzeniu pamięci podręcznej nie można wyłączyć stref dostępności.
- W przypadku pamięci podręcznej Premium skonfiguruj ustawienia portów innych niż TLS, klastrowanie, tożsamość zarządzana i trwałość danych.
Ważne

W celu uzyskania optymalnego bezpieczeństwa zalecamy użycie identyfikatora Entra firmy Microsoft z tożsamościami zarządzanymi w celu autoryzowania żądań względem pamięci podręcznej, jeśli to możliwe. Autoryzacja przy użyciu identyfikatora Entra firmy Microsoft i tożsamości zarządzanych zapewnia doskonałe zabezpieczenia i łatwość korzystania z autoryzacji klucza dostępu współdzielonego. Aby uzyskać więcej informacji na temat używania tożsamości zarządzanych z pamięcią podręczną, zobacz Use Microsoft Entra ID for cache authentication (Używanie identyfikatora Entra firmy Microsoft do uwierzytelniania w pamięci podręcznej).
(Opcjonalnie) Wybierz kartę Tagi lub wybierz pozycję Dalej: Tagi.
(Opcjonalnie) Na karcie Tagi wprowadź nazwę i wartość tagu, jeśli chcesz podzielić zasób pamięci podręcznej.
Wybierz przycisk Przejrzyj i utwórz.

Na karcie Przeglądanie i tworzenie platforma Azure automatycznie weryfikuje konfigurację.
Po pojawieniu się zielonego komunikatu Weryfikacja przekazana wybierz pozycję Utwórz.

Nowe wdrożenie pamięci podręcznej odbywa się w ciągu kilku minut. Postęp wdrażania można monitorować w okienku Przegląd usługi Azure Cache for Redis. Gdy zostanie wyświetlony stan Uruchomiono, pamięć podręczna jest gotowa do użycia.

Wdrażanie pamięci podręcznej Redis Cache na platformie Kubernetes

W przypadku własnej bramy buforowanie wymaga zewnętrznej pamięci podręcznej. Aby buforowanie było skuteczne, brama hostowana samodzielnie i pamięć podręczna, na której się opiera, musi znajdować się blisko siebie, aby zminimalizować opóźnienia wyszukiwania i przechowywania. Wdrażanie pamięci podręcznej Redis Cache w tym samym klastrze Kubernetes lub w oddzielnym klastrze znajdującym się w pobliżu to najlepsze opcje. Dowiedz się, jak wdrożyć pamięć podręczną Redis cache w klastrze Kubernetes.

Dodawanie zewnętrznej pamięci podręcznej

Wykonaj poniższe kroki, aby dodać zewnętrzną pamięć podręczną zgodną z usługą Redis w usłudze Azure API Management. Pamięć podręczną można ograniczyć do określonej bramy w wystąpieniu usługi API Management.

Zrzut ekranu przedstawiający sposób dodawania zewnętrznej pamięci podręcznej Azure Cache for Redis w usłudze Azure API Management.

Użyj z ustawienia

Ustawienie Użyj z w konfiguracji określa lokalizację wystąpienia usługi API Management, które będzie używać pamięci podręcznej. Wybierz jedną z następujących opcji:

Region świadczenia usługi Azure, w którym jest hostowane wystąpienie usługi API Management (lub jedna ze skonfigurowanych lokalizacji, jeśli masz wdrożenie w wielu regionach )
Lokalizacja bramy hostowanej samodzielnie
Domyślnie, aby skonfigurować pamięć podręczną jako domyślną dla wszystkich lokalizacji bramy w wystąpieniu usługi API Management

Pamięć podręczna używana dla opcji Domyślne zostanie zastąpiona przez pamięć podręczną używaną dla określonego pasującego regionu lub lokalizacji.

Rozważmy na przykład wystąpienie usługi API Management hostowane w regionach Wschodnie stany USA, Azja Południowo-Wschodnia i Europa Zachodnia. Skonfigurowano dwie pamięci podręczne: jedną dla opcji Default i jedną dla Azji Południowo-Wschodniej. W tym przykładzie usługa API Management w Azji Południowo-Wschodniej będzie używać własnej pamięci podręcznej, podczas gdy pozostałe dwa regiony będą używać pozycji Domyślna pamięć podręczna.

Uwaga

Tę samą zewnętrzną pamięć podręczną można skonfigurować dla więcej niż jednego wystąpienia usługi API Management. Wystąpienia usługi API Management mogą znajdować się w tych samych lub różnych regionach. Podczas udostępniania pamięci podręcznej dla więcej niż jednego wystąpienia należy wybrać pozycję Domyślne w ustawieniu Użyj z .

Dodawanie pamięci podręcznej Azure Cache for Redis z tej samej subskrypcji

Przejdź do wystąpienia usługi API Management w witrynie Azure Portal.
Wybierz kartę Zewnętrzna pamięć podręczna z menu po lewej stronie.
Wybierz przycisk + Dodaj.
Wybierz swoją pamięć podręczną w polu rozwijanym Wystąpienie pamięci podręcznej.
Wybierz pozycję Domyślne lub określ żądany region w polu listy rozwijanej Użyj z.
Wybierz pozycję Zapisz.

Dodawanie pamięci podręcznej zgodnej z usługą Redis hostowanej poza bieżącą subskrypcją platformy Azure lub platformą Azure w ogóle

Przejdź do wystąpienia usługi API Management w witrynie Azure Portal.
Wybierz kartę Zewnętrzna pamięć podręczna z menu po lewej stronie.
Wybierz przycisk + Dodaj.
Wybierz pozycję Niestandardowe w polu rozwijanym Wystąpienie pamięci podręcznej.
Wybierz pozycję Domyślne lub określ żądany region w polu listy rozwijanej Użyj z.
Podaj pamięć podręczną Azure Cache for Redis (lub pamięć podręczną zgodną z usługą Redis) parametry połączenia w polu Parametry połączenia.
Wybierz pozycję Zapisz.

Dodawanie pamięci podręcznej Redis Cache do własnej bramy

Przejdź do wystąpienia usługi API Management w witrynie Azure Portal.
Wybierz kartę Zewnętrzna pamięć podręczna z menu po lewej stronie.
Wybierz przycisk + Dodaj.
Wybierz pozycję Niestandardowe w polu rozwijanym Wystąpienie pamięci podręcznej.
Określ żądaną lokalizację bramy self-hosted lub wartość domyślną w polu listy rozwijanej Użyj z listy rozwijanej.
W polu Parametry połączenia podaj parametry połączenia swojej pamięci podręcznej Redis.
Wybierz pozycję Zapisz.