Aggiornare Durable Functions versione dell'estensione

Molti problemi riscontrati dagli utenti con Durable Functions possono essere risolti semplicemente eseguendo l'aggiornamento alla versione più recente dell'estensione, che spesso contiene importanti correzioni di bug e miglioramenti delle prestazioni. È possibile seguire le istruzioni in questo articolo per ottenere la versione più recente dell'estensione Durable Functions.

Le modifiche apportate all'estensione sono disponibili nella pagina Versione del Azure/azure-functions-durable-extension repository. È anche possibile configurare per ricevere notifiche ogni volta che è disponibile una nuova versione dell'estensione passando alla pagina Versioni, facendo clic su Espressione di controllo, quindi su Personalizzato e infine selezionando il filtro Versioni :

Screenshot del passaggio 1 per configurare le notifiche di rilascio.

Screenshot del passaggio 2 per configurare le notifiche di rilascio.

Fare riferimento ai pacchetti NuGet più recenti (solo app.NET)

Le app .NET possono ottenere la versione più recente dell'estensione Durable Functions facendo riferimento al pacchetto NuGet più recente:

Se si usano i provider di archiviazione Netherite o MSSQL (anziché Archiviazione di Azure), è necessario fare riferimento a uno dei seguenti:

Aggiornare il bundle di estensione

I bundle di estensioni offrono un modo semplice e pratico per non-.NET app per le funzioni per fare riferimento e usare vari trigger e associazioni di Funzioni di Azure. Ad esempio, se è necessario inviare un messaggio a Hub eventi ogni volta che viene attivata la funzione, è possibile usare l'estensione Hub eventi per ottenere l'accesso alle associazioni di Hub eventi. L'estensione Durable Functions è inclusa anche in ogni versione dei bundle di estensioni. I bundle di estensione vengono configurati automaticamente in host.json quando si crea un'app per le funzioni usando uno degli strumenti di sviluppo supportati.

La maggior parte delle applicazioni non-.NET si basa su bundle di estensioni per ottenere l'accesso a vari trigger e associazioni. La versione più recente del bundle contiene spesso la versione più recente dell'estensione Durable Functions con correzioni di bug critiche e miglioramenti delle prestazioni. È quindi importante che l'app usi la versione più recente dei bundle di estensioni. È possibile controllare il file host.json per verificare se l'intervallo di versioni in uso include la versione più recente del bundle di estensione.

Aggiornare manualmente l'estensione Durable Functions

Se l'aggiornamento del bundle di estensione non ha risolto il problema e si è notato una versione più recente dell'estensione Durable Functions contenente una potenziale correzione del problema, è possibile provare a aggiornare manualmente l'estensione stessa. Si noti che questo è destinato solo a scenari avanzati o quando sono necessarie correzioni sensibili al tempo, in quanto esistono molti svantaggi per la gestione manuale delle estensioni. Ad esempio, potrebbe essere necessario gestire gli errori .NET quando le estensioni usate non sono compatibili tra loro. È anche necessario aggiornare manualmente le estensioni per ottenere le correzioni e le patch più recenti anziché recuperarle automaticamente tramite il bundle di estensione.

Prima di tutto, rimuovere la extensionBundle sezione dal file host.json.

Installare l'interfaccia della dotnet riga di comando se non è già disponibile. È possibile ottenerlo da questa pagina.

Poiché le applicazioni usano in genere più estensioni, è consigliabile eseguire le operazioni seguenti per installare manualmente tutte le versioni più recenti di tutte le estensioni supportate dai bundle di estensioni:

func extensions install

Tuttavia, se si vuole installare solo la versione più recente dell'estensione Durable Functions, eseguire il comando seguente:

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

Ad esempio:

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