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.
Para crear una instancia de caché, inicie sesión en Azure Portal y seleccione Crear un recurso.
En la página Introducción, escriba Azure Cache for Redis en el cuadro de búsqueda. Seleccione Crear.
En la página Nueva instancia de Redis Cache, configure las opciones de la 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é. SKU de la caché Despliegue y seleccione una SKU. La SKU determina los parámetros de tamaño, rendimiento y características que están disponibles para la memoria caché. Para más información, consulte la introducción a Azure Redis Cache. Tamaño de la caché Despliegue y seleccione un tamaño de la memoria caché Para más información, consulte la introducción a Azure Redis Cache. Seleccione la pestaña Redes o elija el botón Redes situado en la parte inferior de la página.
En la pestaña Redes, seleccione el método de conectividad.
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.
- 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 lograr una seguridad óptima, Microsoft recomienda usar Microsoft Entra ID con identidades administradas para autorizar solicitudes en la memoria caché siempre que sea posible. La autorización con Microsoft Entra ID e identidades administradas proporciona más seguridad y facilidad de uso que la autorización con claves compartidas. Para más información acerca del uso de identidades administradas con las memorias caché, consulte Uso de Microsoft Entra ID para la autenticación de la memoria caché.
Seleccione el botón Siguiente: Opciones avanzadas o elija el botón Siguiente: Etiquetas situado en la parte inferior de la página.
Opcionalmente, en la pestaña Etiquetas, escriba el nombre y el valor si desea clasificar el recurso.
Seleccione Revisar + crear. Al Revisar y crear, Azure valida su configuración.
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.
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
- Vaya a la instancia de API Management en Azure Portal.
- Seleccione la pestaña Caché externa en el menú de la izquierda.
- Seleccione el botón + Agregar.
- Seleccione la memoria caché en el campo de lista desplegable Instancia de caché.
- Seleccione Predeterminada o especifique la región deseada en el campo de lista desplegable Usar desde.
- Seleccione Guardar.
Adición de una memoria caché de Redis hospedada fuera de la suscripción de Azure actual o Azure en general
- Vaya a la instancia de API Management en Azure Portal.
- Seleccione la pestaña Caché externa en el menú de la izquierda.
- Seleccione el botón + Agregar.
- Seleccione Personalizada en el campo de lista desplegable Instancia de caché.
- Seleccione Predeterminada o especifique la región deseada en el campo de lista desplegable Usar desde.
- Proporcione su cadena de conexión de Azure Cache for Redis (o caché compatible con Redis) en el campo Cadena de conexión.
- Seleccione Guardar.
Incorporación de Redis Cache a una puerta de enlace autohospedada
- Vaya a la instancia de API Management en Azure Portal.
- Seleccione la pestaña Caché externa en el menú de la izquierda.
- Seleccione el botón + Agregar.
- Seleccione Personalizada en el campo de lista desplegable Instancia de caché.
- Especifique la ubicación de puerta de enlace autohospedada que desee o Predeterminada en el campo desplegable Usar desde.
- Proporcione la cadena de conexión de Redis Cache en el campo Cadena de conexión.
- 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.