Compartilhar via

Atualizar versões de pilha de linguagem no Azure Functions

No Azure Functions, o suporte para uma pilha de linguagens é limitado a versões específicas. À medida que novas versões se tornam disponíveis, talvez você queira atualizar seus aplicativos de funções para aproveitar os novos recursos. O suporte no Functions também pode terminar para versões mais antigas e normalmente está alinhado às linhas do tempo de fim de suporte da comunidade. Para obter mais informações, veja a política de suporte de runtime da linguagem. Para versões com suporte de várias linguagens, veja Linguagens por versão de runtime.

Para ajudar a garantir que seus aplicativos de funções continuem recebendo suporte, siga as instruções neste artigo para atualizá-los para as versões mais recentes disponíveis. A maneira como você atualiza seu aplicativo de funções depende de vários fatores:

  • A linguagem que você usa para desenvolver seus aplicativos de funções. Selecione sua linguagem de programação na parte superior deste artigo.
  • O sistema operacional no qual seu aplicativo de funções é executado no Azure: Windows ou Linux.
  • O plano de hospedagem.

Observação

Este artigo mostra como atualizar a versão do .NET de um aplicativo de funções que usa o modelo de trabalho isolado. Se o aplicativo de funções for executado em uma versão mais antiga do .NET e usar o modelo em processo, considere as seguintes opções:

Pré-requisitos

  • Uma conta do Azure com uma assinatura ativa. Crie um gratuitamente.
  • Um aplicativo de funções hospedado em um dos seguintes planos do Functions:
    • Premium
    • Dedicado
    • Consumo

Prepare seu aplicativo de funções

Antes de atualizar a configuração de pilha para seu aplicativo de funções no Azure, conclua as tarefas nas seções a seguir.

Verifique seu aplicativo de funções localmente

Teste e verifique o código do aplicativo de funções localmente na nova versão de destino.

Use estas etapas para atualizar o projeto em seu computador local:

  1. Verifique se a versão de destino do SDK do .NET está instalada.

    Se você estiver direcionando uma versão prévia, consulte as diretrizes do Functions para versões prévias do .NET para garantir que a versão tenha suporte. Usar as visualizações do .NET pode exigir mais etapas.

  2. Atualize suas referências para as versões mais recentes de Microsoft.Azure.Functions.Worker e Microsoft.Azure.Functions.Worker.Sdk.

  3. Atualize a estrutura de destino do projeto para a nova versão. Para os projetos C#, você deve atualizar o elemento <TargetFramework> no arquivo .csproj. Para obter mais informações sobre sua versão, veja as Estruturas de destino.

    Alterar a estrutura de destino do projeto também pode exigir alterações em partes da cadeia de ferramentas, fora do código do projeto. Por exemplo, no Visual Studio Code, talvez seja necessário atualizar a configuração da extensão azureFunctions.deploySubpath nas configurações do usuário ou no arquivo .vscode/settings.json do projeto. Verifique se há dependências na versão da estrutura que existem fora do código do projeto, como parte das etapas de build ou de um pipeline de CI/CD (integração contínua e entrega contínua).

  4. Faça atualizações no código do projeto necessárias para a nova versão do .NET. Verifique as notas de versão da versão para obter informações específicas. Você também pode usar o Assistente de Atualização do .NET para ajudar você a atualizar seu código em resposta a alterações em versões principais.

Depois de fazer essas alterações, recompile o projeto e teste-o para confirmar que o aplicativo de funções é executado conforme o esperado.

Mover para o runtime mais recente do Functions

Verifique se o aplicativo de funções está em execução na versão mais recente do runtime do Functions (versão 4.x). Você pode determinar a versão de runtime no portal do Azure ou usando a CLI do Azure.

Use estas etapas para determinar a versão do seu runtime do Functions:

  1. No portal do Azure, localize e selecione seu aplicativo de funções. No menu lateral, selecione Definições>Configurações.

  2. Vá para a guia Configurações de runtime de função e verifique o valor da Versão do runtime. Seu aplicativo de funções deve ser executado na versão 4.x do runtime do Functions (~4).

