Atualizar a versão da extensão Durable Functions

Se você estiver enfrentando falhas de orquestração, reprodução lenta ou comportamento inesperado, atualizar a extensão Durable Functions será a primeira etapa recomendada. As novas versões geralmente contêm correções de bug críticas e melhorias de desempenho. Para ser notificado sobre novas versões, watch releases no GitHub.

Escolha o método de atualização que corresponde ao tipo de aplicativo:

Tipo de aplicativo Método de atualização
.NET (em processo ou isolado) Referenciar os pacotes NuGet mais recentes
Não .NET (JavaScript, Python, Java, PowerShell) Atualizar o pacote de extensão
Correção avançada/urgente necessária Atualizar manualmente a extensão

Referenciar os pacotes NuGet mais recentes para aplicativos .NET

Atualize a referência do pacote NuGet do Durable Functions em seu projeto. O pacote correto depende do modelo de hospedagem e do provedor de armazenamento:

Provedor de armazenamento Trabalhador em processo Trabalhador isolado
Armazenamento do Azure (padrão) Microsoft.Azure. WebJobs.Extensions.DurableTask Microsoft.Azure.Functions.Worker.Extensions.DurableTask
Netherite Microsoft.Azure. DurableTask.Netherite.AzureFunctions Microsoft.Azure. Functions.Worker.Extensions.DurableTask.Netherite
MSSQL Microsoft. DurableTask.SqlServer.AzureFunctions Microsoft.Azure. Functions.Worker.Extensions.DurableTask.SqlServer

Por exemplo, para atualizar a extensão de Armazenamento do Azure padrão em um aplicativo de trabalho isolado:

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.DurableTask

Atualizar o pacote de extensão

Aplicativos não .NET (JavaScript, Python, Java, PowerShell) usam extension bundles para acessar gatilhos e associações, incluindo a extensão Durable Functions. Verifique se o intervalo de versão extensionBundle em seu host.json inclui a versão do pacote mais recente:

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.*, 5.0.0)"
  }
}

Atualize o intervalo de versão, se necessário, e reimplante seu aplicativo.

Atualizar manualmente a versão da extensão Durable Functions

Se a atualização do pacote de extensão não resolver o problema e uma versão de extensão mais recente Durable Functions contiver uma correção necessária, você poderá instalar manualmente uma versão de extensão específica.

Caution

Gerenciar manualmente extensões significa que você perde atualizações automáticas de pacotes de extensão e pode encontrar problemas de compatibilidade entre extensões. Use essa abordagem apenas para correções sensíveis ao tempo.

  1. Remova a extensionBundle seção do host.json arquivo.

  2. Instale a CLI .NET se ainda não o tiver.

  3. Instalar extensões. Para instalar todas as extensões com suporte por pacotes de extensão, execute:

    func extensions install
    

    Para instalar apenas a extensão Durable Functions em uma versão específica, execute:

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

    Substitua <version> pela versão alvo na página de lançamentos.

Próximas Etapas