Introducción a las versiones en tiempo de ejecución de Azure Functions

Azure Functions admite actualmente dos versiones del host en tiempo de ejecución. En la tabla siguiente se detallan las versiones del entorno de ejecución admitidas actualmente, su nivel de soporte y cuándo se deben usar:

En este artículo se detallan algunas de las diferencias entre las versiones admitidas, cómo se puede crear cada versión y cómo cambiar la versión en la que se ejecutan las funciones.

Niveles de soporte

Hay dos niveles de compatibilidad:

• Disponibilidad general (GA): totalmente compatible y aprobado para su uso en producción.
• Versión preliminar: todavía no se admite, pero se espera que llegue al estado de disponibilidad general en el futuro.

Lenguajes

Todas las funciones de una aplicación de función deben compartir el mismo lenguaje. Al crear la aplicación de funciones elige el lenguaje de las funciones. El lenguaje de la aplicación de funciones se mantiene en la configuración FUNCTIONS_WORKER_RUNTIME y no se puede cambiar cuando hay funciones existentes.

Asegúrese de seleccionar el lenguaje de desarrollo preferido en la parte superior del artículo.

Para obtener información sobre los cambios planeados en la compatibilidad con idiomas, consulte las actualizaciones de la hoja de ruta de Azure.

Para obtener información sobre las versiones de lenguaje de las versiones admitidas anteriormente del entorno de ejecución de Functions, vea Versiones del entorno de ejecución retiradas.

Ejecución en una versión específica

La configuración de la aplicación FUNCTIONS_EXTENSION_VERSION determina la versión del entorno de ejecución de Functions que usan las aplicaciones publicadas en Azure. En algunos casos y para determinados idiomas, se puede aplicar otra configuración.

De forma predeterminada, las aplicaciones de función creadas en el portal de Azure, por el CLI de Azure o desde las herramientas de Visual Studio se establecen en la versión 4.x. Puede modificar esta versión en caso necesario. Solo puede degradar la versión del entorno en tiempo de ejecución a 1.x después de crear la aplicación de funciones, pero antes de agregar ninguna función. La actualización a una versión principal posterior se permite incluso con las aplicaciones que tienen funciones existentes.

Migración de las aplicaciones de funciones existentes

Cuando la aplicación tenga funciones existentes, deberá tomar precauciones antes de pasar a una versión posterior del runtime principal. En los artículos siguientes se detallan los cambios importantes entre las versiones principales, incluidos los cambios importantes específicos del lenguaje. También se proporcionan instrucciones paso a paso para una migración correcta de la aplicación de funciones existente.

• Migración de la versión 3.x del runtime a la versión 4.x
• Migración de la versión 1.x del runtime a la versión 4.x

Cambiar la versión de las aplicaciones en Azure

Se usan los siguientes valores principales de la versión del runtime:

Anclaje a una versión secundaria específica

Para resolver problemas que la aplicación de funciones podría tener al ejecutarse en la versión principal más reciente, debe anclar temporalmente la aplicación a una versión secundaria específica. El anclaje le proporciona tiempo para que la aplicación se ejecute correctamente en la versión principal más reciente. La forma de anclar a una versión secundaria difiere entre Windows y Linux. Para obtener más información, consulte Cómo tener como destino las versiones del entorno de ejecución de Azure Functions.

Las versiones secundarias anteriores se quitan periódicamente de Functions. Para obtener las últimas noticias sobre las versiones de Azure Functions, incluida la eliminación de versiones secundarias anteriores específicas, supervise los anuncios de Azure App Service.

Versiones de extensión mínimas

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

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

Versiones retiradas

Estas versiones del entorno de ejecución de Functions llegaron al final del soporte extendido el 13 de diciembre de 2022.

Tan pronto como sea posible, debe migrar las aplicaciones a la versión 4.x para obtener soporte técnico completo. Para obtener un conjunto completo de instrucciones de migración específicas del lenguaje, consulte Migrar aplicaciones a Azure Functions versión 4.x.

Las aplicaciones que utilizan las versiones 2.x y 3.x pueden seguir creándose y desplegándose desde su canal CI/CD DevOps, y todas las aplicaciones existentes siguen ejecutándose sin cambios de última hora. Pero las aplicaciones no son aptas para recibir nuevas características, revisiones de seguridad ni optimizaciones del rendimiento. Solo puede obtener soporte técnico del servicio relacionado después de actualizar las aplicaciones a la versión 4.x.

Las versiones 2.x y 3.x ya no se admiten debido al final de la compatibilidad con .NET Core 3.1, que era una dependencia principal. Este requisito afecta a todos los languages admitidos por Azure Functions.

Versiones de aplicaciones desarrolladas de forma local

Puede hacer que las siguientes actualizaciones de las aplicaciones de funciones cambien localmente las versiones de destino.

versiones del entorno de ejecución de Visual Studio

En Visual Studio, seleccione la versión en tiempo de ejecución al crear un proyecto. Las herramientas de Azure Functions para Visual Studio admiten las dos versiones principales del tiempo de ejecución. Se usa la versión correcta al depurar y publicar en función de configuración del proyecto. La configuración de la versión se define en el archivo .csproj en las siguientes propiedades:

