Aggiornare la versione dell'estensione Durable Functions

Se si verificano errori di orchestrazione, riproduzione lenta o comportamento imprevisto, l'aggiornamento dell'estensione Durable Functions è il primo passaggio consigliato. Le nuove versioni contengono spesso correzioni di bug critiche e miglioramenti delle prestazioni. Per ricevere una notifica delle nuove versioni, watch release in GitHub.

Scegliere il metodo di aggiornamento corrispondente al tipo di app:

Tipo di app Metodo di aggiornamento
.NET (in-process o isolato) Fare riferimento ai pacchetti NuGet più recenti
Non .NET (JavaScript, Python, Java, PowerShell) Aggiornare il bundle di estensione
Correzione avanzata e urgente necessaria Aggiornare manualmente l'estensione

Fare riferimento ai pacchetti NuGet più recenti per le app .NET

Aggiornare il riferimento al pacchetto NuGet Durable Functions nel progetto. Il pacchetto corretto dipende dal modello di hosting e dal provider di archiviazione:

Provider di archiviazione Ruolo di lavoro in-process Lavoro isolato
Archiviazione di Azure (impostazione predefinita) 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

Ad esempio, per aggiornare l'estensione di Archiviazione di Azure predefinita in un'app di lavoro isolata:

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

Aggiornare il bundle di estensione

Le app non .NET (JavaScript, Python, Java, PowerShell) usano bundle extension per accedere a trigger e associazioni, inclusa l'estensione Durable Functions. Verificare che l'intervallo di versione nel includa l'ultima versione del rilascio del bundle :

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

Aggiornare l'intervallo di versioni, se necessario, ridistribuire l'app.

Aggiornare manualmente la versione dell'estensione Durable Functions

Se l'aggiornamento del bundle di estensione non ha risolto il problema e una versione più recente dell'estensione Durable Functions contiene una correzione necessaria, è possibile installare manualmente una versione di estensione specifica.

Caution

La gestione manuale delle estensioni significa perdere gli aggiornamenti automatici dai bundle di estensioni e può riscontrare problemi di compatibilità tra le estensioni. Utilizzare questo approccio solo per correzioni urgenti.

  1. Rimuovere la extensionBundle sezione dal host.json file.

  2. Installare la .NET CLI se non è già installata.

  3. Installare le estensioni. Per installare tutte le estensioni supportate dai bundle di estensioni, eseguire:

    func extensions install

    Per installare solo l'estensione Durable Functions in una versione specifica, eseguire:

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

    Sostituire <version> con la versione di destinazione dalla pagina releases.

Passaggi successivi

  • Last updated on