Uso de una memoria caché compatible con Redis externa en Azure API Management

  • Artículo

SE APLICA A: todos los niveles de API Management

Además de usar la memoria caché integrada, Azure API Management permite almacenar en caché las respuestas en una memoria caché compatible con Redis, por ejemplo, Azure Cache for Redis.

El uso de una caché externa permite superar algunas limitaciones de la caché integrada:

  • Evitar que la memoria caché se borre periódicamente durante las actualizaciones de API Management
  • Tener más control sobre la configuración de la memoria caché
  • Almacenar en memoria caché más datos de los que permite el nivel de API Management
  • Usar el almacenamiento en caché con el nivel de consumo de API Management
  • Habilitar el almacenamiento en caché tal como se explica para las puertas de enlace hospedadas de API Management

Para más información acerca del almacenamiento en caché, consulte Directivas de almacenamiento en caché de API Management y Almacenamiento en caché personalizado en Azure API Management.

Traiga su propia memoria caché a APIM

Temas que se abordarán:

  • Agregar una memoria caché externa en API Management

Prerrequisitos

Para completar este tutorial, necesita:

Creación de una instancia de Azure Redis Cache

En esta sección se explica cómo crear una instancia de Azure Redis Cache en Azure. Si ya tiene una Azure Cache for Redis, u otra caché compatible con Redis dentro o fuera de Azure, puede pasar a la siguiente sección.

  1. Para crear una instancia de caché, inicie sesión en Azure Portal y seleccione Crear un recurso.

    Crear un recurso está resaltado en el panel de navegación izquierdo.

  2. En la página Nuevo, seleccione Base de datos y, a continuación, seleccione Azure Cache for Redis.

    En Nuevo, están resaltados Bases de datos y Azure Cache for Redis.

  3. En la página Nueva instancia de Redis Cache, configure las opciones de la nueva caché.

    Configuración Elegir un valor Descripción
    Suscripción Desplácese hacia abajo y seleccione su suscripción. La suscripción en la que se creará esta nueva instancia de Azure Cache for Redis.
    Grupos de recursos Desplácese hacia abajo y seleccione un grupo de recursos o Crear nuevo y escriba un nombre nuevo para el grupo de recursos. Nombre del grupo de recursos en el que se van a crear la caché y otros recursos. Al colocar todos los recursos de la aplicación en un grupo de recursos, puede administrarlos o eliminarlos fácilmente.
    Nombre DNS Escriba un nombre único. El nombre de la memoria caché debe ser una cadena de entre 1 y 63 caracteres, y solo puede contener números, letras o guiones. El nombre debe comenzar y terminar por un número o una letra y no puede contener guiones consecutivos. El nombre de host de la instancia de caché es <DNS name>.redis.cache.windows.net.
    Ubicación Desplácese hacia abajo y seleccione una ubicación. Selecciona una región cerca de otros servicios que usan la memoria caché.
    Tipo de caché Desplácese hacia abajo y seleccione un nivel. El nivel determina el tamaño, rendimiento y características disponibles para la memoria caché. Para más información, consulte la introducción a Azure Redis Cache.

  4. Seleccione la pestaña Redes o elija el botón Redes situado en la parte inferior de la página.

  5. En la pestaña Redes, seleccione el método de conectividad.

  6. Seleccione la pestaña Siguiente: Avanzadas o el botón Siguiente: Avanzadas en la parte inferior de la página para ver la pestaña Avanzadas.

    Captura de pantalla que muestra la pestaña Opciones avanzadas en el panel de trabajo y la opción que se puede seleccionar.

    • En cachés básicas o estándar, cambie la selección a un puerto que no sea TLS. También puede seleccionar si desea habilitar la Autenticación de Microsoft Entra.
    • En el caso de una caché Premium, configure las opciones para un puerto que no sea TLS, la agrupación en clústeres, la identidad administrada y la persistencia de datos. También puede seleccionar si desea habilitar la Autenticación de Microsoft Entra.

  7. Seleccione el botón Siguiente: Opciones avanzadas o elija el botón Siguiente: Etiquetas situado en la parte inferior de la página.

  8. Opcionalmente, en la pestaña Etiquetas, escriba el nombre y el valor si desea clasificar el recurso.

  9. Seleccione Revisar + crear. Pasará a la pestaña Revisar y crear, donde Azure valida la configuración.

  10. Tras aparecer el mensaje verde Validación superada, seleccione Crear.

