Atualizar versões da pilha de idiomas no Azure Functions
O suporte para qualquer pilha de idiomas no Azure Functions é limitado a versões específicas. À medida que novas versões ficam disponíveis, convém atualizar seus aplicativos para aproveitar seus recursos. O suporte no Functions também pode terminar para versões mais antigas, normalmente alinhado aos cronogramas de fim de suporte da comunidade. Consulte a política de suporte ao Language Runtime para obter detalhes. Para garantir que seus aplicativos continuem a receber suporte, siga as instruções descritas neste artigo para atualizá-los para as versões mais recentes disponíveis.
A maneira como você atualiza seu aplicativo de função depende:
- A linguagem que utiliza para criar as suas funções; Certifique-se de escolher sua linguagem de programação na parte superior do artigo.
- O sistema operacional no qual seu aplicativo é executado no Azure: Windows ou Linux.
- O plano de hospedagem.
Este artigo mostra como atualizar a versão .NET de um aplicativo usando o modelo de trabalho isolado. Os aplicativos executados no modelo em processo ainda não podem ser atualizados para o .NET 8 sem alternar para o modelo de trabalho isolado. Para migrar para o modelo de trabalho isolado, consulte Migrar aplicativos .NET do modelo em processo para o modelo de trabalho isolado. Para obter informações sobre planos do .NET 8, incluindo opções futuras para o modelo em processo, consulte a publicação Atualização do Roteiro do Azure Functions.
Preparar para atualizar
Antes de atualizar a configuração de pilha para seu aplicativo de função no Azure, você deve concluir estas tarefas:
1. Verifique as suas funções localmente
Certifique-se de testar e verificar seu código de função localmente na nova versão de destino.
Use estas etapas para atualizar o projeto em seu computador local:
Certifique-se de ter instalado a versão de destino do SDK do .NET.
Atualize suas referências para as versões estáveis mais recentes de: Microsoft.Azure.Functions.Worker e Microsoft.Azure.Functions.Worker.Sdk.
Atualize a estrutura de destino do seu projeto para a nova versão. Para projetos C#, você deve atualizar o
<TargetFramework>.csprojelemento no arquivo. Consulte Estruturas de destino para obter informações específicas relacionadas à versão escolhida.Faça quaisquer atualizações para o código do projeto que são exigidas pela nova versão do .NET. Verifique as notas de versão da versão para obter detalhes. Você também pode usar o Assistente de Atualização do .NET para ajudá-lo a atualizar seu código em resposta a alterações nas versões principais.
Depois de fazer essas alterações, recrie seu projeto e teste-o para confirmar que seu aplicativo é executado conforme o esperado.
2. Mover para o tempo de execução mais recente do Functions
Verifique se o aplicativo de função está sendo executado na versão mais recente do tempo de execução do Functions (versão 4.x). Você pode determinar a versão de tempo de execução no portal do Azure ou usando a CLI do Azure.
Use estas etapas para determinar sua versão de tempo de execução do Functions:
No portal do Azure, localize seu aplicativo de função e selecione Configuração no lado esquerdo em Configurações.
Selecione a guia Configurações de tempo de execução da função e verifique o valor da versão do tempo de execução para ver se seu aplicativo de função está sendo executado na versão 4.x do tempo de execução do Functions (
~4).
Se você precisar primeiro atualizar seu aplicativo de função para a versão 4.x, consulte 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. Você deve seguir as instruções nesses artigos em vez de apenas alterar a FUNCTIONS_EXTENSION_VERSION configuração.
Publicar atualizações de aplicativos
Se você atualizou seu aplicativo para ser executado corretamente na nova versão, publique as atualizações do aplicativo antes de atualizar a configuração de pilha para seu aplicativo de função.
Gorjeta
Para simplificar o processo de atualização, minimizar o tempo de inatividade de suas funções e fornecer um potencial de reversão, você deve publicar seu aplicativo atualizado em um slot de preparação. Para obter mais informações, consulte Slots de implantação do Azure Functions.
Ao publicar seu aplicativo atualizado em um slot de preparação, siga as instruções de atualização específicas do slot no restante deste artigo. Mais tarde, você troca o slot de preparo atualizado para a produção.
Atualizar a configuração da pilha
A maneira como você atualiza a configuração da pilha depende se você está executando 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 seguintes etapas para atualizar a versão do Java:
No portal do Azure, localize seu aplicativo de função e selecione Configuração no lado esquerdo. Ao usar um slot de preparação, certifique-se de selecionar primeiro o slot específico.
Na guia Configurações gerais, atualize a versão do Java para a versão desejada.
Selecione Salvar e, quando notificado sobre uma reinicialização, selecione Continuar.
Use as seguintes etapas para atualizar a versão do .NET:
No portal do Azure, localize seu aplicativo de função e selecione Configuração no lado esquerdo. Ao usar um slot de preparação, certifique-se de selecionar primeiro o slot específico.
Na guia Configurações gerais, atualize a versão do .NET para a versão desejada.
Selecione Salvar e, quando notificado sobre uma reinicialização, selecione Continuar.
Use as seguintes etapas para atualizar a versão Node.js:
No portal do Azure, localize seu aplicativo de função e selecione Configuração no lado esquerdo. Ao usar um slot de preparação, certifique-se de selecionar primeiro o slot específico.
Na guia Configurações gerais, atualize Node.js versão para a versão desejada.
Selecione Salvar e, quando notificado sobre uma reinicialização, selecione Continuar. Essa alteração atualiza a configuração do
WEBSITE_NODE_DEFAULT_VERSIONaplicativo.
Use as seguintes etapas para atualizar a versão do PowerShell:
No portal do Azure, localize seu aplicativo de função e selecione Configuração no lado esquerdo. Ao usar um slot de preparação, certifique-se de selecionar primeiro o slot específico.
Na guia Configurações gerais, atualize a versão do .NET para a versão desejada.
Selecione Salvar e, quando notificado sobre uma reinicialização, selecione Continuar.
Os aplicativos Python não são suportados no Windows. Selecione a guia Linux em vez disso.
Seu aplicativo de função é reiniciado depois que você atualiza a versão.
Trocar slots
Se você estiver executando a implantação do projeto de código e atualizando as configurações em um slot de preparação, finalmente precisará trocar o slot de preparo para a produção. Para obter mais informações, consulte Trocar slots.