Använda en extern Redis-kompatibel cache i Azure API Management

  • Artikel

GÄLLER FÖR: Alla API Management-nivåer

Förutom att använda den inbyggda cachen tillåter Azure API Management cachelagring av svar i en extern Redis-kompatibel cache, till exempel Azure Cache for Redis.

Med hjälp av en extern cache kan du övervinna några begränsningar i den inbyggda cachen:

  • Undvika att ditt cacheminne rensas med jämna mellanrum API Management-uppdateringar
  • Få mer kontroll över din cache-konfiguration
  • Cachelagrade mer data än vad api Management-nivån tillåter
  • Använda cachelagring med förbrukningsnivån för API Management
  • Aktivera cachelagring i den lokala API Management-gatewayen

Mer detaljerad information om cachelagring finns i Principer för cachelagring för API Management och Anpassad cachelagring i Azure API Management.

Ta din egen cache till APIM

Detta får du får lära dig:

  • Lägga till en extern cache i API Management

Förutsättningar

För att slutföra den här kursen behöver du:

Skapa Azure Cache for Redis

Det här avsnittet beskriver hur du skapar en Azure Cache for Redis i Azure. Om du redan har en Azure Cache for Redis eller en annan Redis-kompatibel cache i eller utanför Azure kan du gå vidare till nästa avsnitt.

  1. Om du vill skapa en cache loggar du in på Azure-portalen och väljer Skapa en resurs.

    Skapa en resurs är markerad i det vänstra navigeringsfönstret.

  2. På sidan Nytt väljer du Databaser och sedan Azure Cache for Redis.

    På Ny markeras databaser och Azure Cache for Redis markeras.

  3. På sidan Ny Redis Cache konfigurerar du inställningarna för din nya cache.

    Inställning Välj ett värde beskrivning
    Abonnemang Listrutan och välj din prenumeration. Prenumerationen som den nya Azure Cache for Redis-instansen ska skapas under.
    Resursgrupp Listrutan och välj en resursgrupp eller välj Skapa ny och ange ett nytt resursgruppsnamn. Namn på den resursgrupp där cacheminnet och andra resurser ska skapas. Genom att placera alla dina appresurser i en resursgrupp kan du enkelt hantera eller ta bort dem tillsammans.
    DNS-namn Ange ett unikt namn. Cachenamnet måste vara en sträng mellan 1 och 63 tecken som endast innehåller siffror, bokstäver eller bindestreck. Namnet måste börja och sluta med ett tal eller en bokstav och får inte innehålla bindestreck i följd. Värdnamnet för cacheinstansen är <DNS-namnet.redis.cache.windows.net>.
    Plats Listrutan och välj en plats. Välj en region nära andra tjänster som använder din cache.
    Cachetyp Listrutan och välj en nivå. Nivån avgör storlek, prestanda och funktioner som är tillgängliga för cacheminnet. Mer information finns i Översikt över Azure Cache for Redis.

  4. Välj fliken Nätverk eller välj knappen Nätverk längst ned på sidan.

  5. På fliken Nätverk väljer du din anslutningsmetod.

  6. Välj fliken Nästa: Avancerat eller välj knappen Nästa: Avancerat längst ned på sidan för att se fliken Avancerat .

    Skärmbild som visar fliken Avancerat i arbetsfönstret och det tillgängliga alternativet att välja.

    • För Basic- eller Standard-cacheminnen växlar du markeringen för en icke-TLS-port. Du kan också välja om du vill aktivera Microsoft Entra-autentisering.
    • För en Premium-cache konfigurerar du inställningarna för icke-TLS-port, klustring, hanterad identitet och datapersistence. Du kan också välja om du vill aktivera Microsoft Entra-autentisering.

  7. Välj fliken Nästa: Taggar eller välj knappen Nästa: Taggar längst ned på sidan.

  8. Du kan också ange namn och värde på fliken Taggar om du vill kategorisera resursen.

  9. Välj Granska + skapa. Du kommer till fliken Granska + skapa där Azure verifierar din konfiguration.

  10. När det gröna verifieringsmeddelandet har skickats väljer du Skapa.

