Partilhar via

Usar um cache externo compatível com Redis no Gerenciamento de API do Azure

  • Artigo

APLICA-SE A: Todas as camadas de gerenciamento de API

Além de utilizar o cache interno, o Gerenciamento de API do Azure permite armazenar respostas em cache em um cache externo compatível com Redis, como o Cache Redis do Azure ou o Azure Managed Redis.

O uso de um cache externo permite que você supere algumas limitações do cache interno:

  • Evite que seu cache seja limpo periodicamente durante as atualizações do Gerenciamento de API
  • Tenha mais controle sobre a configuração do cache
  • Armazene em cache mais dados do que a camada de Gerenciamento de API permite
  • Usar cache com a camada de consumo do Gerenciamento de API
  • Habilitar o cache no gateway auto-hospedado do Gerenciamento de API

Para obter informações mais detalhadas sobre a colocação em cache, veja Colocação em cache das políticas de Gestão de API e Colocação em cache personalizada na Gestão de API do Azure.

Nota

Atualmente, esse recurso não está disponível em espaços de trabalho.

O que irá aprender:

  • Adicionar um cache externo no Gerenciamento de API

Pré-requisitos

Para concluir este tutorial, precisa de:

  • crie uma instância da Gestão de API do Azure

  • Compreender o cache no Gerenciamento de API do Azure

  • Tenha disponível um Cache do Azure para Redis, Redis Gerenciado do Azure ou outro cache compatível com Redis.

    Importante

    O Gerenciamento de API do Azure usa uma cadeia de conexão Redis para se conectar ao cache. Se você usar o Cache do Azure para Redis ou o Azure Managed Redis, habilite a autenticação de chave de acesso em seu cache para usar uma cadeia de conexão. Atualmente, não é possível usar a autenticação do Microsoft Entra para conectar o Gerenciamento de API do Azure ao Cache do Azure para Redis ou Azure Managed Redis.

Cache Redis para Kubernetes

Para um gateway auto-hospedado de Gerenciamento de API, o cache requer um cache externo. Para que o cache seja eficaz, um gateway auto-hospedado e o cache no qual ele depende devem estar localizados próximos um do outro para minimizar as latências de pesquisa e armazenamento. Implantar um cache Redis no mesmo cluster do Kubernetes ou em um cluster separado nas proximidades são as melhores opções. Saiba como implantar o cache Redis em um cluster Kubernetes.

Adicionar um cache externo

Siga as etapas abaixo para adicionar um cache externo compatível com Redis no Gerenciamento de API do Azure. Você pode limitar o cache a um gateway específico em sua instância de Gerenciamento de API.

Captura de tela que mostra como adicionar um Cache Redis do Azure externo no Gerenciamento de API do Azure.

Utilizar a partir da definição

A configuração Usar de na configuração especifica o local da instância de Gerenciamento de API que usará o cache. Seleccione uma das seguintes opções:

  • A região do Azure onde a instância de Gerenciamento de API está hospedada (ou um dos locais configurados, se você tiver uma implantação de várias regiões )

  • Um local de gateway auto-hospedado

  • Padrão, para configurar o cache como padrão para todos os locais de gateway na instância de Gerenciamento de API

    Um cache usado para Padrão é substituído por um cache usado para uma região ou local correspondente específico.

    Por exemplo, considere uma instância de Gerenciamento de API hospedada nas regiões Leste dos EUA, Sudeste Asiático e Europa Ocidental. Há dois caches configurados, um para Padrão e outro para o Sudeste Asiático. Neste exemplo, o Gerenciamento de API no Sudeste Asiático usa seu próprio cache, enquanto as outras duas regiões usam a entrada de cache padrão .

Nota

Você pode configurar o mesmo cache externo para mais de uma instância de Gerenciamento de API. As instâncias de Gerenciamento de API podem estar na mesma região ou em regiões diferentes. Ao compartilhar o cache para mais de uma instância, você deve selecionar Padrão na configuração Usar de .

Adicionar um Cache do Azure para Redis ou uma instância do Azure Managed Redis a partir da mesma subscrição

  1. Navegue até sua instância de Gerenciamento de API no portal do Azure.
  2. No menu à esquerda, em Implantação + infraestrutura , selecione Cache externo.
  3. Selecione + Adicionar.
  4. Na lista suspensa Instância de cache, selecione seu cache.
  5. Na lista suspensa Usar de, selecione Padrão ou especifique a região desejada. A cadeia de conexão é preenchida automaticamente.
  6. Selecione Guardar.

Adicionar um cache compatível com Redis hospedado fora da assinatura atual do Azure ou do Azure em geral

  1. Navegue até sua instância de Gerenciamento de API no portal do Azure.
  2. No menu à esquerda, em Implantação + infraestrutura , selecione Cache externo.
  3. Selecione + Adicionar.
  4. No menu suspenso Instância de cache, selecione Personalizado.
  5. Na lista suspensa Usar de, selecione Padrão ou especifique a região desejada.
  6. Insira seu Cache do Azure para Redis, Azure Managed Redis ou cadeia de conexão de cache compatível com Redis no campo Cadeia de conexão .
  7. Selecione Guardar.

Adicionar um cache Redis a um gateway auto-hospedado

  1. No menu à esquerda, em Implantação + infraestrutura , selecione Cache externo.
  2. Selecione + Adicionar.
  3. No menu suspenso Instância de cache, selecione Personalizado.
  4. Na lista suspensa Usar de, selecione Padrão ou especifique a região desejada.
  5. Insira a cadeia de conexão do cache Redis no campo Cadeia de conexão .
  6. Selecione Guardar.

Usar o cache externo

Depois de adicionar um cache compatível com Redis, configure as políticas de cache para habilitar o cache de resposta ou o cache de valores por chave no cache externo.

Para obter um exemplo detalhado, consulte Adicionar cache para melhorar o desempenho no Gerenciamento de API do Azure.

Conteúdos relacionados