Aggiornare le versioni dello stack di linguaggio in Funzioni di Azure

Articolo
06/24/2024

Il supporto per un determinato stack di linguaggio in Funzioni di Azure è limitato a versioni specifiche. Man mano che diventano disponibili nuove versioni, si potrebbe voler aggiornare le proprie app per sfruttarne le funzionalità. Il supporto in Funzioni può anche terminare per le versioni precedenti, in genere in linea con le tempistiche di fine supporto della community. Per informazioni dettagliate, vedere i criteri di supporto del runtime di linguaggio. Per assicurarsi che le app continuino a ricevere supporto, è necessario seguire le istruzioni descritte in questo articolo per effettuare l’aggiornamento alle versioni disponibili più recenti.

Il modo in cui si aggiorna l'app per le funzioni dipende da:

Il linguaggio usato per creare le funzioni; assicurarsi di scegliere il proprio linguaggio di programmazione nella parte superiore dell'articolo.
Il sistema operativo in cui viene eseguita l'app in Azure: Windows o Linux.
Il piano di hosting.

Nota

Questo articolo illustra come aggiornare la versione .NET di un'app usando il modello ruolo di lavoro isolato. Le app eseguite in versioni precedenti di .NET con il modello In-Process possono eseguire l'aggiornamento a .NET 8 di destinazione oppure possono eseguire la migrazione dal modello In-Process al modello ruolo di lavoro isolato.

Preparazione all'aggiornamento

Prima di aggiornare la configurazione dello stack per l'app per le funzioni in Azure, è necessario completare queste attività:

1. Verificare le funzioni in locale

Assicurarsi di testare e verificare il codice della funzione in locale nella nuova versione di destinazione.

Seguire questa procedura per aggiornare il progetto nel computer locale:

Assicurarsi di aver installato la versione di destinazione dell’SDK .NET.
Aggiornare i riferimenti alle versioni stabili più recenti di: Microsoft.Azure.Functions.Worker e Microsoft.Azure.Functions.Worker.Sdk.
Aggiornare il framework di destinazione del progetto alla nuova versione. Per i progetti C#, è necessario aggiornare l'elemento <TargetFramework> del file .csproj. Per informazioni specifiche relative alla versione scelta, vedere Framework di destinazione.

La modifica del framework di destinazione del progetto potrebbe richiedere anche modifiche a parti della toolchain, esternamente al codice del progetto. Ad esempio, in VS Code potrebbe essere necessario aggiornare l'impostazione dell'estensione azureFunctions.deploySubpath tramite le impostazioni utente o il file .vscode/settings.json del progetto. Verificare la presenza di eventuali dipendenze dalla versione del framework che possono esistere al di fuori del codice del progetto, come parte dei passaggi di compilazione o di una pipeline CI/CD.
Apportare eventuali aggiornamenti al codice del progetto, richiesti dalla nuova versione di .NET. Controllare le note sulla versione della versione per ottenere informazioni specifiche. È inoltre possibile usare .NET Upgrade Assistant per aggiornare il codice in risposta alle modifiche apportate alle versioni principali.

Dopo aver apportato queste modifiche, ricompilare il progetto e testarlo per confermare l'esecuzione dell'app come previsto.

2. Passare al runtime Funzioni più recente

Assicurarsi che l'app per le funzioni sia in esecuzione sulla versione più recente del runtime Funzioni (versione 4.x). È possibile determinare la versione di runtime nel portale di Azure o usando l'interfaccia della riga di comando di Azure.

Azure portal
Interfaccia della riga di comando di Azure

Seguire questa procedura per determinare la versione del runtime Funzioni:

Nel portale di Azure individuare l'app per le funzioni e selezionare Configurazione sul lato sinistro in Impostazioni.
Selezionare la scheda Impostazioni runtime Funzioni e controllare il valore della versione del runtime per verificare se l'app per le funzioni è in esecuzione sulla versione 4.x del runtime Funzioni (~4).

Usare questo comando az functionapp config appsettings list per controllare la versione di runtime:

az functionapp config appsettings list --name "<FUNCTION_APP_NAME>" --resource-group "<RESOURCE_GROUP_NAME>"

L'impostazione FUNCTIONS_EXTENSION_VERSION stabilisce la versione di runtime. Un valore ~4 indica che l'app per le funzioni è già in esecuzione sulla versione secondaria più recente della versione principale più recente (4.x).

Se prima è necessario aggiornare l'app per le funzioni alla versione 4.x, vedere Eseguire la migrazione delle app da Funzioni di Azure versione 1.x alla versione 4.x o Eseguire la migrazione delle app da Funzioni di Azure versione 3.x alla versione 4.x. È consigliabile seguire le istruzioni contenute in questi articoli anziché modificare semplicemente l'impostazione FUNCTIONS_EXTENSION_VERSION.

