Registro de las extensiones de enlace de Azure Functions

El entorno de ejecución de Azure Functions ejecuta de forma nativa desencadenadores HTTP y temporizador. Los comportamientos de los otros desencadenadores y enlaces admitidos se implementan en paquetes de extensión independientes.

Los proyectos de biblioteca de clases de .NET usan extensiones de enlace que se instalan en el proyecto como paquetes NuGet.

Las agrupaciones de extensiones permiten que las aplicaciones de non-.NET usen extensiones de enlace sin tener que interactuar con la infraestructura de .NET.

Conjuntos de extensiones

Las agrupaciones de extensiones agregan un conjunto predefinido de extensiones de enlace compatibles a la aplicación de funciones. Los conjuntos de extensiones tienen control de versiones. Cada versión contiene un conjunto específico de extensiones de enlace que se ha comprobado que funcionan juntas. Seleccione una versión del conjunto en función de las extensiones que necesite en la aplicación.

Al crear un proyecto de Azure Functions a partir de una plantilla de non-.NET, los conjuntos de extensiones ya están habilitados en el archivo host.json de la aplicación.

Cuando sea posible, use el intervalo de versiones más reciente para obtener un rendimiento óptimo de la aplicación y acceder a las características más recientes. Para más información sobre los conjuntos de extensiones, consulte Paquetes de extensiones de Azure Functions.

En el improbable caso de que no pueda usar un conjunto de extensiones, debe instalar las extensiones explícitamente.

Instalación explícita de extensiones

En el caso de los proyectos de biblioteca de clases de C# compilados, instale los paquetes NuGet para las extensiones que necesita como lo haría normalmente en las aplicaciones. Para obtener más información, consulte la guía para desarrolladores de Visual Studio Code o la guía para desarrolladores de Visual Studio.

Asegúrese de obtener el paquete correcto porque el espacio de nombres difiere en función del modelo de ejecución:

Modelo de ejecución	Namespace
Proceso de trabajo aislado	Microsoft.Azure.Functions.Worker.Extensions.*
En proceso	Microsoft.Azure.WebJobs.Extensions.*

Functions proporciona agrupaciones de extensiones para proyectos de non-.NET, que contienen un conjunto completo de extensiones de enlace que se comprueban que son compatibles. Si tiene problemas de compatibilidad entre dos o más extensiones de enlace, revise las combinaciones compatibles de versiones de extensión. Para ver las combinaciones admitidas de extensiones de enlace, consulte la página de lanzamiento de paquetes de extensiones.

Hay casos en los que no se pueden usar agrupaciones de extensiones, como cuando es necesario usar una versión preliminar específica de una extensión específica. En estos casos poco frecuentes, debes instalar manualmente las extensiones de enlace necesarias en un archivo de proyecto de C# que haga referencia a las extensiones específicas requeridas por la aplicación. Para instalar manualmente extensiones de enlace:

1. Quite la referencia del paquete de extensiones del archivo host.json.

2. Use el comando func extensions install en Azure Functions Core Tools para generar el archivo extensions.csproj necesario en la raíz del proyecto local.

   Para el desarrollo solo en el portal, debe crear manualmente un archivo extensions.csproj en la raíz de la aplicación de funciones en Azure. Para obtener más información, consulte Instalación manual de extensiones.

3. Edite el archivo extensions.csproj agregando explícitamente un PackageReference elemento para cada versión y extensión de enlace específica requerida por la aplicación.

4. Valide la funcionalidad de la aplicación localmente y vuelva a implementar el proyecto, incluido extensions.csproj, en la aplicación de funciones de Azure.

Tan pronto como sea posible, debes volver a cambiar la aplicación al uso del paquete de extensiones compatible más reciente.

Pasos siguientes

Ejemplo de desencadenador y enlace de Azure Functions