Mettre à niveau la version de l’extension Durable Functions

Si vous rencontrez des échecs d'orchestration, une relecture lente ou un comportement inattendu, la mise à niveau de l'extension Durable Functions est la première étape recommandée. Les nouvelles versions contiennent souvent des correctifs de bogues critiques et des améliorations des performances. Pour être informé des nouvelles versions, surveillez les versions sur GitHub.

Choisissez la méthode de mise à niveau qui correspond à votre type d’application :

Type d’application Méthode de mise à niveau
.NET (interne ou isolé) Référencer les derniers packages NuGet
Non-.NET (JavaScript, Python, Java, PowerShell) Mettre à niveau le bundle d’extensions
Correctif avancé/urgent nécessaire Mettre à niveau manuellement l’extension

Référencer les derniers packages NuGet pour les applications .NET

Mettez à jour la référence de package NuGet Durable Functions dans votre projet. Le package approprié dépend de votre modèle d’hébergement et de votre fournisseur de stockage :

Fournisseur de stockage Travailleur en cours de traitement Travailleur isolé
stockage Azure (valeur par défaut) 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

Par exemple, pour mettre à niveau l’extension de stockage Azure par défaut dans une application worker isolée :

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

Mettre à niveau le bundle d’extensions

Les applications non .NET (JavaScript, Python, Java, PowerShell) utilisent des bundles d'extensions extension pour accéder aux déclencheurs et aux liaisons, y compris l'extension Durable Functions. Vérifiez que la plage de versions extensionBundle de votre host.json inclut la version du bundle latest :

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

Mettez à jour la plage de versions si nécessaire, puis redéployez votre application.

Mettre à niveau manuellement la version de l’extension Durable Functions

Si la mise à niveau de l'offre groupée d'extensions n'a pas résolu votre problème et qu'une version plus récente de l'extension Durable Functions contient un correctif dont vous avez besoin, vous pouvez installer manuellement une version d'extension spécifique.

Avertissement

La gestion manuelle des extensions signifie que vous perdez les mises à jour automatiques des bundles d’extensions et peut rencontrer des problèmes de compatibilité entre les extensions. Utilisez cette approche uniquement pour les correctifs sensibles au temps.

  1. Supprimez la extensionBundle section de votre host.json fichier.

  2. Installez le .NET CLI si vous ne l'avez pas déjà.

  3. Installez des extensions. Pour installer toutes les extensions prises en charge par les bundles d’extensions, exécutez :

    func extensions install
    

    Pour installer uniquement l’extension Durable Functions à une version spécifique, exécutez :

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

    Remplacez <version> par la version cible de la page releases.

Étapes suivantes