Condividi tramite

Risolvere i problemi comuni durante l'aggiornamento di Azure Runtime

  • Articolo

Questo articolo descrive come risolvere alcuni dei problemi comuni che possono verificarsi durante l'aggiornamento del linguaggio dell'app per le funzioni o della versione di runtime, ad esempio il runtime non raggiungibile e i moduli non trovati.

Convalidare la compatibilità dell'app per le funzioni per il runtime v4

  • Passare all'app per le funzioni nel portale di Azure. Selezionare Diagnostica e risoluzione dei problemi per aprire la diagnostica di Funzioni di Azure. Nella barra di ricerca digitare Aggiornamento del linguaggio dell'app di funzione per la versione di runtime per eseguirlo direttamente. Il report di diagnostica include indicazioni sull'aggiornamento. Al termine della convalida, seguire le indicazioni e risolvere eventuali problemi nell'app.
  • Forniamo anche uno strumento di convalida di pre-aggiornamento per identificare potenziali problemi durante la migrazione dell'app per le funzioni alla versione 4.x. Dalla stessa barra di ricerca diagnostica digitare Strumento di convalida pre-aggiornamento di Funzioni 4.x per eseguirlo direttamente. Al termine della convalida, seguire le indicazioni e risolvere eventuali problemi nell'app.
  • È consigliabile aggiornare l'ambiente del progetto locale alla versione 4.x. Eseguire un test completo dell'app in locale usando la versione 4.x di Azure Functions Core Tools.
  • Prendere in considerazione uno slot di staging per testare e verificare l'app in Azure nella nuova versione del runtime prima di procedere alla distribuzione in uno slot di produzione. Ricordarsi di impostare WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS=0 per la migrazione con slot.

Modificare la versione del runtime di Funzioni per Windows

  1. Impostare FUNCTIONS_EXTENSION_VERSION, ovvero un'impostazione dell'app nel riquadro Configurazione portale di Azure, su ~4. Per altre informazioni, vedere Modificare la versione di runtime.
  2. Impostare l'impostazione del netFrameworkVersion sito su .NET 6 come destinazione. netFrameworkVersion è un'impostazione di configurazione del sito, non un'impostazione dell'app. E non è direttamente disponibile nella portale di Azure. È tuttavia possibile impostarlo usando Azure Resource Explorer o l'interfaccia della riga di comando di Azure/PowerShell.

Per altre informazioni, vedere Versioni del runtime di Funzioni .

Modificare la versione del runtime di Funzioni per Linux

  1. Impostare FUNCTIONS_EXTENSION_VERSION, ovvero un'impostazione dell'app nel riquadro Configurazione portale di Azure, su ~4. Per altre informazioni, vedere Modificare la versione di runtime.
  2. Impostare LinuxFxVersion, usando l'interfaccia della riga di comando su <Language>|<LanguageVersion>, in base al linguaggio usato. Per altre informazioni, vedere Uso di LinuxFxVersion per le app per le funzioni Linux. Ad esempio, per eseguire l'aggiornamento a .NET 6, è possibile impostare su LinuxFxVersion dotnet|6.0 e FUNCTIONS_EXTENSION_VERSION su ~4.

Per altre informazioni, vedere Versioni del runtime di Funzioni .

Ottenere un elenco di linguaggi supportati dalla versione di runtime

Vedere l'elenco dei linguaggi supportati dalla versione di runtime.

Aggiornare l'impostazione della versione della lingua per l'app per le funzioni dopo l'aggiornamento del codice

  • PowerShell: nella portale di Azure impostare .PowerShell Core version Per altre informazioni, vedere Modificare la versione di PowerShell.
  • Python: Impostare linuxFxVersion su python|3.x. Per altre informazioni, vedere Modificare la versione di Python.
  • Java: specificare la versione del linguaggio utilizzandola -DjavaVersion come 11 o 17. Per altre informazioni, vedere Specificare la versione di distribuzione.
  • Node, JavaScript: per Windows impostare l'impostazione dell'app WEBSITE_NODE_DEFAULT_VERSION su ~16. Per Linux, impostare linuxFxVersion, tramite l'interfaccia della riga di comando, su node|16. Per altre informazioni, vedere Impostare la versione del nodo.