Se tarda un tiempo en crear una memoria caché. Puede supervisar el progreso en la página Información general de Azure Cache for Redis. Cuando Estado se muestra como En ejecución, la memoria caché está lista para su uso.

Implementación de Redis Cache en Kubernetes

Para una puerta de enlace autohospedada, el almacenamiento en caché requiere una caché externa. Para que el almacenamiento en caché sea eficaz, las puertas de enlace autohospedadas y la caché en la que se basan, debe estar situadas cerca unas de las otras para minimizar las latencias de búsqueda y almacenamiento. La implementación de una memoria Redis Cache en el mismo clúster de Kubernetes o en un clúster independiente cercano son las mejores opciones. Aprenda a implementar Redis Cache en un clúster de Kubernetes.

Adición de una memoria caché externa

Siga los siguientes pasos para agregar una memoria caché de Redis externa en Azure API Management. Puede limitar la memoria caché a una puerta de enlace específica en la instancia de API Management.

Captura de pantalla en la que se muestra cómo agregar una instancia externa de Azure Cache for Redis en Azure API Management.

Usar desde la configuración

La opción Usar desde de la configuración especifica la ubicación de la instancia de API Management que usará la memoria caché. Seleccione uno de los siguientes:

  • La región de Azure donde se hospeda la instancia de API Management (o una de las ubicaciones configuradas, si tiene una implementación de varias regiones).

  • Una puerta de enlace autohospedada.

  • Valor predeterminado, para configurar la memoria caché como valor predeterminado para todas las ubicaciones de puerta de enlace de la instancia de API Management

    Una memoria caché usada para valor predeterminado se reemplazará por una caché usada para una región o ubicación coincidente específica.

    Por ejemplo, considere una instancia de API Management hospedada en las regiones del Este de EE. UU., Sudeste Asiático y Oeste de Europa. Hay dos cachés configuradas, una para valor predeterminado y otra para el Sudeste Asiático. En este ejemplo, API Management en el Sudeste Asiático usará su propia memoria caché, mientras que las otras dos regiones usarán la entrada de caché predeterminada.

Nota:

Puede configurar la misma caché externa para más de una instancia de API Management. Las instancias de API Management pueden estar en la misma o en diferentes regiones. Al compartir la memoria caché para más de una instancia, debe seleccionar Predeterminado en la opción Usar desde valor.

Incorporación de una instancia de Azure Redis Cache desde la misma suscripción

  1. Vaya a la instancia de API Management en Azure Portal.
  2. Seleccione la pestaña Caché externa en el menú de la izquierda.
  3. Seleccione el botón + Agregar.
  4. Seleccione la memoria caché en el campo de lista desplegable Instancia de caché.
  5. Seleccione Predeterminada o especifique la región deseada en el campo de lista desplegable Usar desde.
  6. Seleccione Guardar.

Adición de una memoria caché de Redis hospedada fuera de la suscripción de Azure actual o Azure en general

  1. Vaya a la instancia de API Management en Azure Portal.
  2. Seleccione la pestaña Caché externa en el menú de la izquierda.
  3. Seleccione el botón + Agregar.
  4. Seleccione Personalizada en el campo de lista desplegable Instancia de caché.
  5. Seleccione Predeterminada o especifique la región deseada en el campo de lista desplegable Usar desde.
  6. Proporcione su cadena de conexión de Azure Cache for Redis (o caché compatible con Redis) en el campo Cadena de conexión.
  7. Seleccione Guardar.

Incorporación de Redis Cache a una puerta de enlace autohospedada

  1. Vaya a la instancia de API Management en Azure Portal.
  2. Seleccione la pestaña Caché externa en el menú de la izquierda.
  3. Seleccione el botón + Agregar.
  4. Seleccione Personalizada en el campo de lista desplegable Instancia de caché.
  5. Especifique la ubicación de puerta de enlace autohospedada que desee o Predeterminada en el campo desplegable Usar desde.
  6. Proporcione la cadena de conexión de Redis Cache en el campo Cadena de conexión.
  7. Seleccione Guardar.

Uso de la memoria caché externa

Después de agregar una caché compatible con Redis, configure las políticas de almacenamiento en caché para habilitar el almacenamiento en caché de las respuestas, o el almacenamiento en caché de los valores por clave, en la caché externa.

Por ejemplo, consulte Incorporación del almacenamiento en caché para mejorar el rendimiento en Azure API Management para conocer los pasos detallados.

Pasos siguientes