Cómo seleccionar un destino para versiones en tiempo de ejecución de Azure FunctionsHow to target Azure Functions runtime versions

Una aplicación de función se ejecuta en una versión específica del runtime de Azure Functions.A function app runs on a specific version of the Azure Functions runtime. Hay tres versiones principales: 1.x, 2.x y 3.x.There are three major versions: 1.x, 2.x, and 3.x. De forma predeterminada, las aplicaciones de función se crean en la versión 3.x del entorno de ejecución.By default, function apps are created in version 3.x of the runtime. En este artículo se explica cómo configurar una aplicación de función en Azure para que se ejecute en la versión que elija.This article explains how to configure a function app in Azure to run on the version you choose. Para obtener información sobre cómo configurar un entorno de desarrollo local para una versión específica, consulte Codificación y comprobación de las funciones de Azure Functions en un entorno local.For information about how to configure a local development environment for a specific version, see Code and test Azure Functions locally.

Actualizaciones de versiones automáticas y manualesAutomatic and manual version updates

Azure Functions permite hacer que el destino sea una versión específica del entorno en tiempo de ejecución mediante el uso de la configuración de aplicación FUNCTIONS_EXTENSION_VERSION en la aplicación de función.Azure Functions lets you target a specific version of the runtime by using the FUNCTIONS_EXTENSION_VERSION application setting in a function app. La aplicación de función se mantiene en la versión principal especificada hasta que elija explícitamente moverla a una nueva versión.The function app is kept on the specified major version until you explicitly choose to move to a new version. Si especifica solo la versión principal, la aplicación de funciones se actualiza automáticamente a las nuevas versiones secundarias del entorno de ejecución cuando están disponibles.If you specify only the major version, the function app is automatically updated to new minor versions of the runtime when they become available. Las nuevas versiones secundarias no deberían introducir cambios importantes.New minor versions shouldn't introduce breaking changes.

Si especifica una versión secundaria (por ejemplo, "2.0.12345"), la aplicación de función se mantiene en esa versión específica hasta que la modifique explícitamente.If you specify a minor version (for example, "2.0.12345"), the function app is pinned to that specific version until you explicitly change it. Las versiones secundarias anteriores se quitan del entorno de producción de manera periódica.Older minor versions are regularly removed from the production environment. Una vez que esto ocurre, la aplicación de funciones se ejecuta en la versión más reciente en lugar de hacerlo en la versión establecida en FUNCTIONS_EXTENSION_VERSION.After this occurs, your function app runs on the latest version instead of the version set in FUNCTIONS_EXTENSION_VERSION. Por este motivo, debe resolver rápidamente cualquier problema con la aplicación de funciones que requiera una versión secundaria específica, de modo que pueda tener como destino la versión principal.Because of this, you should quickly resolve any issues with your function app that require a specific minor version, so that you can instead target the major version. Las eliminaciones de versiones secundarias se anuncian en los anuncios de App Service.Minor version removals are announced in App Service announcements.

Nota

Si ancla una versión principal específica de Azure Functions y, a continuación, intenta publicar en Azure mediante Visual Studio, aparecerá un cuadro de diálogo que le solicitará que actualice a la versión más reciente o que cancele la publicación.If you pin to a specific major version of Azure Functions, and then try to publish to Azure using Visual Studio, a dialog window will pop up prompting you to update to the latest version or cancel the publish. Para evitarlo, agregue la propiedad <DisableFunctionExtensionVersionUpdate>true</DisableFunctionExtensionVersionUpdate> en su archivo .csproj.To avoid this, add the <DisableFunctionExtensionVersionUpdate>true</DisableFunctionExtensionVersionUpdate> property in your .csproj file.

Cuando una nueva versión está disponible públicamente, un aviso en el portal le da la oportunidad de pasar a esa versión.When a new version is publicly available, a prompt in the portal gives you the chance to move up to that version. Después de pasar a una nueva versión, siempre puede usar la configuración de la aplicación FUNCTIONS_EXTENSION_VERSION para volver a una versión anterior.After moving to a new version, you can always use the FUNCTIONS_EXTENSION_VERSION application setting to move back to a previous version.

En la tabla siguiente se muestran los valores de FUNCTIONS_EXTENSION_VERSION de cada versión principal, para habilitar las actualizaciones automáticas:The following table shows the FUNCTIONS_EXTENSION_VERSION values for each major version to enable automatic updates:

Versión principalMajor version Valor de FUNCTIONS_EXTENSION_VERSIONFUNCTIONS_EXTENSION_VERSION value
3.x3.x ~3
2.x2.x ~2
1.x1.x ~1

Un cambio en la versión del runtime hace que la aplicación de función se reinicie.A change to the runtime version causes a function app to restart.

Visualización y actualización de la versión actual del entorno de ejecuciónView and update the current runtime version

Puede cambiar la versión del entorno en tiempo de ejecución que la aplicación de función usa.You can change the runtime version used by your function app. Debido a la posibilidad de cambios importantes, solo puedes cambiar la versión del entorno de ejecución antes de crear cualquier función en la aplicación de funciones.Because of the potential of breaking changes, you can only change the runtime version before you have created any functions in your function app.

Importante

Si bien la versión del runtime la determina la configuración FUNCTIONS_EXTENSION_VERSION, este cambio se debe hacer en Azure Portal y no cambiando directamente la configuración.Although the runtime version is determined by the FUNCTIONS_EXTENSION_VERSION setting, you should make this change in the Azure portal and not by changing the setting directly. Esto se debe a que el portal valida los cambios y hace cambios relacionados adicionales según sea necesario.This is because the portal validates your changes and makes other related changes as needed.

Utilice el siguiente procedimiento para ver y actualizar la versión del runtime que utiliza una aplicación de función.Use the following procedure to view and update the runtime version currently used by a function app.

  1. En Azure Portal, vaya a la aplicación de función.In the Azure portal, browse to your function app.

  2. En las opciones de configuración haga clic en Configuración.Under Settings, choose Configuration. En la pestaña Configuración del entorno de ejecución de Function, busque la versión del entorno de ejecución.In the Function runtime settings tab, locate the Runtime version. Anote la versión específica del entorno de ejecución.Note the specific runtime version. En el ejemplo siguiente, la versión se establece en ~3.In the example below, the version is set to ~3.

    Consulte la versión del entorno de ejecución.

  3. Para anclar la aplicación de función a la versión 1.x del entorno de ejecución, elija ~1 en Versión en tiempo de ejecución.To pin your function app to the version 1.x runtime, choose ~1 under Runtime version. Este modificador está deshabilitado cuando tiene funciones en la aplicación.This switch is disabled when you have functions in your app.

  4. Cuando cambie la versión del runtime, vuelva a la pestaña Información general y elija Reiniciar para reiniciar la aplicación.When you change the runtime version, go back to the Overview tab and choose Restart to restart the app. La aplicación de función se reinicia y se ejecuta en la versión 1.x del entorno de ejecución y se usan las plantillas de la versión 1.x al crear las funciones.The function app restarts running on the version 1.x runtime, and the version 1.x templates are used when you create functions.

    Consulte la versión del entorno de ejecución.

Nota

Azure Portal no permite cambiar la versión del entorno en tiempo de ejecución para una aplicación de función que ya contiene funciones.Using the Azure portal, you can't change the runtime version for a function app that already contains functions.

La aplicación de funciones se reinicia después de realizar el cambio en la configuración de la aplicación.The function app restarts after the change is made to the application setting.

Pasos siguientesNext steps