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

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.

Nota:

Actualmente, esta característica no está disponible en las áreas de trabajo.

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 API Management
• Comprender el almacenamiento en memoria caché en Azure API Management

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 caché, inicie sesión en Azure Portal. En el menú de Azure Portal, seleccione Crear un recurso.

   

2. En el panel Comenzar, escriba Azure Cache for Redis en la barra de búsqueda. En los resultados de la búsqueda, encuentre Azure Cache for Redis y a continuación, seleccioneCrear.

   

3. En el panel Nueva Redis Cache, en la pestaña Aspectos básicos, configure las siguientes opciones para la memoria caché:

   Configuración	Acción	Descripción
   Suscripción	Seleccione la suscripción a Azure.	La suscripción que se va a usar para crear la nueva instancia de Azure Cache for Redis.
   Grupo de recursos	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 va a crear la memoria 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 caché debe ser una cadena de 1 a 63 caracteres que contenga solo números, letras y 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	Seleccione una ubicación.	Una región de Azure cercana a otros servicios que usan la memoria caché.
   SKU de la caché	Seleccione una SKU.	La SKU determina los parámetros de tamaño, rendimiento y característica que están disponibles para la memoria caché. Para más información, consulte la introducción a Azure Cache for Redis.
   Tamaño de la caché	Seleccione un tamaño de caché.	Para más información, consulte la introducción a Azure Cache for Redis.

4. Seleccione la pestaña Redes o Siguiente: Redes.

5. En la pestaña Redes, seleccione un método de conectividad que se usará para la memoria caché.

6. Seleccione la pestaña Opciones avanzadas o Siguiente: Opciones avanzadas.

7. En el panel Opciones Avanzadas, compruebe o seleccione un método de autenticación en función de la siguiente información:

   

   • De manera predeterminada, para una nueva caché Básica, Estándar o Premium, la Autenticación de Microsoft Entra está habilitada y la Autenticación de claves de acceso está deshabilitada.
   • Para las cachés Básica o Estándar, puede elegir la selección de un puerto que no sea TLS.
   • Para las cachés Estándar y Premium, puede habilitar las zonas de disponibilidad. No puede deshabilitar las zonas de disponibilidad una vez creada la caché.
   • 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.

   Importante

   Para obtener una seguridad óptima, se recomienda usar Microsoft Entra ID con identidades administradas para autorizar solicitudes en la memoria caché, si es posible. La autorización mediante Microsoft Entra ID y las identidades administradas proporciona una seguridad y facilidad de uso superiores a la autorización mediante claves de acceso compartidas. Para más información sobre el uso de identidades administradas con la memoria caché, consulte Uso de Microsoft Entra ID para la autenticación de caché.

8. (Opcional) Seleccione la pestaña Etiquetas o Siguiente: Etiquetas.

9. (Opcional) En la pestaña Etiquetas, escriba un nombre de etiqueta y un valor si desea clasificar el recurso de caché.

10. Seleccione el botón Revisar y crear.

    En la pestaña Revisar y crear, Azure valida automáticamente la configuración.

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

Se produce una nueva implementación de caché durante varios minutos. Puede supervisar el progreso de la implementación en el panel Información general de Azure Cache for Redis. Cuando Estado muestra En ejecución, la memoria caché está lista para usarse.

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.

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

• Para más información sobre las directivas de almacenamiento en caché, consulte Caching policies (Directivas de almacenamiento en caché) en API Management policy reference (Referencia de la directiva de Administración de API).
• Para almacenar en caché elementos por clave mediante expresiones de directivas, consulte Almacenamiento en caché personalizado en Azure API Management.