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 Cache for 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á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

Azure Cache for Redis létrehozása

Ez a szakasz bemutatja, hogyan hozhat létre Azure Cache for Redist az Azure-ban. Ha már rendelkezik Azure Cache for Redis-sel vagy egy másik Redis-kompatibilis gyorsítótárral az Azure-on belül vagy kívül, ugorjon a következő szakaszra.

1. Gyorsítótár létrehozásához jelentkezzen be az Azure Portalra. A portál menüjében válassza az Erőforrás létrehozása lehetőséget.

   

2. Az Első lépések panelen írja be az Azure Cache for Redist a keresősávba. A keresési eredmények között keresse meg az Azure Cache for Redist, majd válassza a Létrehozás lehetőséget.

   

3. Az Új Redis Cache panel Alapszintű beállítások lapján konfigurálja a következő beállításokat a gyorsítótárhoz:

   Beállítás	Művelet	Leírás
   Előfizetés	Válassza ki az Azure-előfizetését.	Az Azure Cache for Redis új példányának létrehozásához használandó előfizetés.
   Erőforráscsoport	Jelöljön ki egy erőforráscsoportot, vagy válassza az Új létrehozása lehetőséget, és adjon meg egy új erőforráscsoportnevet.	Annak az erőforráscsoportnak a neve, amelyben létre szeretné hozni a gyorsítótárat és más erőforrásokat. Ha az összes alkalmazás-erőforrást egy erőforráscsoportba helyezi, egyszerűen kezelheti vagy törölheti őket.
   DNS-név	Adjon meg egy egyedi nevet.	A gyorsítótár nevének 1–63 karakterből álló sztringnek kell lennie, amely csak számokat, betűket és kötőjeleket tartalmaz. A névnek számmal vagy betűvel kell kezdődnie és végződnie, és nem tartalmazhat egymást követő kötőjeleket. A gyorsítótárpéldány gazdagépneve .\<DNS name>.redis.cache.windows.net
   Helyen	Válasszon ki egy helyet.	Olyan Azure-régió , amely a gyorsítótárat használó egyéb szolgáltatások közelében található.
   Gyorsítótár termékváltozata	Válasszon egy termékváltozatot.	Az termékváltozat határozza meg a gyorsítótár számára elérhető méretet, teljesítményt és funkcióparamétereket. További információ: Azure Cache for Redis – áttekintés.
   Gyorsítótár mérete	Válasszon egy gyorsítótárméretet.	További információ: Azure Cache for Redis – áttekintés.

4. Válassza a Hálózatkezelés lapot, vagy válassza a Tovább: Hálózatkezelés lehetőséget.

5. A Hálózatkezelés lapon válassza ki a gyorsítótárhoz használni kívánt kapcsolati módszert.

6. Válassza a Speciális lapot, vagy válassza a Tovább: Speciális lehetőséget.

7. A Speciális panelen ellenőrizze vagy válassza ki a hitelesítési módszert az alábbi információk alapján:

   

   • Alapértelmezés szerint egy új alapszintű, standard vagy prémium szintű gyorsítótár esetében a Microsoft Entra-hitelesítés engedélyezve van, és a hozzáférési kulcsok hitelesítése le van tiltva.
   • Alapszintű vagy standard gyorsítótárak esetén kiválaszthatja a nem TLS-portok kiválasztását.
   • Standard és Prémium szintű gyorsítótárak esetén engedélyezheti a rendelkezésre állási zónákat. A gyorsítótár létrehozása után nem tilthatja le a rendelkezésre állási zónákat.
   • Prémium szintű gyorsítótár esetén konfigurálja a nem TLS-port, a fürtözés, a felügyelt identitás és az adatmegőrzés beállításait.

   Fontos

   Az optimális biztonság érdekében azt javasoljuk, hogy a Microsoft Entra ID-t felügyelt identitásokkal használva engedélyezze a kéréseket a gyorsítótáron, ha lehetséges. A Microsoft Entra-azonosító és a felügyelt identitások használatával történő engedélyezés kiváló biztonságot és egyszerű használatot biztosít a megosztott hozzáférési kulcsok engedélyezésével szemben. A felügyelt identitások gyorsítótárral való használatáról további információt a Microsoft Entra ID használata gyorsítótár-hitelesítéshez című témakörben talál.

8. (Nem kötelező) Válassza a Címkék lapot, vagy válassza a Tovább: Címkék lehetőséget.

9. (Nem kötelező) A Címkék lapon adja meg a címke nevét és értékét, ha kategorizálni szeretné a gyorsítótár-erőforrást.

10. Válassza az Áttekintés + létrehozás lehetőséget.

    A Felülvizsgálat + létrehozás lapon az Azure automatikusan ellenőrzi a konfigurációt.

11. A zöld érvényesítési üzenet megjelenése után válassza a Létrehozás lehetőséget.

Az új gyorsítótár üzembe helyezése több perc alatt megtörténik. Az üzembe helyezés előrehaladását az Azure Cache for Redis Áttekintés panelen követheti nyomon. Amikor az állapot a Futtatás állapotot jeleníti meg, a gyorsítótár készen áll a használatra.

A Redis Cache üzembe helyezése a Kubernetesben

A saját üzemeltetésű á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.

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 egy adott egyező régióhoz vagy helyhez használt gyorsítótár felül fogja bírálni.

  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 fog használni, míg a másik két régió az Alapértelmezett gyorsítótár bejegyzést fogja használni.

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 Cache for Redis 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üben válassza a Külső gyorsítótár fület.
3. Válassza a + Hozzáadás gombot.
4. Válassza ki a gyorsítótárat a Gyorsítótárpéldány legördülő listában.
5. Válassza az Alapértelmezett lehetőséget, vagy adja meg a kívánt régiót a Használat legördülő listában.
6. Válassza a Mentés lehetőséget.

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üben válassza a Külső gyorsítótár fület.
3. Válassza a + Hozzáadás gombot.
4. Válassza az Egyéni lehetőséget a Gyorsítótárpéldány legördülő listában.
5. Válassza az Alapértelmezett lehetőséget, vagy adja meg a kívánt régiót a Használat legördülő listában.
6. Adja meg az Azure Cache for Redis (vagy Redis-kompatibilis gyorsítótár) kapcsolati sztring a Kapcsolati sztring 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. Keresse meg az API Management-példányt az Azure Portalon.
2. A bal oldali menüben válassza a Külső gyorsítótár fület.
3. Válassza a + Hozzáadás gombot.
4. Válassza az Egyéni lehetőséget a Gyorsítótárpéldány legördülő listában.
5. Adja meg a kívánt saját üzemeltetésű átjáróhelyet vagy alapértelmezett értéket a Használat legördülő listában.
6. Adja meg a Redis cache-kapcsolati sztring a Kapcsolat sztring mezőjében.
7. 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.

Következő lépések

• További információt a gyorsítótárazási házirendekről az API Management házirend-referencia oktatóanyag Gyorsítótárazási házirendek szakaszában talál.
• Ha kulcs alapján szeretne gyorsítótárazni elemeket szabályzatkifejezések használatával, tekintse meg az Egyéni gyorsítótárazás az Azure API Managementben című témakört.