Condividi tramite

Aggiornare le versioni dello stack di linguaggio in Funzioni di Azure

In Funzioni di Azure il supporto per uno stack di linguaggio è limitato a versioni specifiche. Man mano che diventano disponibili nuove versioni, è possibile che si voglia aggiornare le app per le funzioni per sfruttare le nuove funzionalità. Il supporto in Funzioni può anche terminare per le versioni precedenti ed è in genere allineato alle sequenze temporali di fine supporto della community. Per altre informazioni, vedere i criteri di supporto del runtime del linguaggio. Per le versioni supportate di diversi linguaggi, vedere Linguaggi in base alla versione di runtime.

Per assicurarsi che le app continuino a ricevere supporto, è necessario seguire le istruzioni descritte in questo articolo per eseguire l'aggiornamento alle versioni disponibili più recenti. Il modo in cui si aggiorna l'app per le funzioni dipende da diversi fattori:

  • Linguaggio usato per sviluppare le app per le funzioni. Assicurarsi di selezionare il linguaggio di programmazione nella parte superiore di questo articolo.
  • Sistema operativo in cui viene eseguita l'app per le funzioni in Azure: Windows o Linux.
  • Il piano di hosting.

Note

Questo articolo spiega come aggiornare la versione .NET di un'app per le funzioni che usa il modello di lavoro isolato. Se l'app per le funzioni viene eseguita in una versione precedente di .NET e usa il modello in-process, prendere in considerazione le opzioni seguenti:

Prerequisiti

  • Un account Azure con una sottoscrizione attiva. Creane uno gratis.
  • Un'app per le funzioni ospitata in uno dei piani di funzioni seguenti:
    • Di alta qualità
    • Dedicated
    • Consumption

Preparare l'app per le funzioni

Prima di aggiornare la configurazione dello stack per l'app per le funzioni in Azure, completare le attività nelle sezioni seguenti.

Verificare l'app per le funzioni in locale

Testare e verificare il codice dell'app per le funzioni in locale nella nuova versione di destinazione.

Seguire questa procedura per aggiornare il progetto nel computer locale:

  1. Assicurarsi che sia installata la versione di destinazione di .NET SDK.

    Se si ha come destinazione una versione di anteprima, vedere Indicazioni sulle funzioni per le versioni di anteprima di .NET per assicurarsi che la versione sia supportata. L'uso delle anteprime .NET potrebbe richiedere altri passaggi.

  2. Aggiornare i riferimenti alle versioni più recenti di Microsoft.Azure.Functions.Worker e Microsoft.Azure.Functions.Worker.Sdk.

  3. Aggiornare il framework di destinazione del progetto alla nuova versione. Per i progetti C#, è necessario aggiornare l'elemento <TargetFramework> nel file con estensione csproj. Per altre informazioni sulla versione, vedere Framework di destinazione.

    La modifica del framework di destinazione del progetto potrebbe anche richiedere modifiche alle parti della toolchain, all'esterno del codice del progetto. In Visual Studio Code, ad esempio, potrebbe essere necessario aggiornare l'impostazione dell'estensione azureFunctions.deploySubpath nelle impostazioni utente o nel file vscode/settings.json del progetto. Verificare la presenza di eventuali dipendenze della versione del framework esistente all'esterno del codice del progetto, come parte dei passaggi di compilazione o di una pipeline di integrazione continua e recapito continuo (CI/CD).

  4. Apportare eventuali aggiornamenti al codice del progetto richiesto dalla nuova versione di .NET. Controllare le note sulla versione della versione per informazioni specifiche. È anche possibile usare .NET Upgrade Assistant per aggiornare il codice in risposta alle modifiche nelle versioni principali.

Dopo aver apportato queste modifiche, ricompilare il progetto e testarlo per verificare che l'app per le funzioni venga eseguita come previsto.

Passare al runtime di Azure Functions più recente

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

Seguire questa procedura per determinare la versione del runtime Funzioni:

  1. Nel portale di Azure, trova e seleziona l'app per le funzioni. Nel menu laterale selezionare Impostazioni>Configurazione.

  2. Passare alla scheda Impostazioni runtime funzione e controllare il valore della versione di runtime. L'app per le funzioni deve essere eseguita nella versione 4.x del runtime di Funzioni (~4).

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

Pubblicare gli aggiornamenti delle app per le funzioni

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

Suggerimento

Per semplificare il processo di aggiornamento, ridurre al minimo i tempi di inattività per le app per le funzioni e specificare una versione potenziale per il ripristino dello stato precedente, è necessario pubblicare l'app per le funzioni aggiornata in uno slot di staging. Per altre informazioni, vedere slot di distribuzione di Funzioni di Azure.

Quando si pubblica l'app per le funzioni aggiornata in uno slot di staging, assicurarsi di seguire le istruzioni di aggiornamento specifiche dello slot riportate nel resto di 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 l'app per le funzioni venga eseguita in Windows o in 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:

  1. Nel portale di Azure, trova e seleziona l'app per le funzioni. Nel menu laterale selezionare Impostazioni>Configurazione. Se si dispone di uno slot di staging, selezionare lo slot specifico.

  2. Nella scheda Impostazioni generali aggiornare Versione Java alla versione desiderata.

  3. Seleziona Salva. Quando si riceve una notifica relativa a un riavvio, selezionare Continua.

Per aggiornare la versione .NET, seguire questa procedura:

  1. Nel portale di Azure, trova e seleziona l'app per le funzioni. Nel menu laterale selezionare Impostazioni>Configurazione. Se si dispone di uno slot di staging, selezionare lo slot specifico.

  2. Nella scheda Impostazioni generali aggiornare Versione di .NET alla versione desiderata.

  3. Seleziona Salva. Quando si riceve una notifica relativa a un riavvio, selezionare Continua.

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

  1. Nel portale di Azure, trova e seleziona l'app per le funzioni. Nel menu laterale selezionare Impostazioni>Configurazione. Se si dispone di uno slot di staging, selezionare lo slot specifico.

  2. Nella scheda Impostazioni generali aggiornare Versione di Node.js alla versione desiderata.

  3. Seleziona Salva. Quando si riceve 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:

  1. Nel portale di Azure, trova e seleziona l'app per le funzioni. Nel menu laterale selezionare Impostazioni>Configurazione. Se si dispone di uno slot di staging, selezionare lo slot specifico.

  2. Nella scheda Impostazioni generali aggiornare Versione di PowerShell Core alla versione desiderata.

  3. Seleziona Salva. Quando si riceve una notifica relativa a un riavvio, selezionare Continua.

Le app Python non sono supportate su Windows. Passare invece alla scheda Linux .

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

Scambio degli slot

Se si usa uno slot di staging per distribuire il progetto di codice e aggiornare le impostazioni, scambiare lo slot di staging nell'ambiente di produzione. Per altre informazioni, vedere Scambiare gli slot.

Contenuti correlati

Guida per sviluppatori Java

Guida al processo di lavoro isolato in C#

Guida per sviluppatori Node.js

Guida per sviluppatori Python

Guida per sviluppatori PowerShell

  • Last updated on