Extensión Dapr para Azure Functions

Artículo
05/10/2024

La extensión Dapr para Azure Functions es un conjunto de herramientas y servicios que permiten a los desarrolladores integrar fácilmente Azure Functions con la plataforma Distributed Application Runtime (Dapr).

Azure Functions es un servicio de proceso controlado por eventos que proporciona un conjunto de desencadenadores y enlaces para conectarse fácilmente con otros servicios de Azure. Dapr proporciona un conjunto de bloques de compilación y procedimientos recomendados para compilar aplicaciones distribuidas, incluidos microservicios, administración de estado, mensajería pub/sub, etc.

Con la integración entre Dapr y Functions, puede compilar funciones que reaccionen a eventos de Dapr o sistemas externos.

Acción	Dirección	Tipo
Desencadenador en un enlace de entrada de Dapr	N/D	daprBindingTrigger
Desencadenador en una invocación del servicio Dapr	N/D	daprServiceInvocationTrigger
Desencadenador en una suscripción de tema de Dapr	N/D	daprTopicTrigger
Extracción en estado Dapr para una ejecución	In	daprState
Extracción de secretos de Dapr para una ejecución	In	daprSecret
Guardar un valor en un estado Dapr	Fuera	daprState
Invocación de otra aplicación Dapr	Fuera	daprInvoke
Publicación de un mensaje en un tema de Dapr	Fuera	daprPublish
Envío de un valor a un enlace de salida de Dapr	Fuera	daprBinding

Instalación de la extensión

El paquete NuGet de extensión que instale depende del modo de C# en proceso o proceso de trabajo aislado está usando en la aplicación de funciones:

En proceso
Proceso aislado

Esta extensión está disponible instalando el Paquete NuGet, versión 1.0.0.

Mediante la CLI de .NET:

dotnet add package Microsoft.Azure.WebJobs.Extensions.Dapr

Para agregar la extensión al proyecto, instale el paquete NuGet, versión 1.0.0.

Mediante la CLI de .NET:

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Dapr

Instalación del conjunto

Versión 4.x del conjunto

Puede agregar la extensión agregando o reemplazando el código siguiente en el archivo host.json:

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

Habilitación de Dapr

Puede configurar Dapr mediante varios [argumentos y anotaciones][dapr-args] en función del contexto de tiempo de ejecución. Puede configurar Dapr para Azure Functions a través de dos canales:

Plantillas de infraestructura como código (IaC), como en las plantillas de Bicep o Azure Resource Manager (ARM)
Azure Portal

Al usar una plantilla de IaC, especifique los argumentos siguientes en la sección properties de la definición de recursos de la aplicación de contenedor.

Bicep
ARM

DaprConfig: {
  enabled: true
  appId: '${envResourceNamePrefix}-funcapp'
  appPort: 3001
  httpReadBufferSize: ''
  httpMaxRequestSize: ''
  logLevel: ''
  enableApiLogging: true
}

"DaprConfig": {
  "enabled": true,
  "appId": "${envResourceNamePrefix}-funcapp",
  "appPort": 3001,
  "httpReadBufferSize": "",
  "httpMaxRequestSize": "",
  "logLevel": "",
  "enableApiLogging": true
}

Los valores de configuración de Dapr anteriores se consideran cambios en el ámbito de la aplicación. Al ejecutar una aplicación de contenedor en modo de revisión múltiple, los cambios en esta configuración no crearán una nueva revisión. En su lugar, se reiniciarán todas las revisiones existentes para asegurarse de que están configuradas con los valores más recientes.

Al configurar Dapr mediante Azure Portal, vaya a la aplicación de funciones y seleccione Dapr en el menú de la izquierda:

Captura de pantalla que muestra dónde buscar la habilitación de Dapr para una aplicación de funciones en Azure Portal.

Puertos y agentes de escucha de Dapr

Al desencadenar una función desde Dapr, la extensión expone automáticamente el puerto 3001 para escuchar las solicitudes entrantes desde el sidecar de Dapr.

Importante

El puerto 3001 solo se expone y escucha si se define un desencadenador Dapr en la aplicación de funciones. Cuando se usa Dapr, el sidecar espera a recibir una respuesta del puerto definido antes de completar la creación de instancias. No defina la anotacióndapr.io/port o --app-port a menos que tenga un desencadenador. Si lo hace, puede bloquear la aplicación desde el sidecar de Dapr.

Si solo usa enlaces de entrada y salida, no es necesario exponer ni definir el puerto 3001.

De forma predeterminada, cuando Azure Functions intenta comunicarse con Dapr, llama a Dapr a través del puerto resuelto desde la variable de entorno DAPR_HTTP_PORT. Si esa variable es null, el valor predeterminado es el puerto 3500.

Puede invalidar la dirección Dapr usada por los enlaces de entrada y salida estableciendo la propiedad DaprAddress en el enlace function.json (o el atributo). De manera predeterminada, usa http://localhost:{DAPR_HTTP_PORT}.

La aplicación de funciones todavía expone otro puerto y punto de conexión para cosas como desencadenadores HTTP, que de manera predeterminada local es 7071, pero en un contenedor, el valor predeterminado es 80.

Tipos de enlaces

Los tipos de enlace admitidos para .NET dependen de la versión de extensión y del modo de ejecución de C#, que puede ser uno de los siguientes:

Biblioteca de clases en proceso
Proceso aislado

Un biblioteca de clases en proceso es una función de C# compilada que se ejecuta en el mismo proceso que Functions Runtime.

La extensión Dapr admite tipos de parámetros según la tabla siguiente.

Enlace	Tipos de parámetro
Desencadenador de Dapr	daprBindingTrigger daprServiceInvocationTrigger daprTopicTrigger
Entrada de Dapr	daprState daprSecret
Salida de Dapr	daprState daprInvoke daprPublish daprBinding

Para obtener ejemplos de uso de estos tipos, consulte el repositorio de GitHub de la extensión.