Share via

Een externe Redis-compatibele cache gebruiken in Azure API Management

  • Artikel

VAN TOEPASSING OP: Alle API Management-lagen

Naast het gebruik van de ingebouwde cache kunt u met Azure API Management antwoorden opslaan in een externe redis-compatibele cache, zoals Azure Cache voor Redis.

Met behulp van een externe cache kunt u enkele beperkingen van de ingebouwde cache overwinnen:

  • Als u wilt vermijden dat uw cache periodiek wordt gewist tijdens het bijwerken van API Management
  • Als u meer controle wilt over de configuratie van uw cache
  • Meer gegevens opslaan in de cache dan uw API Management-laag toestaat
  • Als u opslag in de cache wilt gebruiken met de laag Verbruik van API Management
  • Caching inschakelen in de zelf-hostende gateway van API Management

Zie de beleidsregels voor API Management-caching en Aangepaste caching in Azure API Management voor meer informatie over caching.

Uw eigen cache gebruiken in API Management

Wat u leert:

  • Een externe cache toevoegen in API Management

Vereisten

Voor het voltooien van deze zelfstudie hebt u het volgende nodig:

Een Azure-cache voor Redis maken

In dit gedeelte wordt uitgelegd hoe u een Azure-cache voor Redis maakt in Azure. Als u al een Azure Cache voor Redis of een andere redis-compatibele cache binnen of buiten Azure hebt, kunt u doorgaan naar de volgende sectie.

  1. Als u een cache wilt maken, meldt u zich aan bij de Azure-portal en selecteert u Een resource maken.

    Een resource maken is gemarkeerd in het linkernavigatiedeelvenster.

  2. Typ op de pagina Aan de slag Azure Cache voor Redis in het zoekvak. Ten slotte selecteert u Maken.

    Schermopname van Azure Marketplace met Azure Cache voor Redis in het zoekvak en maken is gemarkeerd met een rood vak.

  3. Configureer op de pagina Nieuwe Redis Cache de instellingen voor uw cache.

    Instelling Een waarde kiezen Beschrijving
    Abonnement Open de vervolgkeuzelijst en selecteer uw abonnement. Het abonnement waarmee dit nieuwe Azure Cache voor Redis-exemplaar wordt gemaakt.
    Resourcegroep Open de vervolgkeuzelijst en selecteer een resourcegroep of kies Nieuwe maken en geef een naam voor de nieuwe resourcegroep op. Naam voor de resourcegroep waarin de cache en andere resources moeten worden gemaakt. Door al uw app-resources in één resourcegroep te plaatsen, kunt u ze eenvoudig beheren of verwijderen.
    DNS-naam Voer een unieke naam in. De cachenaam moet een tekenreeks tussen 1 en 63 tekens zijn die alleen cijfers, letters of afbreekstreepjes bevatten. De naam moet beginnen en eindigen met een cijfer of letter en mag geen opeenvolgende afbreekstreepjes bevatten. De hostnaam van uw cache-exemplaar is <DNS-naam.redis.cache.windows.net>.
    Location Open de vervolgkeuzelijst en selecteer een locatie. Selecteer een regio in de buurt van andere services die gebruikmaken van uw cache.
    Cache-SKU Vervolgkeuzelijst en selecteer een SKU. De SKU bepaalt de grootte, prestaties en onderdelenparameters die beschikbaar zijn voor de cache. Zie het Azure Cache voor Redis-overzicht voor meer informatie.
    Cachegrootte Vervolgkeuzelijst en selecteer een grootte van uw cache Zie het Azure Cache voor Redis-overzicht voor meer informatie.

  4. Selecteer het tabblad Netwerken of selecteer de knop Netwerken onderaan de pagina.

  5. Selecteer uw verbindingsmethode op het tabblad Netwerk.

  6. Selecteer het tabblad Volgende: Geavanceerd of selecteer de knop Volgende: Geavanceerd onder aan de pagina om het tabblad Geavanceerd weer te geven.

    Schermopname van het tabblad Geavanceerd in het werkvenster en de beschikbare optie om te selecteren.

    • Voor Basic- of Standard-caches schakelt u de selectie voor een niet-TLS-poort in. U kunt ook selecteren of u Microsoft Entra-verificatie wilt inschakelen.
    • Voor een Premium-cache configureert u de instellingen voor niet-TLS-poort, clustering, beheerde identiteit en gegevenspersistentie. U kunt ook selecteren of u Microsoft Entra-verificatie wilt inschakelen.

  7. Selecteer het tabblad Volgende: Tags of selecteer de knop Volgende: Tags onderaan de pagina.

  8. Voer desgewenst in het tabblad Tags de naam en waarde in om de resource te categoriseren.

  9. Selecteer Controleren + maken. Het tabblad Beoordelen + maken wordt weergegeven, waar uw configuratie wordt gevalideerd in Azure.

  10. Selecteer Maken nadat het groene bericht Validatie geslaagd verschijnt.

