Actualización de las versiones de la pila de lenguajes en Azure Functions

La compatibilidad con cualquier pila de lenguaje determinada en Azure Functions se limita a versiones específicas. A medida que las nuevas versiones estén disponibles, es posible que quiera actualizar las aplicaciones para aprovechar sus características. La compatibilidad con Functions también se podría terminar para versiones anteriores, normalmente alineadas con las escalas de tiempo de fin de soporte técnico de la comunidad. Consulte la directiva de compatibilidad con el runtime de lenguaje para obtener más información. Para asegurarse de que las aplicaciones sigan recibiendo soporte técnico, siga las instrucciones que se describen en este artículo para actualizarlas a las versiones disponibles más recientes.

La forma en que actualizará la aplicación de funciones depende de:

• El lenguaje que se usa para crear las funciones. Asegúrese de elegir el lenguaje de programación en la parte superior del artículo.
• Sistema operativo en el que se ejecuta la aplicación en Azure: Windows o Linux.
• El Plan de hospedaje.

Nota:

En este artículo se muestra cómo actualizar la versión de .NET de una aplicación mediante el modelo de trabajo aislado. Las aplicaciones que se ejecutan en versiones anteriores de .NET con el modelo en proceso pueden actualizar a .NET 8de destino, o bien pueden migrar desde el modelo en proceso al modelo de trabajo aislado.

Preparación para la actualización

Antes de actualizar la configuración de pila de la aplicación de funciones en Azure, debería completar estas tareas:

1. Verifique las funciones localmente

Asegúrese de probar y comprobar el código de función localmente en la nueva versión de destino.

Siga estos pasos para actualizar el proyecto en el equipo local:

1. Asegúrese de haber instalado la versión de destino del SDK de .NET.

   Si su destino es una versión preliminar, consulte la guía de Functions para obtener una vista previa de las versiones de .NET para asegurarse de que la versión es compatible. Es posible que haya que dar pasos adicionales para las versiones preliminares de .NET.

2. Actualice las referencias a las versiones más recientes de: Microsoft.Azure.Functions.Worker y Microsoft.Azure.Functions.Worker.Sdk.

3. Actualice la plataforma de destino del proyecto a la nueva versión. Para los proyectos de C#, se debe actualizar el elemento <TargetFramework> en el archivo .csproj. Consulte plataformas de destino para obtener información específica relacionada con la versión elegida.

   Cambiar la plataforma de destino del proyecto también puede requerir cambios en partes de la cadena de herramientas, fuera del código del proyecto. Por ejemplo, en VS Code, es posible que tenga que actualizar la configuración de extensión azureFunctions.deploySubpath a través de la configuración de usuario o el archivo .vscode/settings.json del proyecto. Compruebe si hay dependencias en la versión del marco que puede existir fuera del código del proyecto, como parte de los pasos de compilación o una canalización de CI/CD.

4. Realice cualquier actualización en el código del proyecto que requiera la nueva versión de .NET. Compruebe las notas de la versión para obtener información específica. También se puede usar el Asistente para actualización de .NET para ayudarle a actualizar código en respuesta a los cambios en las versiones principales.

Después de realizar esos cambios, recompile el proyecto y pruébelo para confirmar que la aplicación se ejecute según lo previsto.

2. Pasar al tiempo de ejecución de Functions más reciente

Asegúrese de que la aplicación de funciones se ejecute en la última versión del tiempo de ejecución de Functions (versión 4.x). Determine la versión en tiempo de ejecución en Azure Portal o mediante la CLI de Azure.

Azure Portal

Siga estos pasos para determinar la versión del entorno de ejecución de Functions:

1. En el Azure Portal, busque la aplicación de funciones y seleccione Configuración en el lado izquierdo, bajo Valores.

2. Seleccione la pestaña Configuración del entorno de ejecución de la función y compruebe el valor de Versión en tiempo de ejecución para ver si la aplicación de funciones se ejecuta en la versión 4.x del runtime de Functions (~4).

   

CLI de Azure

Use este az functionapp config appsettings list comando para comprobar la versión del entorno de ejecución:

az functionapp config appsettings list --name "<FUNCTION_APP_NAME>" --resource-group "<RESOURCE_GROUP_NAME>"  

La FUNCTIONS_EXTENSION_VERSION configuración establece la versión en tiempo de ejecución. Un valor de ~4 significa que la aplicación de funciones ya se está ejecutando en la versión secundaria más reciente de la versión principal más reciente (4.x).

Si necesita actualizar primero la aplicación de funciones a la versión 4.x, consulte Migración de aplicaciones de Azure Functions versión 1.x a la versión 4.x o Migración de aplicaciones de Azure Functions versión 3.x a la versión 4.x. Siga las instrucciones de estos artículos en lugar de cambiar simplemente la configuración de FUNCTIONS_EXTENSION_VERSION.

