Come specificare le versioni del runtime per Funzioni di Azure

Articolo
03/19/2024

L'app per le funzioni viene eseguita su una versione specifica del runtime di Funzioni di Azure. Per impostazione predefinita, le app per le funzioni vengono create nella versione 4.x più recente del runtime di Funzioni. Le app per le funzioni sono supportate solo quando vengono eseguite in una versione principale supportata. Questo articolo illustra come configurare un'app per le funzioni in Azure per la destinazione o l'aggiunta a una versione specifica quando necessario.

Il modo in cui si usa una versione specifica dipende dal fatto che si esegua Windows o Linux. Questa versione dell'articolo supporta Windows. Scegliere il sistema operativo nella parte superiore dell'articolo.

Il modo in cui si usa una versione specifica dipende dal fatto che si esegua Windows o Linux. Questa versione dell'articolo supporta Linux. Scegliere il sistema operativo nella parte superiore dell'articolo.

Importante

Quando possibile, è consigliabile eseguire sempre le funzioni nella versione supportata più recente del runtime di Funzioni di Azure. È consigliabile aggiungere l'app a una versione specifica quando viene richiesto di farlo a causa di un problema nella versione più recente. È consigliabile passare sempre alla versione di runtime più recente non appena le funzioni possono essere eseguite correttamente.

Durante lo sviluppo locale, la versione installata di Funzioni di Azure Core Tools deve corrispondere alla versione di runtime principale usata dall'app per le funzioni in Azure. Per altre informazioni, vedere Versioni degli strumenti di base.

Aggiornare la versione del runtime

Quando possibile, è consigliabile eseguire sempre le app per le funzioni nella versione supportata più recente del runtime di Funzioni di Azure. Se l'app per le funzioni è attualmente in esecuzione in una versione precedente del runtime, è consigliabile eseguire la migrazione dell'app alla versione 4.x

Quando l'app ha funzioni esistenti, è necessario adottare precauzioni prima di passare a una versione di runtime principale successiva. Gli articoli seguenti illustrano in dettaglio le modifiche di rilievo tra le versioni principali, incluse le modifiche di rilievo specifiche della lingua. Forniscono anche istruzioni dettagliate per una corretta migrazione dell'app per le funzioni esistente.

Per determinare la versione corrente del runtime, vedere Visualizzare la versione di runtime corrente.

Visualizzare la versione corrente del runtime

È possibile visualizzare la versione di runtime corrente dell'app per le funzioni in uno dei modi seguenti:

Eseguire la procedura seguente per visualizzare e aggiornare la versione del runtime usata attualmente da un'app per le funzioni.

Nel portale di Azure passare all'app per le funzioni.
In Impostazioni scegliere Configurazione. Nella scheda Impostazioni runtime funzione individuare la versione di runtime. Prendere nota della versione di runtime specifica. Nell'esempio seguente la versione è impostata su ~4.

È possibile visualizzare dall'interfaccia FUNCTIONS_EXTENSION_VERSION della riga di comando di Azure.

Usando l'interfaccia della riga di comando di Azure, visualizzare la versione di runtime corrente con il az functionapp config appsettings list comando .

az functionapp config appsettings list --name <function_app> \
--resource-group <my_resource_group>

In questo codice sostituire <function_app> con il nome dell'app per le funzioni. Sostituire anche <my_resource_group> con il nome del gruppo di risorse per l'app per le funzioni.

Verrà visualizzato FUNCTIONS_EXTENSION_VERSION nell'output seguente, troncato per maggiore chiarezza:

[
  {
    "name": "FUNCTIONS_EXTENSION_VERSION",
    "slotSetting": false,
    "value": "~4"
  },
  {
    "name": "FUNCTIONS_WORKER_RUNTIME",
    "slotSetting": false,
    "value": "dotnet"
  },
  
  ...
]

Scegliere Open Cloud Shell nell'esempio di codice precedente per eseguire il comando in Azure Cloud Shell. È anche possibile eseguire l'interfaccia della riga di comando di Azure in locale per eseguire questo comando. Quando si esegue localmente, è prima necessario eseguire az login per accedere.

