Atualizar Durable Functions versão da extensão

Muitos problemas que os utilizadores experimentam com Durable Functions podem ser resolvidos simplesmente ao atualizar para a versão mais recente da extensão, que muitas vezes contém correções de erros importantes e melhorias de desempenho. Pode seguir as instruções neste artigo para obter a versão mais recente da extensão Durable Functions.

As alterações à extensão podem ser encontradas na página Versão do Azure/azure-functions-durable-extension repositório. Também pode configurar para receber notificações sempre que existir uma nova versão da extensão ao aceder à página Versões, clicar em Ver e, em seguida, em Personalizado e, por fim, selecionar o filtro Versões :

Captura de ecrã do passo 1 para configurar as notificações de lançamento.

Captura de ecrã do passo 2 para configurar as notificações de lançamento.

Referenciar os pacotes NuGet mais recentes (apenas aplicações.NET)

As aplicações .NET podem obter a versão mais recente da extensão Durable Functions ao referenciar o pacote NuGet mais recente:

Se estiver a utilizar os fornecedores de armazenamento Netherite ou MSSQL (em vez do Armazenamento do Azure), tem de referenciar um dos seguintes:

Atualizar o pacote de extensões

Os pacotes de extensões fornecem uma forma fácil e conveniente de non-.NET aplicações de funções para referenciar e utilizar vários acionadores e enlaces da Função do Azure. Por exemplo, se precisar de enviar uma mensagem para os Hubs de Eventos sempre que a sua função for acionada, pode utilizar a extensão dos Hubs de Eventos para obter acesso aos enlaces dos Hubs de Eventos. A extensão Durable Functions também está incluída em cada versão dos pacotes de extensões. Os pacotes de extensões são configurados automaticamente em host.json ao criar uma aplicação de funções com qualquer uma das ferramentas de desenvolvimento suportadas.

A maioria das aplicações non-.NET dependem de pacotes de extensões para obter acesso a vários acionadores e enlaces. A versão mais recente do pacote contém frequentemente a versão mais recente da extensão Durable Functions com correções de erros críticas e melhorias de desempenho. Por conseguinte, é importante que a sua aplicação utilize a versão mais recente dos pacotes de extensões. Pode verificar o ficheiro host.json para ver se o intervalo de versões que está a utilizar inclui a versão mais recente do pacote de extensões.

Atualizar manualmente a extensão Durable Functions

Se a atualização do pacote de extensão não resolveu o problema e reparou numa versão mais recente da extensão Durable Functions que contém uma possível correção para o problema, poderá tentar atualizar manualmente a extensão. Tenha em atenção que isto se destina apenas a cenários avançados ou quando são necessárias correções sensíveis ao tempo, uma vez que existem muitas desvantagens na gestão manual de extensões. Por exemplo, poderá ter de lidar com erros .NET quando as extensões que utiliza são incompatíveis entre si. Também tem de atualizar manualmente as extensões para obter as correções e patches mais recentes em vez de as obter automaticamente através do pacote de extensões.

Primeiro, remova a extensionBundle secção do ficheiro host.json.

Instale a dotnet CLI se ainda não a tiver. Pode obtê-la a partir desta página.

Uma vez que as aplicações utilizam normalmente mais do que uma extensão, recomenda-se que execute o seguinte para instalar manualmente todas as versões mais recentes de todas as extensões suportadas pelos Pacotes de Extensões:

func extensions install

No entanto, se quiser instalar apenas a versão mais recente da extensão Durable Functions, execute o seguinte comando:

func extensions install -p Microsoft.Azure.WebJobs.Extensions.DurableTask -v <version>

Por exemplo:

func extensions install -p Microsoft.Azure.WebJobs.Extensions.DurableTask -v 2.9.1