utilizzo dei proxy Funzioni di Azure

Il supporto per i proxy è nuovamente disponibile nella versione 4.x per consentire il corretto aggiornamento delle app per le funzioni alla versione del runtime più recente. È tuttavia consigliabile passare all'integrazione delle app per le funzioni con Azure Gestione API il prima possibile. Gestione API consente di sfruttare un set di funzionalità più completo per definire, proteggere, gestire e monetizzare le API basate su Funzioni. Per altre informazioni, vedere Come eseguire la migrazione a Gestione API e Integrare Funzioni con Gestione API usando Visual Studio.

Ottenere un elenco di tutte le app Funzioni di Azure che usano runtime versione 1.x, 2.x o 3.x

  1. Passare all'app per le funzioni nel portale di Azure.
  2. Selezionare Diagnostica e risoluzione dei problemi per aprire la diagnostica di Funzioni di Azure.
  3. Nella barra di ricerca digitare Aggiornamento del linguaggio dell'app di funzione per la versione di runtime per eseguirlo direttamente.
  4. Nel report di diagnostica scorrere verso il basso e selezionare Elenca tutti i dettagli della visualizzazione dell'app>per le funzioni.
  5. Impostare i filtri di ricerca e selezionare Mostra per ottenere l'elenco delle app per le funzioni nella sottoscrizione corrente.

In alternativa, è possibile usare servizio app chiamate API REST (GetConfiguration) per determinarlo. LinuxFxVersion e WindowsFxVersion fornire le informazioni sulla versione.

Spostare un'app .NET Framework 4.6.1 dal runtime di Funzioni v1 alla versione 4

Poiché .NET Framework 4.6.1 ha raggiunto la fine del suo ciclo di vita, le app devono essere aggiornate a .NET Framework 4.8. In Funzioni v4 è possibile eseguire un'app .NET Framework 4.8 nella modalità out-of-process. Per altre informazioni, vedere la guida ai processi isolati.

Un'app per le funzioni migrata non viene avviata o presenta alcuni problemi di runtime

  • Per le app .NET, ricordarsi di aggiornare il codice a .NET 6 prima di compilare e distribuire.
  • Controllare la versione di runtime dell'app nel portale di Azure.
  • Per le app Windows, è anche necessario impostare netFrameworkVersion tramite l'interfaccia della riga di comando o PowerShell.
  • Assicurarsi di usare i bundle di estensione 2.x o versioni successive, come consigliato. La versione 4.x del runtime di Funzioni richiede le versioni 2.x o 3.0.0.
  • L'accesso ad Archiviazione di Azure con AzureWebJobsDashboard non è più supportato nella versione 4.x. Usare invece Application Insights per il monitoraggio.
  • Se viene visualizzato un messaggio che indica che Funzioni di Azure runtime non è raggiungibile e si condividono gli account di archiviazione, vedere Considerazioni sull'ID host.
  • Funzioni di Azure 4.x non supporta Node.js 10 e 12, Python 3.6 e PowerShell 6. Per altre informazioni, vedere Versioni del linguaggio supportate per il runtime v4.
  • Per le funzioni Python, se sono presenti errori correlati alla collisione del modulo e al modulo non trovato, provare a impostare PYTHON_ISOLATE_WORKER_DEPENDENCIES su 1 nelle impostazioni dell'app.
  • Vedere Migrazione di app per le funzioni esistenti.
  • Per i problemi di runtime, dall'opzione Diagnostica e risoluzione dei problemi nella portale di Azure cercare l'app per le funzioni inattiva o segnalare errori ed esaminare il report di diagnostica per i messaggi di errore e le soluzioni. Esaminare anche il rilevamento Controlli della configurazione della funzione per assicurarsi che la configurazione sia corretta.
  • Per altri suggerimenti sulla risoluzione dei problemi, vedere il blog Problemi durante l'aggiornamento delle app per le funzioni di Azure a V4 .

Contattaci per ricevere assistenza

In caso di domande o bisogno di assistenza, creare una richiesta di supporto tecnico oppure formula una domanda nel Supporto della community di Azure. È possibile anche inviare un feedback sul prodotto al feedback della community di Azure.