Uaktualnianie wersji rozszerzenia Durable Functions

Ważna

Wsparcie dla modelu w toku zakończy się 10 listopada 2026 r. Zdecydowanie zalecamy przeprowadzenie migracji aplikacji do izolowanego modelu roboczego w celu uzyskania pełnej obsługi.

Jeśli występują błędy orkiestracji, powolne odtwarzanie lub nieoczekiwane zachowanie, uaktualnienie rozszerzenia Durable Functions jest zalecanym pierwszym krokiem. Nowe wersje często zawierają krytyczne poprawki błędów i ulepszenia wydajności. Aby otrzymywać powiadomienia o nowych wersjach, obserwuj wersje na GitHub.

Wybierz metodę uaktualniania zgodną z typem aplikacji:

Typ aplikacji Metoda uaktualniania
.NET (wewnątrzprocesowe albo izolowane) Odwołuj się do najnowszych pakietów NuGet
Inne niż .NET (JavaScript, Python, Java, PowerShell) Uaktualnianie pakietu rozszerzeń
Wymagana poprawka zaawansowana/wrażliwa na czas Ręczne uaktualnianie rozszerzenia

Odwołaj się do najnowszych pakietów NuGet dla aplikacji .NET

Zaktualizuj referencję pakietu NuGet Durable Functions w projekcie. Prawidłowy pakiet zależy od modelu hostingu i dostawcy magazynu:

Dostawca magazynu Pracownik w procesie Izolowany pracownik
Azure Storage (ustawienie domyślne) 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

Aby na przykład zaktualizować domyślne rozszerzenie Azure Storage w izolowanej aplikacji procesów roboczych:

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

Uaktualnianie pakietu rozszerzeń

Aplikacje inne niż .NET (JavaScript, Python, Java, PowerShell) używają pakietów extension w celu uzyskiwania dostępu do wyzwalaczy i powiązań, w tym rozszerzenia Durable Functions. Sprawdź, czy zakres wersji extensionBundle w host.json zawiera najnowsze wydanie pakietu:

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

W razie potrzeby zaktualizuj zakres wersji, a następnie ponownie wdróż aplikację.

Ręczne uaktualnianie wersji rozszerzenia Durable Functions

Jeśli uaktualnienie pakietu rozszerzeń nie rozwiązało problemu, a nowsza wersja rozszerzenia Durable Functions zawiera niezbędną poprawkę, możesz ręcznie zainstalować określoną wersję rozszerzenia.

Caution

Ręczne zarządzanie rozszerzeniami oznacza utratę automatycznych aktualizacji z pakietów rozszerzeń i może napotkać problemy ze zgodnością między rozszerzeniami. Tej metody należy używać tylko w przypadku czasowo krytycznych poprawek.

  1. Usuń sekcję extensionBundle z host.json pliku.

  2. Zainstaluj .NET CLI, jeśli jeszcze go nie masz.

  3. Instalowanie rozszerzeń. Aby zainstalować wszystkie rozszerzenia obsługiwane przez pakiety rozszerzeń, uruchom polecenie:

    func extensions install

    Aby zainstalować tylko rozszerzenie Durable Functions w określonej wersji, uruchom polecenie:

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

    Zastąp <version> wersją docelową ze strony releases.

Następne kroki

  • Last updated on