Delen via

Veelvoorkomende problemen tijdens de Upgrade van Azure Runtime oplossen

  • Artikel

In dit artikel wordt beschreven hoe u enkele veelvoorkomende problemen kunt oplossen die kunnen optreden tijdens het bijwerken van de taal van de functie-app of runtimeversie, zoals runtime die onbereikbaar is en modules niet worden gevonden.

  • Uitgebreide ondersteuning voor Microsoft .NET Core 3.1 is beëindigd op 3 december 2022. Azure Functions runtime v3 is gebaseerd op .NET core 3.1. We raden u aan uw functie-app bij te werken naar runtimeversie 4.x, die gebruikmaakt van .NET 6 en langetermijnondersteuning biedt. Na 3 december 2022 komen uw apps pas in aanmerking voor nieuwe functies, beveiligingspatches, prestatieoptimalisaties of ondersteuning totdat u ze hebt bijgewerkt naar Functions runtime versie 4.x.

  • Uw Functions-apps in runtime v3 blijven actief en uw toepassingen worden niet beïnvloed. U kunt code implementeren in deze Functions-toepassingen na deze datum. Maar we kunnen de mogelijkheid voor u om toepassingen te maken die zijn gericht op de Functions-runtime v3, verwijderen met behulp van algemene paden.

  • Zie voor meer informatie en migratierichtlijnen:

De compatibiliteit van de functie-app valideren voor runtime v4

  • Navigeer naar uw functie-app in de Azure Portal. Selecteer Problemen vaststellen en oplossen om Azure Functions diagnostische gegevens te openen. Typ in de zoekbalkDe taal van de functie-app bijwerken of Runtime-versie om deze rechtstreeks uit te voeren. Het diagnostische rapport bevat richtlijnen voor de update. Nadat de validatie is voltooid, volgt u de aanbevelingen en kunt u eventuele problemen in uw app oplossen.
  • We bieden ook een pre-upgrade validator om u te helpen bij het identificeren van mogelijke problemen bij het migreren van uw functie-app naar 4.x. Typ in dezelfde zoekbalk voor diagnostische gegevens Functions 4.x Pre-Upgrade Validator om deze rechtstreeks uit te voeren. Nadat de validatie is voltooid, volgt u de aanbevelingen en kunt u eventuele problemen in uw app oplossen.
  • We raden u ten zeerste aan uw lokale projectomgeving te upgraden naar versie 4.x. Test uw app volledig lokaal met versie 4.x van de Azure Functions kernhulpprogramma's.
  • Overweeg het gebruik van een staging-site om uw app in Azure te testen en te verifiëren op de nieuwe runtimeversie voordat u implementeert naar een productiesite. Vergeet niet om in te stellen WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS=0 voor migratie met sleuven.

De Runtime-versie van Functions voor Windows wijzigen

  1. Stel FUNCTIONS_EXTENSION_VERSION, een app-instelling in het deelvenster Azure Portal Configuratie, in op ~4. Zie De runtimeversie wijzigen voor meer informatie.
  2. Stel de netFrameworkVersion site-instelling in op doel .NET 6. netFrameworkVersion is een SiteConfig-instelling, geen app-instelling. En het is niet rechtstreeks beschikbaar in de Azure Portal. U kunt dit echter instellen met behulp van Azure Resource Explorer of Azure CLI/PowerShell.

Zie Runtimeversies van Functions voor meer informatie.

De Runtime-versie van Functions voor Linux wijzigen

  1. Stel FUNCTIONS_EXTENSION_VERSION, een app-instelling in het deelvenster Azure Portal Configuratie, in op ~4. Zie De runtimeversie wijzigen voor meer informatie.
  2. Stel LinuxFxVersion, met behulp van opdrachtregelinterface (CLI) in op <Language>|<LanguageVersion>, op basis van de gebruikte taal. Zie LinuxFxVersion gebruiken voor Linux-functie-apps voor meer informatie. Als u bijvoorbeeld wilt bijwerken naar .NET 6, kunt u instellen LinuxFxVersion op dotnet|6.0 en FUNCTIONS_EXTENSION_VERSION op ~4.

Zie Runtimeversies van Functions voor meer informatie.

