Como definir as versões do runtime das Funções do Azure

Um aplicativo de função é executado em uma versão específica do tempo de execução do Funções do Azure. Por padrão, as aplicações de funções são criadas na versão mais recente 4.x do runtime de funções. As suas aplicações funcionais são suportadas apenas quando são executadas numa versão principal suportada. Este artigo explica como configurar uma aplicação de funções no Azure para direcionar, ou fixar a uma versão específica do runtime das Funções, quando necessário.

Considerações

Tenha estas considerações em mente ao considerar uma versão específica de tempo de execução:

• O plano Flex Consumption apenas é compatível com a versão 4.x do runtime. Como o plano Flex Consumption não suporta a FUNCTIONS_EXTENSION_VERSION definição da aplicação, a sua aplicação não pode direcionar uma versão de execução específica ao correr neste plano.
• A maneira como você segmenta uma versão específica depende se você está executando o Windows ou Linux.
• Este artigo é específico para Windows ou Linux. Escolha o seu sistema operativo na parte superior do artigo.
• Quando possível, execute sempre a sua aplicação na versão de execução mais recente suportada. Fixe a sua aplicação numa versão específica apenas se for instruído a fazê-lo devido a um problema com a versão mais recente. Sempre mude para a versão de tempo de execução mais recente assim que suas funções puderem ser executadas corretamente.
• Durante o desenvolvimento local, sua versão instalada das Ferramentas Principais do Funções do Azure deve corresponder à versão principal do tempo de execução usada pelo aplicativo de função no Azure. Para obter mais informações, consulte Versões das ferramentas principais.

Atualize a sua versão do runtime

Quando possível, execute sempre as suas aplicações de funções na versão mais recente suportada do runtime Funções do Azure. Se a sua aplicação de funções estiver atualmente a correr numa versão mais antiga do runtime, migre a sua aplicação para a versão 4.x.

Quando seu aplicativo tiver funções existentes, você deve tomar precauções antes de passar para uma versão de tempo de execução principal posterior. Os artigos a seguir detalham as alterações de quebra entre as versões principais, incluindo alterações de quebra específicas do idioma. Eles também fornecem instruções passo a passo para uma migração bem-sucedida do seu aplicativo de função existente.

• Migrar da versão runtime 3.x para a versão 4.x
• Migrar da versão runtime 1.x para a versão 4.x

Para determinar sua versão atual do tempo de execução, consulte Exibir a versão atual do tempo de execução.

Ver a versão atual do runtime

Você pode exibir a versão atual do tempo de execução do seu aplicativo de função de uma destas maneiras:

az functionapp config appsettings list --name <function_app> \
--resource-group <my_resource_group>

[
  {
    "name": "FUNCTIONS_EXTENSION_VERSION",
    "slotSetting": false,
    "value": "~4"
  },
  {
    "name": "FUNCTIONS_WORKER_RUNTIME",
    "slotSetting": false,
    "value": "dotnet"
  },
  
  ...
]

Get-AzFunctionAppSetting -Name "<FUNCTION_APP>" -ResourceGroupName "<RESOURCE_GROUP>"

Fixar em uma versão específica

O Funções do Azure permite utilizar a definição da aplicação FUNCTIONS_EXTENSION_VERSION para especificar a versão do runtime utilizada por uma determinada aplicação de funções. Se especificar apenas a versão principal (~4), a aplicação de funções atualiza-se automaticamente para novas versões menores do runtime à medida que estas ficam disponíveis. As atualizações de versões menores são automáticas porque as novas versões menores dificilmente vão introduzir alterações que quebrem as suas funções.

Fixar numa versão específica em tempo de execução reinicia a tua aplicação de funções.

az functionapp config appsettings set --name <FUNCTION_APP> \
--resource-group <RESOURCE_GROUP> \
--settings FUNCTIONS_EXTENSION_VERSION=<VERSION>

Update-AzFunctionAppSetting -Name "<FUNCTION_APP>" -ResourceGroupName "<RESOURCE_GROUP>" -AppSetting @{"FUNCTIONS_EXTENSION_VERSION" = "<VERSION>"} -Force

Próximos passos