Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este artículo se describe cómo usar Azure Managed Redis o Azure Cache for Redis con Azure Functions para crear arquitecturas optimizadas sin servidor y controladas por eventos.
Azure Functions proporciona un modelo de programación controlado por eventos en el que los desencadenadores y enlaces son características clave. Con Azure Functions, puede crear fácilmente aplicaciones sin servidor controladas por eventos. Azure servicios de Redis (Azure Managed Redis y Azure Cache for Redis) proporcionan un conjunto de bloques de creación y procedimientos recomendados para crear aplicaciones distribuidas, incluidos microservicios, administración de estado, mensajería pub/sub, etc.
Azure Redis se puede usar como desencadenador para Azure Functions, lo que le permite iniciar un flujo de trabajo sin servidor. Esta funcionalidad puede ser muy útil en arquitecturas de datos como memorias caché de escritura subyacente o cualquier arquitectura basada en eventos.
Puede integrar Azure Redis y Azure Functions para crear funciones que reaccionen a eventos de Azure Redis o sistemas externos.
| Action | Dirección |
|---|---|
| Desencadenador en mensajes secundarios de Publicación de Redis | Desencadenador |
| Desencadenador en listas de Redis | Desencadenador |
| Desencadenador en secuencias de Redis | Desencadenador |
| Leer un valor almacenado en caché | Entrada |
| Escritura de valores en la memoria caché | Resultados |
Ámbito de disponibilidad para desencadenadores y enlaces de funciones
| Nivel | Azure Cache for Redis (Básico, Estándar, Premium, Enterprise, Enterprise Flash) | Azure Managed Redis (Optimizado para memoria, Básico, Optimizado para proceso, Optimizado para Flash) |
|---|---|---|
| Pub/Sub | Sí | Sí |
| Listas | Sí | Sí |
| Secuencias | Sí | Sí |
| Enlaces | Sí | Sí |
Importante
Actualmente, los desencadenadores de Redis solo se admiten para las funciones que se ejecutan en un plan Elastic Premium o en un plan de App Service dedicado.
Instalación de la extensión
- Modelo de trabajo aislado
- Modelo de proceso
Las funciones se ejecutan en un proceso de trabajo de C# aislado. Para obtener más información, consulte Guide para ejecutar Azure Functions de C# en un proceso de trabajo aislado.
Agregue la extensión al proyecto instalando este paquete NuGet.
dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Redis
Instalación del conjunto
Para poder usar esta extensión de enlace en la aplicación, asegúrese de que el archivo host.json en la raíz del proyecto contiene esta referencia:
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle",
"version": "[4.0.0, 5.0.0)"
}
}
En este ejemplo, el valor de indica al host de Functions que use una versión de agrupación que sea al menos pero menor que , que incluye todas las versiones potenciales de 4.x. Esta notación mantiene eficazmente la aplicación en la versión secundaria más reciente disponible del paquete de extensiones v4.x.
Cuando sea posible, debe usar la versión principal del paquete de extensiones más reciente y permitir que el tiempo de ejecución mantenga automáticamente la versión secundaria más reciente. Puede ver el contenido de la agrupación más reciente en la página de versión extension bundles. Para obtener más información, consulte Azure Functions paquetes de extensiones.
Actualizar paquetes
Agregue el paquete
<dependency>
<groupId>com.microsoft.azure.functions</groupId>
<artifactId>azure-functions-java-library-redis</artifactId>
<version>1.0.0</version>
</dependency>
Redis cadena de conexión
Azure desencadenadores y enlaces de Redis tienen una propiedad necesaria que indica la configuración de la aplicación o el nombre de colección que contiene información de conexión de caché. El desencadenador o enlace de Redis busca una variable de entorno que contenga el cadena de conexión con el nombre pasado al parámetro Connection.
En el desarrollo local, se puede definir mediante el archivo local.settings.json. Cuando se implementa en Azure, se puede usar aplicación.
Al conectarse a una instancia de caché con una función de Azure, puede usar uno de estos tipos de conexiones en las implementaciones:
- Identidad administrada asignada por el usuario
- Identidad administrada asignada por el sistema
- Cadena de conexión
- Entidad de servicio
Una identidad administrada asignada por el usuario debe estar asociada a la aplicación de funciones y esa identidad también debe concederse permisos explícitos en el servicio de caché. Para obtener más información, consulte Use Microsoft Entra ID para la autenticación de caché.
En estos ejemplos se muestra el nombre de clave y el valor de la configuración de la aplicación necesarios para conectarse a cada servicio de caché en función del tipo de autenticación de cliente, suponiendo que la propiedad del enlace esté establecida en .
"Redis__redisHostName": "<cacheName>.<region>.redis.azure.net",
"Redis__principalId": "<principalId>",
"Redis__clientId": "<clientId>"