Aktualisieren der Durable Functions Erweiterungsversion

Wenn bei Ihnen Orchestrierungsfehler, langsame Wiedergabe oder unerwartetes Verhalten auftreten, ist das Aktualisieren der Durable Functions Erweiterung der empfohlene erste Schritt. Neue Versionen enthalten häufig wichtige Fehlerkorrekturen und Leistungsverbesserungen. Um über neue Versionen benachrichtigt zu werden, Releases beobachten auf GitHub.

Wählen Sie die Upgrademethode aus, die Ihrem App-Typ entspricht:

App-Typ Upgrademethode
.NET (prozessintern oder isoliert) Verweisen auf die neuesten NuGet-Pakete
Nicht .NET (JavaScript, Python, Java, PowerShell) Upgrade des Erweiterungspakets
Erweiterte/ zeitkritische Korrektur erforderlich Manuelles Upgrade der Erweiterung

Verweisen Auf die neuesten NuGet-Pakete für .NET-Apps

Aktualisieren Sie den Durable Functions NuGet-Paketverweis in Ihrem Projekt. Das richtige Paket hängt von Ihrem Hostingmodell und Speicheranbieter ab:

Speicheranbieter In-Prozess-Arbeiter Eingeschlossener Mitarbeiter
Azure Storage (Standardwert) 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

Um beispielsweise die Standarderweiterung Azure Storage in einer isolierten Worker-App zu aktualisieren:

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

Upgrade des Erweiterungspakets

Nicht .NET-Apps (JavaScript, Python, Java, PowerShell) verwenden Extension-Bündel für den Zugriff auf Trigger und Bindungen, einschließlich der Durable Functions-Erweiterung. Stellen Sie sicher, dass der Versionsbereich extensionBundle in Ihrem host.json die neueste Bundle-Version enthält:

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

Aktualisieren Sie den Versionsbereich bei Bedarf, und stellen Sie ihre App erneut zur Verfügung.

Manuelles Upgrade der Durable Functions Erweiterungsversion

Wenn das Upgrade des Erweiterungspakets Ihr Problem nicht behoben hat und eine neuere Durable Functions Erweiterungsversion einen Fix enthält, den Sie benötigen, können Sie eine bestimmte Erweiterungsversion manuell installieren.

Caution

Das manuelle Verwalten von Erweiterungen bedeutet, dass automatische Updates von Erweiterungspaketen verloren gehen und möglicherweise Kompatibilitätsprobleme zwischen Erweiterungen auftreten. Verwenden Sie diesen Ansatz nur für zeitkritische Fixes.

  1. Entfernen Sie den extensionBundle Abschnitt aus Ihrer host.json Datei.

  2. Installieren Sie die .NET CLI, wenn sie noch nicht vorhanden ist.

  3. Installieren Sie Erweiterungen. Führen Sie Folgendes aus, um alle erweiterungen zu installieren, die von Erweiterungspaketen unterstützt werden:

    func extensions install
    

    Um nur die Durable Functions-Erweiterung in einer bestimmten Version zu installieren, führen Sie Folgendes aus:

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

    Ersetzen Sie <version> durch die Zielversion auf der Seite releases.

Nächste Schritte