Publicar actualizaciones de aplicaciones

Si actualizó la aplicación para que se ejecute correctamente en la nueva versión, publique las actualizaciones de la aplicación antes de actualizar la configuración de la pila de la aplicación de funciones.

Sugerencia

Para simplificar el proceso de actualización, minimice el tiempo de inactividad de las funciones y proporcione una posible reversión. Se recomienda publicar la aplicación actualizada en un espacio de ensayo. Para obtener más información, consulte Ranuras de implementación de Azure Functions.

Al publicar la aplicación actualizada en un espacio de ensayo, asegúrese de seguir las instrucciones de actualización específicas de ranuras en el resto de este artículo. Posteriormente, cambie el espacio de ensayo actualizado a producción.

Actualice la configuración de la pila

La forma en que se actualiza la configuración de la pila depende de si se ejecuta en Windows o en Linux en Azure.

Al usar espacios de ensayo, asegúrese de tener como destino de las actualizaciones las ranuras correctas.

Windows

Siga los siguientes pasos para actualizar la versión de Java:

1. En el Azure Portal, busque la aplicación de funciones y seleccione Configuración en el lado izquierdo. Al usar un espacio de ensayo, asegúrese de seleccionar primero la ranura específica.

2. En la pestaña Configuración general, actualice la versión de Java a la versión deseada.

   

3. Seleccione Guardar y, cuando se le notifique sobre un reinicio, seleccione Continuar.

Siga los pasos siguientes para actualizar la versión de .NET:

1. En el Azure Portal, busque la aplicación de funciones y seleccione Configuración en el lado izquierdo. Al usar un espacio de ensayo, asegúrese de seleccionar primero la ranura específica.

2. En la pestaña Configuración general, actualice la versión de .NET a la versión deseada.

   

3. Seleccione Guardar y, cuando se le notifique sobre un reinicio, seleccione Continuar.

Siga los pasos siguientes para actualizar la versión de Node.js:

1. En el Azure Portal, busque la aplicación de funciones y seleccione Configuración en el lado izquierdo. Al usar un espacio de ensayo, asegúrese de seleccionar primero la ranura específica.

2. En la pestaña Configuración general, actualice la versión de Node.js a la versión deseada.

   

3. Seleccione Guardar y, cuando se le notifique sobre un reinicio, seleccione Continuar. Este cambio actualizará la configuración de la aplicación WEBSITE_NODE_DEFAULT_VERSION.

Siga los pasos siguientes para actualizar la versión de PowerShell:

1. En el Azure Portal, busque la aplicación de funciones y seleccione Configuración en el lado izquierdo. Al usar un espacio de ensayo, asegúrese de seleccionar primero la ranura específica.

2. En la pestaña Configuración general, actualice la versión de .NET a la versión deseada.

   

3. Seleccione Guardar y, cuando se le notifique sobre un reinicio, seleccione Continuar.

Las aplicaciones de Python no se admiten en Windows. En su lugar, seleccione la pestaña Linux.

Linux

Nota:

Solo se puede usar Azure Portal para actualizar aplicaciones de funciones en Linux hospedadas en un plan Premium o un plan Dedicado (App Service). En el caso de aplicaciones Linux hospedadas en un plan Consumo, se debe usar la CLI de Azure.

Siga los siguientes pasos para actualizar la versión de Java:

1. En el Azure Portal, busque la aplicación de funciones y seleccione Configuración en el lado izquierdo. Al usar un espacio de ensayo, asegúrese de seleccionar primero la ranura específica.

2. En la pestaña Configuración general, actualice la versión de Java a la versión deseada.

   

3. Seleccione Guardar y, cuando se le notifique sobre un reinicio, seleccione Continuar.

Siga los pasos siguientes para actualizar la versión de .NET:

1. En el Azure Portal, busque la aplicación de funciones y seleccione Configuración en el lado izquierdo. Al usar un espacio de ensayo, asegúrese de seleccionar primero la ranura específica.

2. En la pestaña Configuración general, actualice la versión de .NET a la versión deseada.

   

3. Seleccione Guardar y, cuando se le notifique sobre un reinicio, seleccione Continuar.

Siga los pasos siguientes para actualizar la versión de Node.js:

1. En el Azure Portal, busque la aplicación de funciones y seleccione Configuración en el lado izquierdo. Al usar un espacio de ensayo, asegúrese de seleccionar primero la ranura específica.

2. En la pestaña Configuración general, actualice la versión de Node.js a la versión deseada.

   

3. Seleccione Guardar y, cuando se le notifique sobre un reinicio, seleccione Continuar. Este cambio actualizará la configuración de la aplicación WEBSITE_NODE_DEFAULT_VERSION.

