Delen 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.

Notitie

Deze functie is momenteel niet beschikbaar in werkruimten.

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. Meld u aan bij Azure Portal om een cache te maken. Selecteer een resource maken in het portalmenu.

    Sceenshot met de optie Een resource maken gemarkeerd in het linkernavigatiedeelvenster in Azure Portal.

  2. Voer in het deelvenster Aan de slag Azure Cache voor Redis in de zoekbalk in. Zoek Azure Cache voor Redis in de zoekresultaten en selecteer Vervolgens Maken.

    Schermopname van Azure Marketplace met Azure Cache voor Redis in het zoekvak en de knop Maken is gemarkeerd.

  3. Configureer in het deelvenster Nieuwe Redis Cache op het tabblad Basis de volgende instellingen voor uw cache:

    Instelling Actie Beschrijving
    Abonnement Selecteer uw Azure-abonnement. Het abonnement dat moet worden gebruikt om het nieuwe exemplaar van Azure Cache voor Redis te maken.
    Resourcegroep Selecteer een resourcegroep of selecteer Nieuwe maken en voer een nieuwe resourcegroepnaam in. Een naam voor de resourcegroep waarin u uw cache en andere resources wilt maken. 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 van 1 tot 63 tekens zijn die alleen cijfers, letters en afbreekstreepjes bevat. De naam moet beginnen en eindigen met een getal of letter en mag geen opeenvolgende afbreekstreepjes bevatten. De hostnaam van uw cache-exemplaar is\<DNS name>.redis.cache.windows.net.
    Location Selecteer een locatie. Een Azure-regio in de buurt van andere services die gebruikmaken van uw cache.
    Cache-SKU Selecteer een SKU. De SKU bepaalt de grootte, prestaties en functieparameters die beschikbaar zijn voor de cache. Zie Azure Cache voor Redis overzicht voor meer informatie.
    Cachegrootte Selecteer een cachegrootte. Zie Azure Cache voor Redis overzicht voor meer informatie.

  4. Selecteer het tabblad Netwerken of selecteer Volgende: Netwerken.

  5. Selecteer op het tabblad Netwerken een connectiviteitsmethode die u voor de cache wilt gebruiken.

  6. Selecteer het tabblad Geavanceerd of selecteer Volgende: Geavanceerd.

  7. Controleer of selecteer in het deelvenster Geavanceerd een verificatiemethode op basis van de volgende informatie:

    Schermopname van het deelvenster Geavanceerd en de beschikbare opties die u kunt selecteren.

    • Microsoft Entra Authentication is standaard ingeschakeld voor een nieuwe Basic-, Standard- of Premium-cache en toegangssleutelsverificatie is uitgeschakeld.
    • Voor Basic- of Standard-caches kunt u de selectie voor een niet-TLS-poort kiezen.
    • Voor Standard- en Premium-caches kunt u ervoor kiezen om beschikbaarheidszones in te schakelen. U kunt beschikbaarheidszones niet uitschakelen nadat de cache is gemaakt.
    • Voor een Premium-cache configureert u de instellingen voor niet-TLS-poort, clustering, beheerde identiteit en gegevenspersistentie.

    Belangrijk

    Voor optimale beveiliging wordt u aangeraden Microsoft Entra ID met beheerde identiteiten te gebruiken om aanvragen tegen uw cache te autoriseren, indien mogelijk. Autorisatie met behulp van Microsoft Entra ID en beheerde identiteiten biedt superieure beveiliging en gebruiksgemak ten opzichte van autorisatie van gedeelde toegangssleutels. Zie Microsoft Entra ID gebruiken voor cacheverificatie voor meer informatie over het gebruik van beheerde identiteiten met uw cache.

  8. (Optioneel) Selecteer het tabblad Tags of selecteer Volgende: Tags.

  9. (Optioneel) Voer op het tabblad Tags een tagnaam en -waarde in als u de cacheresource wilt categoriseren.

  10. Selecteer de knop Controleren en maken.

    Op het tabblad Controleren en maken valideert Azure uw configuratie automatisch.

  11. Nadat het groene bericht Validatie is geslaagd , selecteert u Maken.

Een nieuwe cache-implementatie vindt meer dan enkele minuten plaats. U kunt de voortgang van de implementatie controleren in het deelvenster Azure Cache voor Redis Overzicht. Wanneer de status Wordt uitgevoerd, is de cache gereed voor gebruik.

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 veld Verbindingsreeks.
  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