Det tar en stund innan en cache skapas. Du kan övervaka förloppet på översiktssidan för Azure Cache for Redis. När Status visas som Körs är cachen redo att användas.

Distribuera Redis-cache till Kubernetes

För en gateway med egen värd kräver cachelagring en extern cache. För att cachelagring ska vara effektiv måste en gateway med egen värd och cachen som den förlitar sig på finnas nära varandra för att minimera svarstiderna för sökning och lagring. Att distribuera en Redis-cache till samma Kubernetes-kluster eller i ett separat kluster i närheten är de bästa alternativen. Lär dig hur du distribuerar Redis Cache till ett Kubernetes-kluster.

Lägga till en extern cache

Följ stegen nedan för att lägga till en extern Redis-kompatibel cache i Azure API Management. Du kan begränsa cachen till en specifik gateway i DIN API Management-instans.

Skärmbild som visar hur du lägger till en extern Azure Cache for Redis i Azure API Management.

Använd från inställning

Inställningen Använd från i konfigurationen anger platsen för din API Management-instans som ska använda cachen. Välj något av följande:

  • Den Azure-region där API Management-instansen finns (eller någon av de konfigurerade platserna, om du har en distribution i flera regioner )

  • En gatewayplats med egen värd

  • Standardinställningen är att konfigurera cachen som standard för alla gatewayplatser i API Management-instansen

    En cache som används för Standard kommer att åsidosättas av en cache som används för en specifik matchande region eller plats.

    Tänk dig till exempel en API Management-instans som finns i regionerna USA, östra, Sydostasien och Europa, västra. Det finns två konfigurerade cacheminnen, en för Standard och en för Sydostasien. I det här exemplet använder API Management i Sydostasien sin egen cache, medan de andra två regionerna använder posten Standardcache .

Kommentar

Du kan konfigurera samma externa cache för mer än en API Management-instans. API Management-instanserna kan finnas i samma eller olika regioner. När du delar cacheminnet för mer än en instans måste du välja Standard i inställningen Använd från .

Lägga till en Azure Cache for Redis från samma prenumeration

  1. Bläddra till API Management-instansen i Azure-portalen.
  2. Välj fliken Extern cache på menyn till vänster.
  3. Välj knappen + Lägg till.
  4. Välj din cache i det nedrullningsbara fältet Cacheinstans.
  5. Välj Standard eller ange önskad region i listrutan Använd från.
  6. Välj Spara.

Lägg till en Redis-kompatibel cache som finns utanför den aktuella Azure-prenumerationen eller Azure i allmänhet

  1. Bläddra till API Management-instansen i Azure-portalen.
  2. Välj fliken Extern cache på menyn till vänster.
  3. Välj knappen + Lägg till.
  4. Välj Anpassad i det nedrullningsbara fältet Cacheinstans.
  5. Välj Standard eller ange önskad region i listrutan Använd från.
  6. Ange din Azure Cache for Redis (eller Redis-kompatibel cache) anslutningssträng i fältet Anslut ionssträng.
  7. Välj Spara.

Lägga till en Redis-cache i en gateway med egen värd

  1. Bläddra till API Management-instansen i Azure-portalen.
  2. Välj fliken Extern cache på menyn till vänster.
  3. Välj knappen + Lägg till.
  4. Välj Anpassad i det nedrullningsbara fältet Cacheinstans.
  5. Ange önskad plats för lokalt installerad gateway eller Standard i listrutan Använd från .
  6. Ange din anslutningssträng för Redis-cache i fältet Anslutningssträng.
  7. Välj Spara.

Använda den externa cachen

När du har lagt till en Redis-kompatibel cache konfigurerar du cachelagringsprinciper för att aktivera cachelagring av svar eller cachelagring av värden efter nyckel i den externa cachen.

Ett detaljerat exempel finns i Lägga till cachelagring för att förbättra prestanda i Azure API Management.

Nästa steg