Condividi tramite

Usare una cache esterna compatibile con Redis in Gestione API di Azure

  • Articolo

SI APPLICA A: Tutti i livelli di Gestione API

Oltre a usare la cache predefinita, Azure Gestione API consente di memorizzare nella cache le risposte in una cache esterna compatibile con Redis, ad esempio cache di Azure per Redis o Redis gestita di Azure.

L'uso di una cache esterna consente di superare alcune limitazioni della cache predefinita:

  • Evitare che la cache venga periodicamente cancellata durante gli aggiornamenti di Gestione API
  • Avere maggiore controllo sulla configurazione della cache
  • Memorizzare nella cache più dati di quelli consentiti dal livello Gestione API
  • Usare la memorizzazione nella cache con il livello A consumo di Gestione API
  • Abilitare la memorizzazione nella cache nel gateway self-hosted di Gestione API

Per informazioni più dettagliate sulla memorizzazione nella cache, vedere Criteri di memorizzazione nella cache in Gestione API e Memorizzazione nella cache personalizzata in Gestione API di Azure.

Nota

Attualmente, questa funzionalità non è disponibile nelle aree di lavoro.

Contenuto dell'esercitazione:

  • Aggiungere una cache esterna in Gestione API

Prerequisiti

Per completare questa esercitazione, è necessario:

Cache Redis per Kubernetes

Per un gateway Gestione API self-hosted, la memorizzazione nella cache richiede una cache esterna. Affinché la memorizzazione nella cache sia efficace, un gateway self-hosted e la cache su cui si basa devono trovarsi l'uno vicino all'altra per ridurre al minimo le latenze di ricerca e archiviazione. La distribuzione di una cache Redis nello stesso cluster Kubernetes o in un cluster separato nelle vicinanze sono le opzioni migliori. Informazioni su come distribuire la cache Redis in un cluster Kubernetes.

Aggiungere una cache esterna

Seguire questa procedura per aggiungere una cache esterna compatibile con Redis in Gestione API di Azure. È possibile limitare la cache a un gateway specifico nell'istanza di Gestione API.

Screenshot che mostra come aggiungere una cache di Azure per Redis esterna in Gestione API di Azure.

Usare dall'impostazione

L'impostazione Usa da nella configurazione specifica il percorso dell'istanza di Gestione API che userà la cache. Selezionare una delle opzioni seguenti:

  • L’area di Azure in cui è ospitata l'istanza di Gestione API (o una delle posizioni configurate, se si dispone di una distribuzione in più aree)

  • Posizione del gateway self-hosted

  • Impostazione predefinita, per configurare la cache come predefinita per tutti i percorsi del gateway nell'istanza di Gestione API

    Una cache usata per Default viene sottoposta a override da una cache usata per un'area o una località di corrispondenza specifica.

    Si consideri ad esempio un'istanza di Gestione API ospitata nelle aree Stati Uniti orientali, Asia sud-orientale ed Europa occidentale. Sono configurate due cache, una per Default e una per Asia sud-orientale. In questo esempio, Gestione API in Asia sud-orientale usa la propria cache, mentre le altre due aree usano la voce della cache predefinita.

Nota

È possibile configurare la stessa cache esterna per più di un'istanza di Gestione API. Le istanze di Gestione API possono trovarsi nella stessa area o in aree diverse. Quando si condivide la cache per più di un'istanza, è necessario selezionare Predefinito nell'impostazione Usa da.

Aggiungere una cache di Azure per Redis o un'istanza di Redis gestita di Azure dalla stessa sottoscrizione

  1. Passare all'istanza di Gestione API nel portale di Azure.
  2. Nel menu a sinistra, in Distribuzione e infrastruttura selezionare Cache esterna.
  3. Seleziona + Aggiungi.
  4. Nell'elenco a discesa Istanza della cache selezionare la cache.
  5. Nell'elenco a discesa Usa da selezionare Predefinito o specificare l'area desiderata. La stringa di connessione viene popolata automaticamente.
  6. Seleziona Salva.

Aggiungere una cache compatibile con Redis ospitata all'esterno della sottoscrizione di Azure corrente o di Azure in generale

  1. Passare all'istanza di Gestione API nel portale di Azure.
  2. Nel menu a sinistra, in Distribuzione e infrastruttura selezionare Cache esterna.
  3. Seleziona + Aggiungi.
  4. Nell'elenco a discesa Istanza della cache selezionare Personalizzato.
  5. Nell'elenco a discesa Usa da selezionare Predefinito o specificare l'area desiderata.
  6. Immettere i cache di Azure per Redis, Azure Managed Redis o redis-compatible cache stringa di connessione nel campo Stringa di connessione.
  7. Seleziona Salva.

Aggiungere una cache Redis a un gateway self-hosted

  1. Nel menu a sinistra, in Distribuzione e infrastruttura selezionare Cache esterna.
  2. Seleziona + Aggiungi.
  3. Nell'elenco a discesa Istanza della cache selezionare Personalizzato.
  4. Nell'elenco a discesa Usa da selezionare Predefinito o specificare l'area desiderata.
  5. Immettere il stringa di connessione cache Redis nel campo Stringa di connessione.
  6. Seleziona Salva.

Usare la cache esterna

Dopo aver aggiunto una cache compatibile con Redis, configurare i criteri di memorizzazione nella cache per abilitare la memorizzazione nella cache delle risposte o la memorizzazione nella cache esterna dei valori in base alla chiave.

Per un esempio dettagliato, vedere Aggiungere la memorizzazione nella cache per migliorare le prestazioni in Gestione API di Azure.

Contenuto correlato