Een lijst met ondersteunde talen ophalen door de runtimeversie

Zie de lijst met ondersteunde talen door de runtimeversie.

De taalversie-instelling voor de functie-app bijwerken na het bijwerken van de code

gebruik van Azure Functions proxy's

Ondersteuning voor proxy's is weer beschikbaar in versie 4.x, zodat u uw functie-apps kunt upgraden naar de nieuwste runtimeversie. We raden u echter aan uw functie-apps zo snel mogelijk te integreren met Azure API Management. met API Management kunt u profiteren van een volledigere set functies voor het definiëren, beveiligen, beheren en geld verdienen met uw Op Functions gebaseerde API's. Zie Migreren naar APIM en Functies integreren met APIM met behulp van Visual Studio voor meer informatie.

Een lijst ophalen met alle Azure Functions apps die gebruikmaken van runtimeversie 1.x, 2.x of 3.x

  1. Navigeer naar uw functie-app in de Azure Portal.
  2. Selecteer Problemen vaststellen en oplossen om Azure Functions diagnostische gegevens te openen.
  3. Typ in de zoekbalkDe taal van de functie-app bijwerken of Runtime-versie om deze rechtstreeks uit te voeren.
  4. Schuif in het diagnostische rapport omlaag en selecteer Alle weergavedetails van functie-app>weergeven.
  5. Stel de zoekfilters in en selecteer Weergeven om de lijst met functie-apps in het huidige abonnement op te halen.

U kunt ook App Service REST API-aanroepen (GetConfiguration) gebruiken om dit te bepalen. LinuxFxVersion en WindowsFxVersion geef de versie-informatie op.

Een .NET Framework 4.6.1-app verplaatsen van Functions runtime v1 naar v4

.NET Framework 4.6.1 het einde van de levensduur heeft bereikt, dus apps moeten worden bijgewerkt naar .NET Framework 4.8. In Functions v4 kunt u een .NET Framework 4.8-app uitvoeren in de modus Buiten proces. Zie de handleiding voor geïsoleerde processen voor meer informatie.

Een gemigreerde functie-app wordt niet gestart of er zijn enkele runtimeproblemen

  • Voor .NET-apps moet u de code bijwerken naar .NET 6 voordat u gaat bouwen en implementeren.
  • Controleer de runtimeversie van de app in de Azure Portal.
  • Voor Windows-apps moet u ook instellen netFrameworkVersion met cli of PowerShell.
  • Zorg ervoor dat u de uitbreidingsbundels 2.x of hoger gebruikt, zoals aanbevolen. Versie 4.x van de Functions-runtime vereist versie 2.x of 3.0.0.
  • Aanmelden bij Azure Storage met behulp van AzureWebJobsDashboard wordt niet meer ondersteund in 4.x. Gebruik in plaats daarvan Application Insights voor bewaking.
  • Als u een bericht ontvangt dat Azure Functions runtime onbereikbaar is en u opslagaccounts deelt, raadpleegt u Overwegingen voor host-id's.
  • Azure Functions 4.x biedt geen ondersteuning voor Node.js 10 en 12, Python 3.6 en PowerShell 6. Zie Taalversies die worden ondersteund voor de v4-runtime voor meer informatie.
  • Als er voor Python-functies fouten zijn met betrekking tot moduleconflicten en module niet gevonden, probeert u in app-instellingen op 1 in te stellenPYTHON_ISOLATE_WORKER_DEPENDENCIES.
  • Raadpleeg Bestaande functie-apps migreren.
  • Voor runtimeproblemen zoekt u in de optie Problemen vaststellen en oplossen in de Azure Portal naar Functie-app offline of rapporteert u fouten en controleert u het diagnostische rapport op foutberichten en oplossingen. Controleer ook de detector Functieconfiguratie controleert of de configuratie juist is.
  • Raadpleeg de blog Problemen bij het upgraden van Azure-functie-apps naar V4 voor aanvullende tips voor probleemoplossing.

Contacteer ons voor hulp

Als u vragen hebt of hulp nodig hebt, maak een ondersteuningsaanvraag of vraag de Azure-communityondersteuning. U kunt ook productfeedback verzenden naar de Feedback-community van Azure.