Share via

Taalstackversies bijwerken in Azure Functions

In Azure Functions is ondersteuning voor een taalstack beperkt tot specifieke versies. Wanneer er nieuwe versies beschikbaar komen, kunt u uw functie-apps bijwerken om te profiteren van nieuwe functies. Ondersteuning in Functions kan ook eindigen op oudere versies en wordt doorgaans afgestemd op de tijdlijnen voor end-of-support van de community. Zie het ondersteuningsbeleid voor taalruntime voor meer informatie. Zie Talen per runtime-versie voor ondersteunde versies van verschillende talen.

Volg de instructies in dit artikel om ervoor te zorgen dat uw functie-apps ondersteuning blijven ontvangen om ze bij te werken naar de nieuwste beschikbare versies. De manier waarop u uw functie-app bijwerkt, is afhankelijk van verschillende factoren:

  • De taal die u gebruikt om uw functie-apps te ontwikkelen. Zorg ervoor dat u bovenaan dit artikel uw programmeertaal selecteert.
  • Het besturingssysteem waarop uw functie-app wordt uitgevoerd in Azure: Windows of Linux.
  • Het hostingabonnement.

Notitie

In dit artikel leest u hoe u de .NET-versie van een functie-app bijwerkt die gebruikmaakt van het geïsoleerde werkrolmodel. Als uw functie-app wordt uitgevoerd op een oudere versie van .NET en het in-process model gebruikt, kunt u de volgende opties overwegen:

Vereiste voorwaarden

  • Een Azure-account met een actief abonnement. Maak gratis een account.
  • Een functie-app die wordt gehost in een van de volgende Functions-abonnementen:
    • Premium
    • Dedicated
    • Consumption

Uw functie-app voorbereiden

Voordat u de stackconfiguratie voor uw functie-app in Azure bijwerkt, moet u de taken in de volgende secties uitvoeren.

Uw functie-app lokaal verifiëren

Test en controleer de code van uw functie-app lokaal op de nieuwe doelversie.

Gebruik deze stappen om het project op uw lokale computer bij te werken:

  1. Zorg ervoor dat de doelversie van de .NET SDK is geïnstalleerd.

    Als u een preview-versie wilt gebruiken, raadpleegt u de Functies-richtlijnen voor preview.NET-versies om ervoor te zorgen dat de versie wordt ondersteund. Voor het gebruik van .NET-previews zijn mogelijk meer stappen vereist.

  2. Werk uw verwijzingen bij naar de nieuwste versies van Microsoft.Azure.Functions.Worker en Microsoft.Azure.Functions.Worker.Sdk.

  3. Werk het doelframework van uw project bij naar de nieuwe versie. Voor C#-projecten moet u het <TargetFramework> element in het .csproj-bestand bijwerken. Zie Target-frameworks voor meer informatie over uw versie.

    Het wijzigen van het doelframework van uw project vereist mogelijk ook wijzigingen in onderdelen van uw hulpprogrammaketen, buiten projectcode. In Visual Studio Code moet u bijvoorbeeld mogelijk de azureFunctions.deploySubpath extensie-instelling bijwerken in uw gebruikersinstellingen of het bestand .vscode/settings.json van uw project. Controleer op eventuele afhankelijkheden van de frameworkversie die buiten uw projectcode bestaan, als onderdeel van buildstappen of een CI/CD-pijplijn (continue integratie en continue levering).

  4. Breng eventuele updates aan voor uw projectcode die nodig is voor de nieuwe .NET-versie. Raadpleeg de releaseopmerkingen van de versie voor specifieke informatie. U kunt ook de .NET-upgradeassistent gebruiken om uw code bij te werken als reactie op wijzigingen in primaire versies.

Nadat u deze wijzigingen hebt aangebracht, bouwt u het project opnieuw en test u het om te controleren of uw functie-app wordt uitgevoerd zoals verwacht.

Naar de nieuwste Functions-runtime gaan

Zorg ervoor dat uw functie-app wordt uitgevoerd op de nieuwste versie van de Functions-runtime (versie 4.x). U kunt de runtimeversie bepalen in Azure Portal of met behulp van de Azure CLI.

Gebruik deze stappen om de runtimeversie van Functions te bepalen:

  1. Zoek en selecteer uw functie-app in Azure Portal. Selecteer Instellingenconfiguratie> in het zijmenu.

  2. Ga naar het tabblad Runtime-instellingen van de functie en controleer de waarde van de runtimeversie . Uw functie-app moet worden uitgevoerd op versie 4.x van de Functions-runtime (~4).

