Atualizar a versão de extensão do Durable Functions

Muitos problemas que os usuários experimentam com o Durable Functions podem ser resolvidos simplesmente atualizando para a versão mais recente da extensão, que geralmente contém correções de bug 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 lançamentos do Azure/azure-functions-durable-extension repositório. Você também pode configurar para receber notificações sempre que houver uma nova versão de extensão acessando a página Versões, clicando em Inspeção e, em seguida, em Personalizado e, por fim, selecionando o filtro Versões :

Referencie 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:

• Trabalho em processo do .NET
• Trabalhador isolado do .NET

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:

• Netherite, trabalho em processo
• Netherite, trabalhador isolado
• MSSQL, trabalho em processo
• MSSQL, trabalhador isolado

Atualizar o pacote de extensão

Os pacotes de extensão fornecem uma maneira fácil e conveniente para aplicativos de Funções não-.NET referenciar e usar diferentes gatilhos e associações das Funções do Azure. Por exemplo, se você precisar enviar uma mensagem aos Hubs de Eventos sempre que sua função for disparada, você 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 com suporte.

A maioria dos aplicativos non-.NET dependem de pacotes de extensão para obter acesso a vários gatilhos e associações. A versão mais recente do pacote geralmente contém a versão mais recente da extensão Durable Functions com correções de bug críticas 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 ver se o intervalo de versões 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 o problema e você notou uma versão mais recente da extensão Durable Functions contendo uma possível correção para o problema, então você poderá tentar atualizar manualmente a extensão em si. Observe que isso se destina apenas a cenários avançados ou quando correções sensíveis ao tempo são necessárias, pois há muitas desvantagens para gerenciar manualmente as 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 extensionBundle seção do arquivo host.json.

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

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

func extensions install

No entanto, se você quiser instalar apenas a versão de extensão mais recente do Durable Functions, executará 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