Compartir a través de

Agrupaciones de extensiones de Azure Functions

En este artículo se explica cómo las agrupaciones de extensiones permiten que el código de función use todos los desencadenadores y enlaces admitidos por Azure Functions. También obtendrá información sobre los distintos niveles de soporte técnico y las directivas de las aplicaciones al usar conjuntos de extensiones.

Este artículo solo se aplica a los desarrolladores de Azure Functions que usan lenguajes non-.NET. Para obtener información sobre cómo agregar extensiones de enlace directamente a las aplicaciones de funciones de C#, consulte Registro de extensiones de enlace de Azure Functions.

Información general

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 de agrupación basada en las versiones de las extensiones que necesita 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.

Definición de una referencia de agrupación de extensiones

Para definir una referencia de agrupación de extensiones en el archivo de proyecto dehost.json , agregue una extensionBundle sección, como en este ejemplo:

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

Las siguientes propiedades están disponibles en extensionBundle:

Propiedad Descripción
id Espacio de nombres de las agrupaciones de extensiones de Microsoft Azure Functions.
version El rango de versión de la agrupación a instalar. Functions Runtime siempre elige la máxima versión permitida definida por el rango o intervalo de versiones. Por ejemplo, un rango de valor version de [4.0.0, 5.0.0) permite todas las versiones del conjunto desde la 4.0.0 en adelante, pero sin incluir la 5.0.0. Para más información, consulte la notación de intervalo para especificar intervalos de versiones.

Paquetes de extensiones admitidos

En esta tabla se enumeran todas las Microsoft.Azure.Functions.ExtensionBundle versiones de agrupación y el estado de compatibilidad actual.

Versión del conjunto Versión en host.json Estado de soporte técnico Fecha de finalización de soporte técnico
4.x [4.0.0, 5.0.0) Activo Todavía no se ha determinado
3.x [3.3.0, 4.0.0) Obsoleto 05/30/2026
2.x [2.*, 3.0.0) Obsoleto 05/30/2026
1.x [1.*, 2.0.0) Obsoleto 05/30/2026

Los conjuntos de extensiones predeterminados se definen mediante intervalos de versiones. Seleccione la versión del paquete para ver el archivo de definición extensions.json usado para generar la versión principal actual del paquete de extensiones.

Para obtener más información, consulte Directiva de soporte técnico.

Consideraciones sobre agrupaciones de extensiones

Tenga en cuenta estas consideraciones al trabajar con conjuntos de extensiones:

  • Cuando sea posible, debe establecer un version valor de intervalo en host.json de esta tabla, como [4.0.0, 5.0.0), en lugar de definir un intervalo personalizado.
  • 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.
  • En el improbable caso de que no pueda usar un conjunto de extensiones, debe instalar las extensiones explícitamente.

Conjuntos de extensiones en versión preliminar

Las versiones preliminares de extensiones de enlace específicas se mantienen en una agrupación de extensiones en versión preliminar. La agrupación de extensiones en versión preliminar (Microsoft.Azure.Functions.ExtensionBundle.Preview) permite aprovechar las extensiones en versión preliminar y los nuevos comportamientos de las extensiones existentes antes de que se declaren como disponibilidad general.

Tenga en cuenta estas consideraciones al elegir usar un conjunto de extensiones que no son de disponibilidad general:

  • Las agrupaciones en versión preliminar pueden incluir características que aún están en desarrollo y que aún no están listas para su uso en producción. Están diseñados para la evaluación y las pruebas en entornos que no son de producción.
  • Los cambios importantes se producen entre versiones preliminares sin previo aviso, lo que puede incluir cambios en:
    • Definiciones de desencadenador y enlace
    • Extensiones incluidas en la versión preliminar
    • Características de rendimiento y estabilidad
  • Es posible que las actualizaciones de seguridad requieran actualizar las versiones.
  • Debe probar completamente los conjuntos de vista previa en entornos que no son de producción y evitar el uso de agrupaciones de versión preliminar en producción. Cuando deba usar un paquete de versión preliminar en producción, tome estas precauciones adicionales:
    • Ancle la agrupación a una versión específica de lote bien probada en lugar de a un intervalo. Anclar evita la actualización automática de la versión del lote antes de tener la oportunidad de comprobar la actualización en un entorno que no sea de producción.
    • Mueva la aplicación a mediante una versión de agrupación de disponibilidad general tan pronto como la funcionalidad esté disponible en una versión de agrupación totalmente compatible.
  • Para mantenerse informado sobre las actualizaciones de agrupación, incluida la migración de la versión preliminar a la disponibilidad general, debe:
    • Supervise las versiones de la versión de agrupación en versión preliminar en la página de versión de paquetes de extensiones. - Versiones · Azure/azure-functions-extension-bundles
    • Supervise la documentación de referencia específica de la extensión.
    • Revise las versiones del paquete NuGet de extensiones de versión preliminar específicas que usa.
    • Realice un seguimiento de actualizaciones o cambios significativos en los registros de cambios publicados en NuGet.org para cada extensión de versión preliminar.

Directiva de soporte técnico

Las versiones principales de las agrupaciones de extensiones pueden producirse cuando hay cambios importantes o actualizaciones en las dependencias de las extensiones de enlace subyacentes. Estos cambios importantes, que a menudo se introducen en los SDK de Azure, requieren actualizaciones del paquete para seguir siendo compatibles.

El ciclo de soporte técnico de un conjunto de extensiones de disponibilidad general sigue estas fases distintas:

Fase Descripción
Activo La versión principal más reciente de los conjuntos de extensiones se considera la versión activa y se recomienda para las aplicaciones de funciones.
Notificación Microsoft proporciona un aviso avanzado antes de retirar una versión de extensión o paquete de extensión de enlace. Cuando reciba esta notificación, debe empezar a planear la actualización de las aplicaciones de funciones a una versión de paquete de extensiones compatible más reciente. Esta actualización garantiza que las aplicaciones sigan accediendo a nuevas características, mejoras de rendimiento y soporte técnico.
Deprecación Cuando una nueva versión de agrupación de extensiones principales está disponible con carácter general, la versión anterior entra en una fase de desuso de 12 meses. Este período de superposición proporciona tiempo para planear, probar y actualizar las aplicaciones antes de que se retire la versión anterior.
Retirado Después de la retirada de una agrupación de extensiones, las aplicaciones de funciones que hacen referencia a esa versión específica no son aptas para nuevas características, revisiones de seguridad y optimizaciones de rendimiento. Las aplicaciones de funciones que usan versiones retiradas todavía se pueden crear e implementar y se pueden ejecutar en la plataforma. Sin embargo, debe actualizar la aplicación de funciones a una versión de paquete compatible antes de poder recibir soporte técnico.

Puede ver las versiones del paquete de extensiones y sus extensiones incluidas en el repositorio de GitHub paquetes de extensiones de Azure Functions. Los paquetes .NET individuales se encuentran en https://nuget.org.

Para más información sobre las extensiones de enlace, consulte Registro de extensiones de enlace de Azure Functions.