Partilhar via


Versão da extensão Upgrade Durable Functions

Muitos problemas que os usuários experimentam com funções duráveis 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.

Alterações na extensão podem ser encontradas na página Release do Azure/azure-functions-durable-extension repo. Você também pode configurar para receber notificações sempre que houver uma nova versão de extensão, indo para a página Releases, clicando em Watch, depois em Custom e, finalmente, selecionando o filtro Releases :

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

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

Fazer referência aos 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ões

Os pacotes de extensão fornecem uma maneira fácil e conveniente para non-.NET aplicativos de função fazerem referência e usarem vários gatilhos e associações do Azure Function. Por exemplo, se você precisar enviar uma mensagem para Hubs de Eventos toda vez que sua função for acionada, poderá usar a extensão Hubs de Eventos para obter acesso às associações de 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ção usando qualquer uma das ferramentas de desenvolvimento suportadas.

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 bugs críticos e melhorias de desempenho. Portanto, é importante que seu aplicativo use a versão mais recente dos pacotes de extensões. Você pode verificar seu arquivo de 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ões não resolver o problema e você notar uma versão mais recente da extensão Durable Functions contendo uma possível correção para o problema, então você pode tentar atualizar manualmente a própria extensão. 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 no gerenciamento manual de extensões. Por exemplo, você pode ter que lidar com erros .NET quando as extensões que você usa são 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ê-los automaticamente através do pacote de extensões.

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

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

Como os aplicativos normalmente usam mais de uma extensão, é recomendável executar o seguinte para instalar manualmente toda a versão mais recente de todas as extensões suportadas pelos Extension Bundles:

func extensions install

No entanto, se você deseja instalar apenas a versão mais recente da extensão Durable Functions, você deve 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