Pubblicare gli aggiornamenti delle app

Se l'app è stata aggiornata per la corretta esecuzione sulla nuova versione, pubblicare gli aggiornamenti dell'app prima di aggiornare la configurazione dello stack dell'app per le funzioni.

Suggerimento

Per semplificare il processo di aggiornamento, ridurre al minimo i tempi di inattività delle funzioni e offrire un potenziale per il rollback, è consigliabile pubblicare l'app aggiornata in uno slot di staging. Per altre informazioni, vedere slot di distribuzione di Funzioni di Azure.

Quando si pubblica l'app aggiornata in uno slot di staging, assicurarsi di seguire le istruzioni di aggiornamento specifiche dello slot, riportate in questo articolo. Successivamente si scambia lo slot di staging aggiornato con l’ambiente di produzione.

Aggiornare la configurazione dello stack

Il modo in cui si aggiorna la configurazione dello stack dipende dal fatto che sia in esecuzione su Windows o su Linux in Azure.

Quando si usa uno slot di staging, assicurarsi di indirizzare gli aggiornamenti allo slot corretto.

Per aggiornare la versione Java, seguire questa procedura:

Nel portale di Azure individuare l'app per le funzioni e selezionare Configurazione sul lato sinistro. Quando si usa uno slot di staging, assicurarsi di selezionare prima di tutto lo slot specifico.
Nella scheda Impostazioni generali aggiornare la versione Java alla versione desiderata.
Selezionare Salva e quando viene visualizzata una notifica relativa a un riavvio selezionare Continua.

Per aggiornare la versione .NET, seguire questa procedura:

Nel portale di Azure individuare l'app per le funzioni e selezionare Configurazione sul lato sinistro. Quando si usa uno slot di staging, assicurarsi di selezionare prima di tutto lo slot specifico.
Nella scheda Impostazioni generali aggiornare la versione .NET alla versione desiderata.
Selezionare Salva e quando viene visualizzata una notifica relativa a un riavvio selezionare Continua.

Per aggiornare la versione Node.js, seguire questa procedura:

Nel portale di Azure individuare l'app per le funzioni e selezionare Configurazione sul lato sinistro. Quando si usa uno slot di staging, assicurarsi di selezionare prima di tutto lo slot specifico.
Nella scheda Impostazioni generali aggiornare la versione Node.js alla versione desiderata.
Selezionare Salva e quando viene visualizzata una notifica relativa a un riavvio selezionare Continua. Questa modifica aggiorna l'impostazione dell'applicazione WEBSITE_NODE_DEFAULT_VERSION.

Per aggiornare la versione PowerShell, seguire questa procedura:

Nel portale di Azure individuare l'app per le funzioni e selezionare Configurazione sul lato sinistro. Quando si usa uno slot di staging, assicurarsi di selezionare prima di tutto lo slot specifico.
Nella scheda Impostazioni generali aggiornare la versione .NET alla versione desiderata.
Selezionare Salva e quando viene visualizzata una notifica relativa a un riavvio selezionare Continua.

Le app Python non sono supportate su Windows. Selezionare invece la scheda Linux.

Nota

È possibile usare il portale di Azure solo per aggiornare le app per le funzioni su Linux ospitate in un piano Premium o in un piano dedicato (servizio app). Per le app su Linux ospitate in un piano a consumo, è invece necessario usare l'interfaccia della riga di comando di Azure.

Per aggiornare la versione Java, seguire questa procedura:

Nel portale di Azure individuare l'app per le funzioni e selezionare Configurazione sul lato sinistro. Quando si usa uno slot di staging, assicurarsi di selezionare prima di tutto lo slot specifico.
Nella scheda Impostazioni generali aggiornare la versione Java alla versione desiderata.
Selezionare Salva e quando viene visualizzata una notifica relativa a un riavvio selezionare Continua.

Per aggiornare la versione .NET, seguire questa procedura:

Nel portale di Azure individuare l'app per le funzioni e selezionare Configurazione sul lato sinistro. Quando si usa uno slot di staging, assicurarsi di selezionare prima di tutto lo slot specifico.
Nella scheda Impostazioni generali aggiornare la versione .NET alla versione desiderata.
Selezionare Salva e quando viene visualizzata una notifica relativa a un riavvio selezionare Continua.

Per aggiornare la versione Node.js, seguire questa procedura:

Nel portale di Azure individuare l'app per le funzioni e selezionare Configurazione sul lato sinistro. Quando si usa uno slot di staging, assicurarsi di selezionare prima di tutto lo slot specifico.
Nella scheda Impostazioni generali aggiornare la versione Node.js alla versione desiderata.
Selezionare Salva e quando viene visualizzata una notifica relativa a un riavvio selezionare Continua. Questa modifica aggiorna l'impostazione dell'applicazione WEBSITE_NODE_DEFAULT_VERSION.

