Información general sobre Azure Functions para Azure Cache for Redis (versión preliminar)

  • Artículo

En este artículo se describe cómo usar Azure Cache for Redis con Azure Functions para crear arquitecturas sin servidor optimizadas y controladas por eventos.

Azure Functions proporciona un modelo de programación controlado por eventos donde los desencadenadores y enlaces son características clave. Con Azure Functions, puede crear fácilmente aplicaciones sin servidor controladas por eventos. Azure Cache for Redis proporciona un conjunto de bloques de creación y procedimientos recomendados para compilar aplicaciones distribuidas, incluidos microservicios, administración de estado, mensajería pub/sub, etc.

Azure Cache for 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 Cache for Redis y Azure Functions para crear funciones que reaccionan a eventos de Azure Cache for Redis o sistemas externos.

Action Dirección Nivel de compatibilidad
Desencadenador en mensajes secundarios de Publicación de Redis Desencadenador Vista previa
Desencadenador en listas de Redis Desencadenador Vista previa
Desencadenador en secuencias de Redis Desencadenador Vista previa
Leer un valor almacenado en caché Entrada Vista previa
Escritura de valores en la memoria caché Output Vista previa

Ámbito de disponibilidad para desencadenadores y enlaces de funciones

Nivel Básico Estándar, Premium Enterprise o Enterprise Flash
Pub/Sub Sí Sí Sí
Listas Sí Sí Sí
Secuencias Sí Sí Sí
Enlaces Sí 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

Las funciones se ejecutan en un proceso de trabajo de C# aislado. Para más información, consulte Guía para ejecutar C# Azure Functions en un proceso de trabajo aislado.

Para agregar la extensión al proyecto, instale este paquete NuGet.

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Redis --prerelease

Instalación del conjunto

  1. Cree un proyecto de función Java. Puede usar Maven: mvn archetype:generate -DarchetypeGroupId=com.microsoft.azure -DarchetypeArtifactId=azure-functions-archetype -DjavaVersion=8

  2. Agregue el paquete de extensión agregando o reemplazando el siguiente código en el archivo host.json:

    {
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
    "version": "[4.11.*, 5.0.0)"
  }
}

    Advertencia

    Actualmente, la extensión de Redis solo está disponible en una versión preliminar del paquete.

  3. Agregue la biblioteca de Java para enlaces de Redis al archivo pom.xml:

    <dependency>
  <groupId>com.microsoft.azure.functions</groupId>
  <artifactId>azure-functions-java-library-redis</artifactId>
  <version>${azure.functions.java.library.redis.version}</version>
</dependency>

Agregue el paquete de extensión agregando o reemplazando el siguiente código en el archivo host.json:

  {
    "version": "2.0",
    "extensionBundle": {
      "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
      "version": "[4.11.*, 5.0.0)"
  }
}

Advertencia

Actualmente, la extensión de Redis solo está disponible en una versión preliminar del paquete.

Cadena de conexión de Redis

Los desencadenadores y enlaces de Azure Cache for Redis tienen una propiedad requerida para la cadena de conexión de caché. La cadena de conexión se puede encontrar en el menú Claves de acceso en el portal de Azure Cache for Redis. El desencadenador o enlace de Redis busca una variable de entorno que contenga la cadena de conexión con el nombre pasado al parámetro Connection.

En el desarrollo local, Connection se puede definir mediante el archivo local.settings.json. Cuando se implementa en Azure, se puede usar la configuración de la aplicación.

Al conectarse a una instancia de caché con una función de Azure, puede usar tres tipos de conexiones en las implementaciones: cadena de Conectar ion, identidad administrada asignada por el sistema e identidad administrada asignada por el usuario.

Para el desarrollo local, también puede usar secretos de entidad de servicio.

appsettings Use para configurar cada uno de los siguientes tipos de autenticación de cliente, suponiendo que se estableció Redis en Connection en la función .

Cadena de conexión

"Redis": "<cacheName>.redis.cache.windows.net:6380,password=..."

Identidad administrada asignada por el sistema

"Redis:redisHostName": "<cacheName>.redis.cache.windows.net",
"Redis:principalId": "<principalId>"

Identidad administrada asignada por el usuario

"Redis:redisHostName": "<cacheName>.redis.cache.windows.net",
"Redis:principalId": "<principalId>",
"Redis:clientId": "<clientId>"

Secreto de entidad de servicio

Conectar ions que usan secretos de entidad de servicio solo están disponibles durante el desarrollo local.

"Redis:redisHostName": "<cacheName>.redis.cache.windows.net",
"Redis:principalId": "<principalId>",
"Redis:clientId": "<clientId>"
"Redis:tenantId": "<tenantId>"
"Redis:clientSecret": "<clientSecret>"

Contenido relacionado