Siga los pasos siguientes para actualizar la versión de PowerShell:

1. En el Azure Portal, busque la aplicación de funciones y seleccione Configuración en el lado izquierdo. Al usar un espacio de ensayo, asegúrese de seleccionar primero la ranura específica.

2. En la pestaña Configuración general, actualice la versión de .NET a la versión deseada.

   

3. Seleccione Guardar y, cuando se le notifique sobre un reinicio, seleccione Continuar.

Las aplicaciones de Python no se admiten en Windows. En su lugar, seleccione la pestaña Linux.

1. En el Azure Portal, busque la aplicación de funciones y seleccione Configuración en el lado izquierdo. Al usar un espacio de ensayo, asegúrese de seleccionar primero la ranura específica.

2. En la pestaña Configuración general, actualice la versión de Python a la versión deseada.

   

   Nota:

   No se puede cambiar la versión de Python cuando se ejecuta en un plan Consumo.

3. Seleccione Guardar y, cuando se le notifique sobre un reinicio, seleccione Continuar.

Windows

Las aplicaciones de Python no se admiten en Windows. En su lugar, seleccione la pestaña Linux.

En primer lugar, use el comando az functionapp list-runtimes para ver los valores de versión admitidos para el lenguaje. A continuación, ejecute el comando az functionapp config set para actualizar la versión de lenguaje de la aplicación de funciones:

Ejecute el comando az functionapp list-runtimes para ver los valores de versión admitidos para .NET en el modelo de trabajo aislado:

az functionapp list-runtimes --os "windows" --query "[?runtime == 'java'].{Version:version}" --output table

az functionapp config set --java-version "<VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"  

az functionapp list-runtimes --os "windows" --query "[?runtime == 'dotnet-isolated'].{Version:version}" --output table

Ejecute el comando az functionapp config set para actualizar la versión de .NET de la aplicación de funciones:

az functionapp config set --net-framework-version "v<VERSION>.0" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"  

En primer lugar, use el comando az functionapp list-runtimes para ver los valores de versión admitidos para la pila de lenguaje (Node.js). A continuación, ejecute el comando az functionapp config set para actualizar la versión de Node.js de la aplicación de funciones:

az functionapp list-runtimes --os "windows" --query "[?runtime == 'node'].{Version:version}" --output table

az functionapp config appsettings set --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --settings "WEBSITE_NODE_DEFAULT_VERSION=~<VERSION>" --slot "staging"  

az functionapp list-runtimes --os "windows" --query "[?runtime == 'powershell'].{Version:version}" --output table

az functionapp config set --powershell-version "<VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"  

En el ejemplo anterior, sustituya <APP_NAME> y <RESOURCE_GROUP> por el nombre de su aplicación de función y grupo de recursos, respectivamente. Reemplace también <VERSION> por la versión de lenguaje admitida a la que vaya a actualizar. Si no usa un espacio de ensayo, quite el parámetro --slot.

Linux

Nota:

No se puede cambiar la versión de Python cuando se ejecuta en un plan Consumo.

Ejecute el comando az functionapp list-runtimes para ver la configuración del sitio linuxFxVersion compatible con la versión de lenguaje:

Ejecute el comando az functionapp list-runtimes para ver la configuración del sitio linuxFxVersion compatible con la versión de la pila de lenguaje:

az functionapp list-runtimes --os linux --query "[?runtime == 'python'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'dotnet-isolated'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'node'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'python'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'powershell'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

Ejecute el comando az functionapp config set para actualizar la configuración del sitio para la nueva versión de lenguaje de la aplicación de funciones:

Ejecute el comando az functionapp config set para actualizar la configuración del sitio para la nueva versión de pila de la aplicación de funciones:

az functionapp config set --linux-fx-version "<LANGUAGE|VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"  

En el ejemplo anterior, sustituya <APP_NAME> y <RESOURCE_GROUP> por el nombre de su aplicación de función y grupo de recursos, respectivamente. Reemplace también <LANGUAGE|VERSION> por el linuxFxVersion de la actualización. Si no usa un espacio de ensayo, quite el parámetro --slot.

La aplicación de funciones se reiniciará después de actualizar la versión.

Intercambio de ranuras

Si estuvo realizando la implementación del proyecto de código y actualizando la configuración en un espacio de ensayo, finalmente deberá cambiar del espacio de ensayo a producción. Para obtener más información, consulte Intercambiar ranuras.

Pasos siguientes

Guía para desarrolladores de Java

Guía de procesos de trabajo aislado de C#

Guía para desarrolladores de Node.js

Guía para desarrolladores de Python

Guía para desarrolladores de PowerShell