<TargetFramework>net8.0</TargetFramework>
<AzureFunctionsVersion>v4</AzureFunctionsVersion>

<TargetFramework>net48</TargetFramework>
<AzureFunctionsVersion>v1</AzureFunctionsVersion>

Visual Studio Code y Azure Functions Core Tools

Azure Functions Core Tools se usa para el desarrollo de línea de comandos y también para la extensión Azure Functions para Visual Studio Code. Para obtener más información, consulte Install the Azure Functions Core Tools.

Para el desarrollo de Visual Studio Code, también podría necesitar actualizar la configuración de usuario para azureFunctions.projectRuntime para que coincida con la versión de las herramientas instaladas. Esta configuración también actualiza las plantillas y los lenguajes utilizados durante la creación de la aplicación de función.

Enlaces

A partir de la versión 2.x, el entorno de ejecución usa un nuevo modelo de extensibilidad binding que ofrece estas ventajas:

• Compatibilidad con extensiones de enlace que no son de Microsoft.

• Desacoplamiento de tiempo de ejecución y enlaces. Este cambio permite el control de versiones y la publicación de las extensiones de enlace de forma independiente. Por ejemplo, puede elegir actualizar a una versión de una extensión que se basa en una versión más reciente de un SDK subyacente.

• Un entorno de ejecución más ligero, donde solo se conocen y se cargan en tiempo de ejecución los enlaces que están en uso.

A excepción de los desencadenadores HTTP y de temporizador, todos los enlaces deben agregarse explícitamente al proyecto de aplicación de funciones o registrarse en el portal. Para obtener más información, consulte los patrones de expresiones de enlace de Azure Functions.

En esta tabla se muestran los enlaces que se admiten en las versiones principales del entorno de ejecución de Azure Functions:

1. Registre todos los enlaces excepto HTTP y temporizador. Consulte Registrar extensiones de enlace de Azure Functions. Este paso no es necesario cuando se usa la versión 1.x del entorno de ejecución de Functions.
2. Support finaliza para la versión 1.x del entorno de ejecución de Azure Functions el 14 de septiembre de 2026. Migre las aplicaciones a la versión 4.x para obtener compatibilidad completa.
3. Los desencadenadores no se admiten en el plan de consumo. Este tipo de enlace requiere desencadenadores controlados por tiempo de ejecución.
4. Este tipo de enlace solo se admite en Kubernetes, Azure IoT Edge y otros modos autohospedados.

Duración del tiempo de espera de una aplicación de función

La propiedad del archivo host.json establece la duración del tiempo de espera para las funciones en una aplicación de funciones. Esta propiedad se aplica específicamente a las ejecuciones de funciones. Una vez que el desencadenador inicia la ejecución de la función, la función debe devolver o responder dentro de la duración del tiempo de espera. Cuando una ejecución supera esta duración, se produce un error de tiempo de espera y se reinicia el proceso de trabajo de lenguaje. En el caso de las aplicaciones de C# que se ejecutan en proceso, el host o proceso anfitrión se reinicia. Para evitar tiempos de espera y reinicios posteriores del proceso, es importante escribir funciones sólidas. Para obtener más información, consulte Mejorar el rendimiento y la confiabilidad de Azure Functions.

En la tabla siguiente se muestran los valores predeterminados y máximos (en minutos) para planes específicos:

1. Independientemente de la configuración de tiempo de espera de la aplicación de funciones, 230 segundos es la cantidad máxima de tiempo que una función desencadenada por HTTP puede tardar en responder a una solicitud. Este límite existe debido al valor predeterminado del tiempo de espera de inactividad del Azure Load Balancer. Para tiempos de procesamiento más largos, considere la posibilidad de usar el patrón asincrónico Durable Functions o aplazar el trabajo real y devolver una respuesta inmediata.
2. No se impone una duración máxima del tiempo de espera de ejecución. Sin embargo, el período de gracia proporcionado a una ejecución de una función es de 60 minutos durante la reducción horizontal para los planes Flex Consumption y Premium, y se da un período de gracia de 10 minutos durante las actualizaciones de la plataforma.
3. Requiere que el plan de App Service se establezca en Always On. Se da un período de gracia de 10 minutos durante las actualizaciones de la plataforma.
4. El tiempo de espera predeterminado para la versión 1.x del host de ejecución de Functions es ilimitado.
5. Cuando el número mínimo de réplicas se establece en cero, el tiempo de espera predeterminado depende de los desencadenadores específicos usados en la aplicación.

Estos valores asumen que el proceso de host de Azure Functions se inicia y se ejecuta correctamente. Hay un tiempo de espera máximo de 60 segundos para que también se inicie el proceso de trabajo específico del lenguaje. El tiempo de espera de inicio del proceso de trabajo no se puede configurar actualmente.

Contenido relacionado

Para obtener más información, consulte los siguientes recursos:

• Develop Azure Functions localmente mediante Core Tools
• Cómo establecer como destino las versiones del entorno de ejecución de Azure Functions
• Notas de la versión