Upgrade der Durable Functions-Erweiterungsversion

Viele Probleme, die Benutzer*innen mit Durable Functions haben, können einfach durch ein Upgrade auf die neueste Version der Erweiterung behoben werden, die häufig wichtige Fehlerbehebungen und Leistungsverbesserungen enthält. Befolgen Sie die Anweisungen in diesem Artikel, um die neueste Version der Durable Functions-Erweiterung zu erhalten.

Änderungen an der Erweiterung finden Sie auf der Seite Release des Repositorys Azure/azure-functions-durable-extension. Sie können auch Benachrichtigungen konfigurieren, um informiert zu werden, wenn ein neues Erweiterungsrelease verfügbar ist. Navigieren Sie dazu zur Seite Releases, wählen Sie Überwachen, anschließend Benutzerdefiniert und dann den Filter Releases aus:

Verweisen auf die neuesten NuGet-Pakete (nur .NET-Apps)

Für .NET-Apps erhalten die neueste Version der Durable Functions-Erweiterung, indem sie auf das neueste NuGet-Paket verweisen:

• .NET-In-Process-Worker
• Isolierter .NET-Worker

Wenn Sie die Speicheranbieter Netherite oder MSSQL (anstelle von Azure Storage) verwenden, müssen Sie auf Folgendes verweisen:

• Netherite, In-Process-Worker
• Netherite, isolierter Worker
• MSSQL, In-Process-Worker
• MSSQL, isolierter Worker

Upgraden des Erweiterungspakets

Erweiterungspakete stellen eine einfache und bequeme Möglichkeit für andere Funktions-Apps als .NET dar, um auf verschiedene Azure Functions-Trigger und -Bindungen zu verweisen und diese zu verwenden. Wenn Sie beispielsweise bei jeder Auslösung Ihrer Funktion eine Nachricht an Event Hubs senden müssen, können Sie die Event Hubs-Erweiterung verwenden, um Zugriff auf Event Hubs-Bindungen zu erhalten. Die Durable Functions-Erweiterung ist in jeder Version der Erweiterungspakete enthalten. Erweiterungspakete werden automatisch in „host.json“ konfiguriert, wenn Sie eine Funktions-App mit einem der unterstützten Entwicklungstools erstellen.

Die meisten Nicht-.NET-Anwendungen nutzen Erweiterungspakete, um Zugriff auf verschiedene Trigger und Bindungen zu erhalten. Das neueste Bundlerelease enthält häufig die neueste Version der Durable Functions-Erweiterung mit kritischen Fehlerbehebungen und Leistungsverbesserungen. Daher ist es wichtig, dass Ihre App die neueste Version der Erweiterungspakete verwendet. Sie können in der Datei „host.json“ überprüfen, ob der verwendete Versionsbereich die neueste Version des Erweiterungspakets umfasst.

Manuelles Upgraden der Durable Functions-Erweiterung

Wenn das Problem nicht durch ein Upgrade des Erweiterungspakets behoben wurde und Sie eine neuere Version der Durable Functions-Erweiterung mit einer potenziellen Problembehebung gefunden haben, können Sie versuchen, manuell ein Upgrade der Erweiterung durchzuführen. Beachten Sie, dass dies nur für fortgeschrittene Szenarien vorgesehen ist oder wenn zeitkritische Fixes erforderlich sind, da die manuelle Verwaltung von Erweiterungen viele Nachteile mit sich bringt. Beispielsweise können .NET-Fehler auftreten, wenn die von Ihnen verwendeten Erweiterungen nicht miteinander kompatibel sind. Sie müssen Erweiterungen eventuell auch manuell aktualisieren, um die neuesten Fixes und Patches zu erhalten, wenn sie diese nicht automatisch über das Erweiterungspaket erhalten.

Entfernen Sie zunächst den Abschnitt extensionBundle aus der Datei „host.json“.

Installieren Sie die dotnet CLI, wenn diese noch nicht vorhanden ist. Sie können sie auf dieser Seite abrufen.

Da Anwendungen normalerweise mehr als eine Erweiterung verwenden, empfiehlt es sich, Folgendes auszuführen, um alle aktuellen Versionen sämtlicher von Erweiterungspaketen unterstützten Erweiterungen manuell zu installieren:

func extensions install

Wenn Sie jedoch nur das neueste Durable Functions-Erweiterungsrelease installieren möchten, führen Sie den folgenden Befehl aus:

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

Beispiel:

func extensions install -p Microsoft.Azure.WebJobs.Extensions.DurableTask -v 2.9.1