Als u uw functie-app wilt bijwerken naar versie 4.x, raadpleegt u Apps migreren van Azure Functions versie 1.x naar versie 4.x of Apps migreren van Azure Functions versie 3.x naar versie 4.x. Volg de instructies in deze artikelen in plaats van alleen de FUNCTIONS_EXTENSION_VERSION instelling te wijzigen.

Updates voor functie-apps publiceren

Als u de functie-app hebt bijgewerkt zodat deze correct wordt uitgevoerd op de nieuwe versie, publiceert u de updates van de functie-app voordat u de stackconfiguratie voor uw functie-app bijwerkt.

Aanbeveling

Als u het updateproces wilt stroomlijnen, de downtime voor uw functie-apps wilt minimaliseren en een mogelijke versie voor terugdraaien wilt bieden, moet u de bijgewerkte functie-app publiceren naar een staging-site. Zie Azure Functions-implementatiesites voor meer informatie.

Wanneer u de bijgewerkte functie-app publiceert naar een staging-site, moet u de instructies voor specifieke updates in de rest van dit artikel volgen. Later wisselt u de bijgewerkte staging-site om in productie.

De stackconfiguratie bijwerken

De manier waarop u de stackconfiguratie bijwerkt, is afhankelijk van of uw functie-app wordt uitgevoerd in Windows of linux in Azure.

Wanneer u een staging slot gebruikt, moet u ervoor zorgen dat u uw updates op de juiste slot richt.

Gebruik de volgende stappen om de Java-versie bij te werken:

  1. Zoek en selecteer uw functie-app in Azure Portal. Selecteer Instellingenconfiguratie> in het zijmenu. Als u een staging-slot hebt, selecteert u de specifieke slot.

  2. Werk op het tabblad Algemene instellingenJava-versie bij naar de gewenste versie.

  3. Selecteer Opslaan. Wanneer u een melding ontvangt over opnieuw opstarten, selecteert u Doorgaan.

Gebruik de volgende stappen om de .NET-versie bij te werken:

  1. Zoek en selecteer uw functie-app in Azure Portal. Selecteer Instellingenconfiguratie> in het zijmenu. Als u een staging-slot hebt, selecteert u de specifieke slot.

  2. Werk op het tabblad Algemene instellingen.NET-versie bij naar de gewenste versie.

  3. Selecteer Opslaan. Wanneer u een melding ontvangt over opnieuw opstarten, selecteert u Doorgaan.

Gebruik de volgende stappen om de Node.js-versie bij te werken:

  1. Zoek en selecteer uw functie-app in Azure Portal. Selecteer Instellingenconfiguratie> in het zijmenu. Als u een staging-slot hebt, selecteert u de specifieke slot.

  2. Werk op het tabblad Algemene instellingenNode.js versie bij naar de gewenste versie.

  3. Selecteer Opslaan. Wanneer u een melding ontvangt over opnieuw opstarten, selecteert u Doorgaan. Met deze wijziging wordt de WEBSITE_NODE_DEFAULT_VERSION toepassingsinstelling bijgewerkt.

Gebruik de volgende stappen om de PowerShell-versie bij te werken:

  1. Zoek en selecteer uw functie-app in Azure Portal. Selecteer Instellingenconfiguratie> in het zijmenu. Als u een staging-slot hebt, selecteert u de specifieke slot.

  2. Werk op het tabblad Algemene instellingenPowerShell Core-versie bij naar de gewenste versie.

  3. Selecteer Opslaan. Wanneer u een melding ontvangt over opnieuw opstarten, selecteert u Doorgaan.

Python-apps worden niet ondersteund in Windows. Ga in plaats daarvan naar het tabblad Linux .

De functie-app wordt opnieuw opgestart nadat u de versie hebt bijgewerkt.

Sites wisselen

Als u een staging-site gebruikt om uw codeproject te implementeren en uw instellingen bij te werken, wisselt u de staging-site in productie. Zie Swap slots voor meer informatie.

Verwante inhoud

Ontwikkelaarshandleiding voor Java

C#-handleiding voor geïsoleerde werkprocessen

ontwikkelaarshandleiding voor Node.js

Ontwikkelaarshandleiding voor Python

Ontwikkelaarshandleiding voor PowerShell