Het duurt even voordat een cache is gemaakt. U kunt de voortgang bekijken op de overzichtspagina van Azure Cache voor Redis. Als u bij StatusWordt uitgevoerd ziet staan, kunt u de cache gebruiken.

Redis-cache implementeren in Kubernetes

Voor een zelf-hostende gateway is voor caching een externe cache vereist. Om caching effectief te maken, moet een zelf-hostende gateway en de cache waarop deze is gebaseerd zich dicht bij elkaar bevinden om opzoek- en opslaglatenties te minimaliseren. Het implementeren van een Redis-cache in hetzelfde Kubernetes-cluster of in een afzonderlijk cluster in de buurt zijn de beste opties. Meer informatie over het implementeren van Redis-cache in een Kubernetes-cluster.

Een externe cache toevoegen

Volg de onderstaande stappen om een externe redis-compatibele cache toe te voegen in Azure API Management. U kunt de cache beperken tot een specifieke gateway in uw API Management-exemplaar.

Schermopname van het toevoegen van een externe Azure Cache voor Redis in Azure API Management.

Gebruiken vanuit instelling

Met de instelling Gebruiken in de configuratie geeft u de locatie op van uw API Management-exemplaar dat de cache gebruikt. Selecteer een van de volgende opties:

  • De Azure-regio waar het API Management-exemplaar wordt gehost (of een van de geconfigureerde locaties, als u een implementatie met meerdere regio's hebt)

  • Een zelf-hostende gatewaylocatie

  • Standaard: als u de cache wilt configureren als de standaardinstelling voor alle gatewaylocaties in het API Management-exemplaar

    Een cache die wordt gebruikt voor Standaard , wordt overschreven door een cache die wordt gebruikt voor een specifieke overeenkomende regio of locatie.

    Denk bijvoorbeeld aan een API Management-exemplaar dat wordt gehost in de regio's VS - oost, Azië - zuidoost en Europa - west. Er zijn twee caches geconfigureerd, één voor Standaard en één voor Azië - zuidoost. In dit voorbeeld gebruikt API Management in Zuidoost-Azië een eigen cache, terwijl in de andere twee regio's de standaardcachevermelding wordt gebruikt.

Notitie

U kunt dezelfde externe cache configureren voor meer dan één API Management-exemplaar. De API Management-exemplaren kunnen zich in dezelfde of verschillende regio's bevinden. Wanneer u de cache voor meer dan één exemplaar deelt, moet u Standaard selecteren in de instelling Gebruiken.

Een Azure-cache voor Redis toevoegen uit hetzelfde abonnement

  1. Blader naar uw API Management-exemplaar in de Azure-portal.
  2. Selecteer het tabblad Externe cache in het menu aan de linkerkant.
  3. Selecteer de knop + Toevoegen .
  4. Selecteer uw cache in de vervolgkeuzelijst Cache-instantie.
  5. Selecteer Standaard of geef de gewenste regio op in het vervolgkeuzeveld Gebruiken .
  6. Selecteer Opslaan.

Een redis-compatibele cache toevoegen die buiten het huidige Azure-abonnement of Azure in het algemeen wordt gehost

  1. Blader naar uw API Management-exemplaar in de Azure-portal.
  2. Selecteer het tabblad Externe cache in het menu aan de linkerkant.
  3. Selecteer de knop + Toevoegen .
  4. Selecteer Aangepast in de vervolgkeuzelijst Cache-instantie.
  5. Selecteer Standaard of geef de gewenste regio op in het vervolgkeuzeveld Gebruiken .
  6. Geef uw Azure Cache voor Redis (of redis-compatibele cache) verbindingsreeks op in het Verbinding maken iontekenreeksveld.
  7. Selecteer Opslaan.

Een Redis-cache toevoegen aan een zelf-hostende gateway

  1. Blader naar uw API Management-exemplaar in de Azure-portal.
  2. Selecteer het tabblad Externe cache in het menu aan de linkerkant.
  3. Selecteer de knop + Toevoegen .
  4. Selecteer Aangepast in de vervolgkeuzelijst Cache-instantie.
  5. Geef de gewenste zelf-hostende gatewaylocatie op of standaard in het vervolgkeuzeveld Gebruiken .
  6. Geef de verbindingsreeks van uw Redis-cache op in het veld Verbindingsreeks.
  7. Selecteer Opslaan.

De externe cache gebruiken

Nadat u een redis-compatibele cache hebt toegevoegd, configureert u cachebeleid voor het inschakelen van reactiecaching of het opslaan van waarden per sleutel in de externe cache.

Zie Caching toevoegen voor een gedetailleerd voorbeeld om de prestaties in Azure API Management te verbeteren.

Volgende stappen