Compartir vía

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

En Azure Functions, la compatibilidad con una pila de lenguajes se limita a versiones específicas. A medida que las nuevas versiones estén disponibles, es posible que quiera actualizar las aplicaciones de funciones para aprovechar las nuevas características. La compatibilidad con Functions también puede finalizar para versiones anteriores y normalmente se alinea con las escalas de tiempo de fin de soporte técnico de la comunidad. Para obtener más información, consulte la directiva de compatibilidad de tiempo de ejecución de lenguaje. Para obtener versiones compatibles de varios idiomas, consulte Idiomas por versión en tiempo de ejecución.

Para asegurarse de que las aplicaciones de funciones siguen recibiendo soporte técnico, siga las instrucciones de este artículo para actualizarlas a las versiones disponibles más recientes. La forma en que actualiza la aplicación de funciones depende de varios factores:

  • El lenguaje que se usa para desarrollar las aplicaciones de funciones. Asegúrese de seleccionar el lenguaje de programación en la parte superior de este artículo.
  • Sistema operativo en el que se ejecuta la aplicación de funciones 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 de funciones que usa el modelo de trabajo aislado. Si la aplicación de funciones se ejecuta en una versión anterior de .NET y usa el modelo en proceso, tenga en cuenta las siguientes opciones:

Prerrequisitos

  • Una cuenta de Azure con una suscripción activa. cree una de forma gratuita.
  • Una aplicación de funciones hospedada en uno de los siguientes planes de Functions:
    • Premium
    • Dedicated
    • Consumption

Preparación de la aplicación de funciones

Antes de actualizar la configuración de pila de la aplicación de funciones en Azure, complete las tareas de las secciones siguientes.

Comprobación local de la aplicación de funciones

Pruebe y compruebe el código de la aplicación de funciones localmente en la nueva versión de destino.

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

  1. Asegúrese de que la versión de destino del SDK de .NET está instalada.

    Si tiene como destino una versión preliminar, consulte Las instrucciones de Functions para obtener una versión preliminar de .NET para asegurarse de que la versión es compatible. El uso de versiones preliminares de .NET puede requerir más pasos.

  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#, debe actualizar el elemento <TargetFramework> en el archivo .csproj. Para obtener más información sobre su versión, consulte marcos de destino.

    Cambiar el marco 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 Visual Studio Code, es posible que tenga que actualizar la configuración de extensión azureFunctions.deploySubpath en la configuración de usuario o en el archivo .vscode/settings.json del proyecto. Compruebe si hay dependencias en la versión del marco que existe fuera del código del proyecto, como parte de los pasos de compilación o una canalización de integración continua y entrega continua (CI/CD).

  4. Realice actualizaciones en el código del proyecto que requiera la nueva versión de .NET. Compruebe las notas de la versión de la versión para obtener información específica. También puede usar el Asistente para actualización de .NET para ayudar a actualizar el 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 de funciones se ejecuta según lo previsto.

Pasar al entorno de ejecución de Functions más reciente

Asegúrese de que la aplicación de funciones se ejecuta en la versión más reciente del entorno 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.

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

  1. En Azure Portal, busque y seleccione la aplicación de funciones. En el menú lateral, seleccione Ajustes>Configuración.

  2. Vaya a 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. La aplicación de funciones debe ejecutarse en la versión 4.x del entorno de ejecución de Functions (~4).

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

Publicar actualizaciones de la aplicación de funciones

Si ha actualizado la aplicación de funciones para que se ejecute correctamente en la nueva versión, publique las actualizaciones de la aplicación de funciones 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 aplicaciones de funciones y proporcione una versión potencial para la reversión. Debe publicar la aplicación de funciones 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 de funciones actualizada en una ranura de ensayo, asegúrese de seguir las instrucciones de actualización específicas de ranura 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 actualiza la configuración de la pila depende de si la aplicación de funciones se ejecuta en Windows o en Linux en Azure.

Al usar un espacio de prueba, asegúrese de que sus actualizaciones se dirijan al espacio correcto.

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

  1. En Azure Portal, busque y seleccione la aplicación de funciones. En el menú lateral, seleccione Ajustes>Configuración. Si tiene un espacio de ensayo, seleccione el espacio específico.

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

  3. Haga clic en Guardar. Cuando se le notifique sobre un reinicio, seleccione Continuar.

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

  1. En Azure Portal, busque y seleccione la aplicación de funciones. En el menú lateral, seleccione Ajustes>Configuración. Si tiene un espacio de ensayo, seleccione el espacio específico.

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

  3. Haga clic en Guardar. Cuando se le notifique sobre un reinicio, seleccione Continuar.

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

  1. En Azure Portal, busque y seleccione la aplicación de funciones. En el menú lateral, seleccione Ajustes>Configuración. Si tiene un espacio de ensayo, seleccione el espacio específico.

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

  3. Haga clic en Guardar. 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 Azure Portal, busque y seleccione la aplicación de funciones. En el menú lateral, seleccione Ajustes>Configuración. Si tiene un espacio de ensayo, seleccione el espacio específico.

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

  3. Haga clic en Guardar. Cuando se le notifique sobre un reinicio, seleccione Continuar.

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

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

Intercambio de ranuras

Si usa un espacio de ensayo para implementar el proyecto de código y actualizar la configuración, cambie el espacio de ensayo a producción. Para obtener más información, consulte Intercambiar ranuras.

Contenido relacionado

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

  • Last updated on