Se você precisar atualizar seu aplicativo de funções para a versão 4.x, veja Migrar aplicativos do Azure Functions versão 1.x para a versão 4.x ou Migrar aplicativos do Azure Functions versão 3.x para a versão 4.x. Siga as instruções nesses artigos em vez de apenas alterar a configuração FUNCTIONS_EXTENSION_VERSION.

Publicar as atualizações do aplicativo de funções

Se você atualizou seu aplicativo de funções para ser executado corretamente na nova versão, publique as atualizações do aplicativo de funções antes de atualizar a configuração de pilha para seu aplicativo de funções.

Dica

Para simplificar o processo de atualização, minimizar o tempo de inatividade para seus aplicativos de funções e fornecer uma versão potencial para reversão, você deve publicar seu aplicativo de funções atualizado em um slot de preparo. Para obter mais informações, consulte Slots de implantação do Azure Functions.

Ao publicar seu aplicativo de funções atualizado em um slot de preparo, siga as instruções de atualização específicas do slot no restante deste artigo. Posteriormente, você alternará o slot de preparo atualizado para produção.

Atualizar a configuração da pilha

A maneira como você atualiza a configuração de pilha depende se o aplicativo de funções é executado no Windows ou no Linux no Azure.

Ao usar um slot de preparo, certifique-se de direcionar suas atualizações para o slot correto.

Use as etapas a seguir para atualizar a versão do Java:

  1. No portal do Azure, localize e selecione seu aplicativo de funções. No menu lateral, selecione Definições>Configurações. Se você tiver um slot de preparo, selecione o slot específico.

  2. Na guia Configurações gerais, atualize a Versão Java para a versão desejada.

  3. Clique em Salvar. Quando você for notificado sobre uma reinicialização, selecione Continuar.

Use as etapas a seguir para atualizar a versão do .NET:

  1. No portal do Azure, localize e selecione seu aplicativo de funções. No menu lateral, selecione Definições>Configurações. Se você tiver um slot de preparo, selecione o slot específico.

  2. Na guia Configurações gerais, atualize a Versão do .NET para a versão desejada.

  3. Clique em Salvar. Quando você for notificado sobre uma reinicialização, selecione Continuar.

Use as seguintes etapas para atualizar a versão do Node.js:

  1. No portal do Azure, localize e selecione seu aplicativo de funções. No menu lateral, selecione Definições>Configurações. Se você tiver um slot de preparo, selecione o slot específico.

  2. Na guia Configurações gerais, atualize a Versão do Node.js para a versão desejada.

  3. Clique em Salvar. Quando você for notificado sobre uma reinicialização, selecione Continuar. Essa alteração atualiza a configuração de aplicativo WEBSITE_NODE_DEFAULT_VERSION.

Use as seguintes etapas para atualizar a versão do PowerShell:

  1. No portal do Azure, localize e selecione seu aplicativo de funções. No menu lateral, selecione Definições>Configurações. Se você tiver um slot de preparo, selecione o slot específico.

  2. Na guia Configurações gerais, atualize a Versão do PowerShell Core para a versão desejada.

  3. Clique em Salvar. Quando você for notificado sobre uma reinicialização, selecione Continuar.

Não há suporte para aplicativos Python no Windows. Vá para a guia Linux.

Seu aplicativo de funções é reiniciado depois que você atualiza a versão.

Trocar slots

Se você estiver usando um slot de preparo para implantar seu projeto de código e atualizar suas configurações, alterne o slot de preparo para produção. Para obter mais informações, consulte os slots de troca.

Conteúdo relacionado

Guia do desenvolvedor Java

Guia do processo de trabalho isolado do C#

Guia do desenvolvedor de Node.js

Guia do desenvolvedor de Python

Guia do desenvolvedor de PowerShell