Per controllare il runtime di Funzioni di Azure, usare il cmdlet seguente:

Get-AzFunctionAppSetting -Name "<FUNCTION_APP>" -ResourceGroupName "<RESOURCE_GROUP>"

Sostituire <FUNCTION_APP> con il nome dell'app per le funzioni e <RESOURCE_GROUP>. Il valore corrente dell'impostazione FUNCTIONS_EXTENSION_VERSION viene restituito nella tabella hash.

Aggiunta a una versione specifica

Funzioni di Azure consente di usare l'impostazione dell'applicazione FUNCTIONS_EXTENSION_VERSION per impostare come destinazione la versione di runtime usata da una determinata app per le funzioni. Quando si specifica solo la versione principale (~4), l'app per le funzioni viene aggiornata automaticamente alle nuove versioni secondarie del runtime quando diventano disponibili. Gli aggiornamenti delle versioni secondarie vengono eseguiti automaticamente perché le nuove versioni secondarie non devono introdurre modifiche di rilievo.

Le app Linux usano l'impostazione del linuxFxVersion sito insieme FUNCTIONS_EXTENSION_VERSION a per determinare l'immagine di base Linux corretta in cui eseguire le funzioni. Quando si crea una nuova app di funtion in Linux, il runtime sceglie automaticamente l'immagine di base corretta in base alla versione di runtime dello stack di linguaggio.

L'aggiunta a una versione di runtime specifica causa il riavvio dell'app per le funzioni.

Quando si specifica una versione secondaria specifica (ad esempio 4.0.12345) in FUNCTIONS_EXTENSION_VERSION, l'app per le funzioni viene aggiunta a tale versione specifica del runtime fino a quando non si sceglie esplicitamente di tornare agli aggiornamenti automatici. È consigliabile aggiungere solo a una versione secondaria specifica abbastanza a lungo per risolvere eventuali problemi con l'app per le funzioni che impediscono di usare come destinazione la versione principale. Le versioni secondarie meno recenti vengono rimosse regolarmente dall'ambiente di produzione. Quando si è aggiunti a una versione secondaria che viene rimossa, l'app per le funzioni viene invece eseguita sulla versione esistente più vicina anziché sul set di versioni in FUNCTIONS_EXTENSION_VERSION. Le rimozioni delle versioni secondarie vengono annunciate negli annunci di servizio app.

Nota

Quando si tenta di pubblicare da Visual Studio in un'app aggiunta a una versione secondaria specifica del runtime, una finestra di dialogo richiede di eseguire l'aggiornamento alla versione più recente o annullare la pubblicazione. Per evitare questo controllo quando è necessario usare una versione secondaria specifica, aggiungere la <DisableFunctionExtensionVersionUpdate>true</DisableFunctionExtensionVersionUpdate> proprietà nel .csproj file.

Usa uno di questi metodi per aggiungere temporaneamente l'app a una versione specifica del runtime:

Eseguire la procedura seguente per visualizzare e aggiornare la versione del runtime usata attualmente da un'app per le funzioni.

Nel portale di Azure passare all'app per le funzioni.
In Impostazioni scegliere Configurazione. Nella scheda Impostazioni runtime funzione individuare la versione di runtime. Prendere nota della versione di runtime specifica. Nell'esempio seguente la versione è impostata su ~4.

Per aggiungere l'app a una versione secondaria specifica, selezionare Impostazioni>applicazione FUNCTIONS_EXTENSION_VERSION, modificare Valore per la versione secondaria richiesta e selezionare OK.
Selezionare Salva>continua per applicare le modifiche e riavviare l'app.

È possibile aggiornare l'impostazione FUNCTIONS_EXTENSION_VERSION nell'app per le funzioni con il comando az functionapp config appsettings set.

az functionapp config appsettings set --name <FUNCTION_APP> \
--resource-group <RESOURCE_GROUP> \
--settings FUNCTIONS_EXTENSION_VERSION=<VERSION>

