Compartilhar via


Atualização da versão de extensão das Durable Functions

Muitos problemas que os usuários enfrentam com as Durable Functions podem ser resolvidos simplesmente atualizando para a versão mais recente da extensão, que geralmente contém correções de bugs importantes e melhorias de desempenho. Você pode seguir as instruções neste artigo para obter a versão mais recente da extensão Durable Functions.

As alterações na extensão podem ser encontradas na Página de versões do repositório Azure/azure-functions-durable-extension. Você também pode configurar para receber notificações sempre que houver uma nova versão da extensão acessando a Página de versões, clicando em Inspeção e, em seguida, em Monitorar e, por fim, selecionando o filtro Versões :

Screenshot of step 1 to set up release notifications.

Screenshot of step 2 to set up release notifications.

Referenciar os pacotes NuGet mais recentes (somente aplicativos .NET)

Os aplicativos .NET podem obter a versão mais recente da extensão Durable Functions fazendo referência ao pacote NuGet mais recente:

Se você estiver usando os provedores de armazenamento Netherite ou MSSQL (em vez do Armazenamento do Azure), precisará fazer referência a um dos seguintes:

Atualizar o pacote de extensão

Os pacotes de extensão fornecem uma maneira fácil e prática para aplicativos de funções que não são .NET para referenciar e usar vários gatilhos e associações do Azure Functions. Por exemplo, se você precisar enviar uma mensagem aos Hubs de Eventos sempre que sua função for disparada, poderá usar a extensão Hubs de Eventos para obter acesso às associações dos Hubs de Eventos. A extensão Durable Functions também está incluída em cada versão dos pacotes de extensão. Os pacotes de extensão são configurados automaticamente em host.json ao criar um aplicativo de funções usando qualquer uma das ferramentas de desenvolvimento compatíveis.

A maioria dos aplicativos que não são .NET dependem de pacotes de extensão para obter acesso a vários gatilhos e associações. Geralmente, a versão mais recente do pacote, contém a versão mais recente da extensão Durable Functions com correções críticas de bugs e melhorias de desempenho. Portanto, é importante que seu aplicativo use a versão mais recente dos pacotes de extensão. Você pode verificar seu arquivo host.json para saber se o intervalo de versão que você está usando inclui a versão mais recente do pacote de extensão.

Atualizar manualmente a extensão Durable Functions

Se a atualização do pacote de extensão não resolveu seu problema e você notou que existe uma versão mais recente da extensão Durable Functions que contém uma possível correção para o problema, você poderá tentar atualizar manualmente a extensão. Observe que isso se destina apenas a cenários avançados ou quando correções urgentes são necessárias, pois há muitas desvantagens no gerenciamento manual das extensões. Por exemplo, talvez seja necessário lidar com erros do .NET quando as extensões usadas forem incompatíveis entre si. Você também precisa atualizar manualmente as extensões para obter as correções e patches mais recentes, em vez de obtê-las automaticamente por meio do pacote de extensão.

Primeiro, remova a seção extensionBundle do arquivo host.json.

Instale a CLI dotnet se você ainda não a tiver. Você pode obtê-la nesta página.

Como os aplicativos normalmente usam mais de uma extensão, é recomendável executar o seguinte para instalar manualmente todas as versões mais recentes de todas as extensões compatíveis com os pacotes de extensão:

func extensions install

No entanto, se você deseja 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