Megosztás a következőn keresztül:


Külső Redis-kompatibilis gyorsítótár használata az Azure API Managementben

A KÖVETKEZŐRE VONATKOZIK: Minden API Management-szint

A beépített gyorsítótár használata mellett az Azure API Management lehetővé teszi a válaszok gyorsítótárazását egy külső Redis-kompatibilis gyorsítótárban, például az Azure Managed Redisben.

A külső gyorsítótár használatával áthidalhatja a beépített gyorsítótár néhány korlátozását:

  • Kerülje a gyorsítótár rendszeres törlését az API Management frissítései során
  • Nagyobb szabályozás a gyorsítótár konfigurációja felett
  • Több adat gyorsítótárazva, mint amennyit az API Management-szint lehetővé tesz
  • Gyorsítótárazás használata az API Management használati rétegével
  • Gyorsítótárazás engedélyezése az API Management saját üzemeltetésű átjárójában

A gyorsítótárazás hátterével és forgatókönyveivel kapcsolatban lásd a gyorsítótárazás áttekintése című részt.

A gyorsítótárazással kapcsolatos részletes információk: Az API Management gyorsítótárazási szabályzatai és Egyéni gyorsítótárazás az Azure API Managementben.

Feljegyzés

Ez a funkció jelenleg nem érhető el a munkaterületeken.

Ismertetett témák:

  • Külső gyorsítótár hozzáadása az API Managementben

Előfeltételek

Az oktatóanyag elvégzéséhez a következőkre lesz szüksége:

  • Azure API Management-példány létrehozása

  • Az Azure API Management gyorsítótárazásának ismertetése

  • Rendelkezésre áll egy Azure Managed Redis vagy egy másik Redis-kompatibilis gyorsítótár.

    Fontos

    Az Azure API Management egy Redis kapcsolati sztring használatával csatlakozik a gyorsítótárhoz. Ha az Azure Managed Redist használja, engedélyezze a hozzáférési kulcsalapú hitelesítést a gyorsítótárban, hogy kapcsolati karakterláncot használjon. Jelenleg nem használhatJa a Microsoft Entra-hitelesítést az Azure API Management és az Azure Managed Redis összekapcsolásához.

Redis Cache a Kuberneteshez

A saját üzemeltetésű API Management-átjárók gyorsítótárazásához külső gyorsítótárra van szükség. Ahhoz, hogy a gyorsítótárazás hatékony legyen, egy saját üzemeltetésű átjárónak és az általa használt gyorsítótárnak egymás közelében kell lennie a keresés és a késések minimalizálása érdekében. A redis-gyorsítótár üzembe helyezése ugyanabban a Kubernetes-fürtben vagy egy közeli külön fürtben a legjobb megoldás. Megtudhatja, hogyan helyezhet üzembe Redis Cache-gyorsítótárat egy Kubernetes-fürtön.

Külső gyorsítótár hozzáadása

Kövesse az alábbi lépéseket egy külső Redis-kompatibilis gyorsítótár hozzáadásához az Azure API Managementben. A gyorsítótárat egy adott átjáróra korlátozhatja az API Management-példányban.

Képernyőkép arról, hogyan vehet fel külső Azure Managed Redis-gyorsítótárat az Azure API Managementben.

Használat a beállításból

A konfigurációban a Használat beállítás határozza meg annak az API Management-példánynak a helyét, amely a gyorsítótárat fogja használni. Válasszon az alábbiak közül:

  • Az Az Azure-régió, ahol az API Management-példány üzemel (vagy egy konfigurált hely, ha többrégiós üzembe helyezéssel rendelkezik)

  • Saját üzemeltetésű átjáró helye

  • Alapértelmezés szerint a gyorsítótár beállítása alapértelmezettként az API Management-példány összes átjáróhelyén

    Az alapértelmezett gyorsítótárat felülírja egy adott régióhoz vagy helyhez használt gyorsítótár.

    Vegyük például az USA keleti, délkelet-ázsiai és nyugat-európai régióiban üzemeltetett API Management-példányt. Két gyorsítótár van konfigurálva, egy az alapértelmezett és egy Délkelet-Ázsia számára. Ebben a példában a délkelet-ázsiai API Management saját gyorsítótárat használ, míg a másik két régió az Alapértelmezett gyorsítótár-bejegyzést használja.

Feljegyzés

Ugyanazt a külső gyorsítótárat több API Management-példányhoz is konfigurálhatja. Az API Management-példányok ugyanabban vagy különböző régiókban lehetnek. Ha egynél több példány gyorsítótárát osztja meg, a Használat beállításnál az Alapértelmezett lehetőséget kell választania.

Azure Managed Redis-példány hozzáadása ugyanabból az előfizetésből

  1. Keresse meg az API Management-példányt az Azure Portalon.
  2. A bal oldali menü Üzembe helyezés + infrastruktúra területén válassza a Külső gyorsítótár lehetőséget.
  3. Válassza a + Hozzáadás lehetőséget.
  4. A Gyorsítótárpéldány legördülő listában válassza ki a gyorsítótárat.
  5. A Használat legördülő listában válassza az Alapértelmezett lehetőséget, vagy adja meg a kívánt régiót. A kapcsolati sztring automatikusan fel lesz töltve.
  6. Válassza a Mentés lehetőséget.

Feljegyzés

Az alapértelmezett kapcsolati sztring a következő formátumban van: <cache-name>:10000,password=<cache-access-key>,ssl=True,abortConnect=False. Az API Management a sztringet titkos névvel ellátott értékként tárolja. Ha a hozzáférési kulcs elforgatásához vagy a kapcsolati problémák elhárításához meg kell tekintenie vagy szerkesztenie kell a karakterláncot, lépjen az Elnevezett értékek lapra.

Az aktuális Azure-előfizetésen vagy általában az Azure-on kívül üzemeltetett Redis-kompatibilis gyorsítótár hozzáadása

  1. Keresse meg az API Management-példányt az Azure Portalon.
  2. A bal oldali menü Üzembe helyezés + infrastruktúra területén válassza a Külső gyorsítótár lehetőséget.
  3. Válassza a + Hozzáadás lehetőséget.
  4. A Gyorsítótárpéldány legördülő listában válassza az Egyéni lehetőséget.
  5. A Használat legördülő listában válassza az Alapértelmezett lehetőséget, vagy adja meg a kívánt régiót.
  6. Adja meg az Azure Managed Redis vagy a Redis-kompatibilis gyorsítótár-kapcsolati karakterláncot a Kapcsolati karakterlánc mezőben.
  7. Válassza a Mentés lehetőséget.

Redis-gyorsítótár hozzáadása saját üzemeltetésű átjáróhoz

  1. A bal oldali menü Üzembe helyezés + infrastruktúra területén válassza a Külső gyorsítótár lehetőséget.
  2. Válassza a + Hozzáadás lehetőséget.
  3. A Gyorsítótárpéldány legördülő listában válassza az Egyéni lehetőséget.
  4. A Használat legördülő listában válassza az Alapértelmezett lehetőséget, vagy adja meg a kívánt régiót.
  5. Adja meg a Redis cache kapcsolati sztring a Kapcsolat sztring mezőjében.
  6. Válassza a Mentés lehetőséget.

A külső gyorsítótár használata

A Redis-kompatibilis gyorsítótár hozzáadása után konfiguráljon gyorsítótárazási szabályzatokat a válasz gyorsítótárazásának vagy az értékek kulcs szerinti gyorsítótárazásának engedélyezéséhez a külső gyorsítótárban.

Részletes példa: Gyorsítótárazás hozzáadása az Azure API Management teljesítményének javításához.