Per aggiornare la versione PowerShell, seguire questa procedura:

Nel portale di Azure individuare l'app per le funzioni e selezionare Configurazione sul lato sinistro. Quando si usa uno slot di staging, assicurarsi di selezionare prima di tutto lo slot specifico.
Nella scheda Impostazioni generali aggiornare la versione .NET alla versione desiderata.
Selezionare Salva e quando viene visualizzata una notifica relativa a un riavvio selezionare Continua.

Le app Python non sono supportate su Windows. Selezionare invece la scheda Linux.

Nel portale di Azure individuare l'app per le funzioni e selezionare Configurazione sul lato sinistro. Quando si usa uno slot di staging, assicurarsi di selezionare prima di tutto lo slot specifico.
Nella scheda Impostazioni generali aggiornare la versione Python alla versione desiderata.

Nota

Non è possibile modificare la versione di Python durante l'esecuzione in un piano a consumo.
Selezionare Salva e quando viene visualizzata una notifica relativa a un riavvio selezionare Continua.

Le app Python non sono supportate su Windows. Selezionare invece la scheda Linux.

Usare prima di tutto il comando az functionapp list-runtimes per visualizzare i valori delle versioni supportate per il proprio linguaggio. Eseguire quindi il comando az functionapp config set per aggiornare la versione del linguaggio dell'app per le funzioni:

Eseguire il comando az functionapp list-runtimes per visualizzare i valori delle versioni supportate per .NET nel modello ruolo di lavoro isolato:

az functionapp list-runtimes --os "windows" --query "[?runtime == 'java'].{Version:version}" --output table

az functionapp config set --java-version "<VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

az functionapp list-runtimes --os "windows" --query "[?runtime == 'dotnet-isolated'].{Version:version}" --output table

Eseguire il comando az functionapp config set per aggiornare la versione .NET dell'app per le funzioni:

az functionapp config set --net-framework-version "v<VERSION>.0" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

Usare prima di tutto il comando az functionapp list-runtimes per visualizzare i valori delle versioni supportate per il proprio stack di linguaggio (Node.js). Eseguire quindi il comando az functionapp config set per aggiornare la versione Node.js dell'app per le funzioni:

az functionapp list-runtimes --os "windows" --query "[?runtime == 'node'].{Version:version}" --output table

az functionapp config appsettings set --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --settings "WEBSITE_NODE_DEFAULT_VERSION=~<VERSION>" --slot "staging"

az functionapp list-runtimes --os "windows" --query "[?runtime == 'powershell'].{Version:version}" --output table

az functionapp config set --powershell-version "<VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

In questo esempio, sostituire <APP_NAME> e <RESOURCE_GROUP> rispettivamente con il nome dell'app per le funzioni e del gruppo di risorse. Sostituire inoltre <VERSION> con la versione del linguaggio supportata a cui si sta effettuando l’aggiornamento. Se non si usa uno slot di staging, rimuovere il parametro --slot.

Nota

Non è possibile modificare la versione di Python durante l'esecuzione in un piano a consumo.

Eseguire il comando az functionapp list-runtimes per visualizzare l'impostazione del sito linuxFxVersion supportata per la propria versione del linguaggio:

Eseguire il comando az functionapp list-runtimes per visualizzare l'impostazione del sito linuxFxVersion supportata per la propria versione dello stack di linguaggio:

az functionapp list-runtimes --os linux --query "[?runtime == 'python'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'dotnet-isolated'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'node'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'python'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'powershell'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

Eseguire il comando az functionapp config set per aggiornare l'impostazione del sito per la nuova versione del linguaggio dell'app per le funzioni:

Eseguire il comando az functionapp config set per aggiornare l'impostazione del sito per la nuova versione dello stack dell'app per le funzioni:

az functionapp config set --linux-fx-version "<LANGUAGE|VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

In questo esempio, sostituire <APP_NAME> e <RESOURCE_GROUP> rispettivamente con il nome dell'app per le funzioni e del gruppo di risorse. Sostituire anche <LANGUAGE|VERSION> con linuxFxVersion per l'aggiornamento. Se non si usa uno slot di staging, rimuovere il parametro --slot.

L'app per le funzioni viene riavviata dopo l'aggiornamento della versione.

Scambio degli slot

Se si sta eseguendo la distribuzione del progetto di codice e si stanno aggiornando le impostazioni in uno slot di staging, è infine necessario scambiare lo slot di staging con l’ambiente di produzione. Per altre informazioni, vedere Scambiare gli slot.