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.

Nota

Este artigo mostra como atualizar a versão .NET de um aplicativo usando o modelo de trabalho isolado. Os aplicativos executados em versões mais antigas do .NET com o modelo em processo podem ser atualizados para o .NET 8 de destino ou podem migrar do modelo em processo para o modelo de trabalho isolado.

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:

1. Certifique-se de ter instalado a versão de destino do SDK do .NET.

   Se você estiver visando uma versão de visualização, consulte as diretrizes de funções para versões de visualização do .NET para garantir que a versão seja suportada. Etapas adicionais podem ser necessárias para visualizações do .NET.

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 seu projeto para a nova versão. Para projetos C#, você deve atualizar o <TargetFramework> .csproj elemento no arquivo. Consulte Estruturas de destino para obter informações específicas relacionadas à versão escolhida.

   Alterar a estrutura de destino do seu projeto também pode exigir alterações em partes da sua cadeia de ferramentas, fora do código do projeto. Por exemplo, no VS Code, talvez seja necessário atualizar a configuração da azureFunctions.deploySubpath extensão por meio das configurações do usuário ou do .vscode/settings.json arquivo do seu projeto. Verifique se há dependências na versão da estrutura que possam existir fora do código do projeto, como parte das etapas de compilação ou de um pipeline de CI/CD.

4. 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.

Portal do Azure

Use estas etapas para determinar sua versão de tempo de execução do Functions:

1. No portal do Azure, localize seu aplicativo de função e selecione Configuração no lado esquerdo em Configurações.

2. 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).

   

CLI do Azure

Use este az functionapp config appsettings list comando para verificar sua versão de tempo de execução:

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

A FUNCTIONS_EXTENSION_VERSION configuração define a versão do tempo de execução. Um valor significa que seu aplicativo de ~4 função já está sendo executado na versão secundária mais recente da versão principal mais recente (4.x).

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.

Windows

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

1. 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.

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

   

3. Selecione Salvar e, quando notificado sobre uma reinicialização, selecione Continuar.

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

1. 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.

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

   

3. Selecione Salvar e, quando notificado sobre uma reinicialização, selecione Continuar.

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

1. 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.

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

   

3. Selecione Salvar e, quando notificado sobre uma reinicialização, selecione Continuar. Essa alteração atualiza a configuração do WEBSITE_NODE_DEFAULT_VERSION aplicativo.

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

1. 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.

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

   

3. 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.

Linux

Nota

Você só pode usar o portal do Azure para atualizar aplicativos de função no Linux hospedados em um plano Premium ou um plano Dedicado (Serviço de Aplicativo). Para aplicativos no Linux hospedados em um plano de Consumo, você deve usar a CLI do Azure.

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

1. 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.

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

   

3. Selecione Salvar e, quando notificado sobre uma reinicialização, selecione Continuar.

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

1. 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.

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

   

3. Selecione Salvar e, quando notificado sobre uma reinicialização, selecione Continuar.

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

1. 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.

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

   

3. Selecione Salvar e, quando notificado sobre uma reinicialização, selecione Continuar. Essa alteração atualiza a configuração do WEBSITE_NODE_DEFAULT_VERSION aplicativo.

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

1. 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.

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

   

3. 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.

1. 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.

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

   

   Nota

   Não é possível alterar a versão do Python ao executar em um plano de consumo.

3. Selecione Salvar e, quando notificado sobre uma reinicialização, selecione Continuar.

Windows

Os aplicativos Python não são suportados no Windows. Selecione a guia Linux em vez disso.

Primeiro, use o az functionapp list-runtimes comando para exibir os valores de versão suportados para seu idioma. Em seguida, execute o az functionapp config set comando para atualizar a versão de idioma do seu aplicativo de função:

Execute o az functionapp list-runtimes comando para exibir os valores de versão suportados para .NET no modelo de trabalho isolado:

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

Execute o az functionapp config set comando para atualizar a versão .NET do seu aplicativo de função:

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

Primeiro, use o az functionapp list-runtimes comando para exibir os valores de versão suportados para sua pilha de idiomas (Node.js). Em seguida, execute o az functionapp config set comando para atualizar a versão Node.js do seu aplicativo de função:

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"  

Neste exemplo, substitua <APP_NAME> e <RESOURCE_GROUP> pelo nome do seu aplicativo de função e grupo de recursos, respectivamente. Substitua <VERSION> também pela versão do idioma suportado para a qual você está atualizando. Se você não estiver usando um slot de preparo, remova o --slot parâmetro.

Linux

Nota

Não é possível alterar a versão do Python ao executar em um plano de consumo.

Execute o az functionapp list-runtimes comando para visualizar a configuração do site suportado linuxFxVersion para sua versão de idioma:

Execute o az functionapp list-runtimes comando para exibir a configuração do site suportado linuxFxVersion para sua versão da pilha de idiomas:

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

Execute o az functionapp config set comando para atualizar a configuração do site para a nova versão de idioma do seu aplicativo de função:

Execute o az functionapp config set comando para atualizar a configuração do site para a nova versão de pilha do seu aplicativo de função:

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

Neste exemplo, substitua <APP_NAME> e <RESOURCE_GROUP> pelo nome do seu aplicativo de função e grupo de recursos, respectivamente. Substitua <LANGUAGE|VERSION> também pelo para a linuxFxVersion sua atualização. Se você não estiver usando um slot de preparo, remova o --slot parâmetro.

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.

Próximos passos

Guia do desenvolvedor Java

Guia do processo de trabalho isolado em C#

Node.js guia do desenvolvedor

Guia do desenvolvedor Python

Guia do desenvolvedor do PowerShell