Scegliere Prova nell'esempio di codice precedente per eseguire il comando in Azure Cloud Shell. È anche possibile eseguire l'interfaccia della riga di comando di Azure in locale per eseguire questo comando. Quando si esegue localmente, è prima necessario eseguire az login per accedere.

Usare questo script per aggiungere il runtime di Funzioni:

Update-AzFunctionAppSetting -Name "<FUNCTION_APP>" -ResourceGroupName "<RESOURCE_GROUP>" -AppSetting @{"FUNCTIONS_EXTENSION_VERSION" = "<VERSION>"} -Force

Sostituire <FUNCTION_APP> con il nome dell'app per le funzioni e <RESOURCE_GROUP> con il nome del gruppo di risorse per l'app per le funzioni. <VERSION> Sostituire anche con la versione secondaria specifica di destinazione. È possibile verificare il valore aggiornato dell'impostazione FUNCTIONS_EXTENSION_VERSION nella tabella hash restituita.

L'app per le funzioni viene riavviata dopo aver apportato la modifica all'impostazione dell'applicazione.

Per aggiungere l'app per le funzioni a una versione di runtime specifica in Linux, impostare un URL dell'immagine di base specifico della versione nell'impostazione del linuxFxVersion sito nel formato DOCKER|<PINNED_VERSION_IMAGE_URI>.

Importante

Le app per le funzioni aggiunte in Linux non ricevono aggiornamenti regolari delle funzionalità di sicurezza e host. A meno che non sia consigliato da un professionista del supporto, usare l'impostazione FUNCTIONS_EXTENSION_VERSION e un valore standard linuxFxVersion per la lingua e la versione, ad esempio Python|3.9. Per i valori validi, vedere l'articolo di linuxFxVersion riferimento.

L'aggiunta a un runtime specifico non è attualmente supportata per le app per le funzioni Linux in esecuzione in un piano a consumo.

Di seguito è riportato un esempio del linuxFxVersion valore necessario per aggiungere un'app per le funzioni Node.js 16 a una versione di runtime specifica della versione 4.14.0.3:

DOCKER|mcr.microsoft.com/azure-functions/node:4.14.0.3-node16

Quando necessario, un professionista del supporto può fornire un URI di immagine di base valido per l'applicazione.

Usare i comandi seguenti dell'interfaccia della riga di comando di Azure per visualizzare e impostare .linuxFxVersion Non è attualmente possibile impostare linuxFxVersion nel portale o usando Azure PowerShell.

Per visualizzare la versione di runtime corrente, usare con il comando az functionapp config show .
```
az functionapp config show --name <function_app> \
--resource-group <my_resource_group> --query 'linuxFxVersion' -o tsv
```
In questo codice sostituire <function_app> con il nome dell'app per le funzioni. Sostituire anche <my_resource_group> con il nome del gruppo di risorse per l'app per le funzioni. Viene restituito il valore corrente di linuxFxVersion .
Per aggiornare l'impostazione linuxFxVersion nell'app per le funzioni, usare il comando az functionapp config set .
```
az functionapp config set --name <FUNCTION_APP> \
--resource-group <RESOURCE_GROUP> \
--linux-fx-version <LINUX_FX_VERSION>
```
Sostituire <FUNCTION_APP> con il nome dell'app per le funzioni. Sostituire anche <RESOURCE_GROUP> con il nome del gruppo di risorse per l'app per le funzioni. Sostituire infine <LINUX_FX_VERSION> con il valore di un'immagine specifica fornita da un professionista del supporto.

È possibile eseguire questi comandi da Azure Cloud Shell scegliendo Open Cloud Shell negli esempi di codice precedenti. È anche possibile usare l'interfaccia della riga di comando di Azure in locale per eseguire questo comando dopo l'esecuzione az login per accedere.

L'app per le funzioni viene riavviata dopo aver apportato la modifica alla configurazione del sito.

Passaggi successivi

Vedere le note sulla versione per le versioni del runtime

Condividi tramite