Taalstackversies bijwerken in Azure Functions

Artikel
10/16/2024

De ondersteuning voor een bepaalde taalstack in Azure Functions is beperkt tot specifieke versies. Naarmate er nieuwe versies beschikbaar komen, wilt u mogelijk uw apps bijwerken om te profiteren van hun functies. Ondersteuning in Functions kan ook eindigen op oudere versies, meestal afgestemd op de tijdlijnen voor einde van ondersteuning van de community. Zie het ondersteuningsbeleid voor Language Runtime voor meer informatie. Om ervoor te zorgen dat uw apps ondersteuning blijven ontvangen, moet u de instructies volgen die in dit artikel worden beschreven om ze bij te werken naar de nieuwste beschikbare versies.

De manier waarop u uw functie-app bijwerkt, is afhankelijk van:

De taal die u gebruikt om uw functies te ontwerpen; Zorg ervoor dat u uw programmeertaal bovenaan het artikel kiest.
Het besturingssysteem waarop uw app wordt uitgevoerd in Azure: Windows of Linux.
Het hostingabonnement.

Notitie

In dit artikel leest u hoe u de .NET-versie van een app bijwerkt met behulp van het geïsoleerde werkrolmodel. Apps die worden uitgevoerd op oudere versies van .NET met het in-procesmodel , kunnen worden bijgewerkt naar .NET 8, of ze kunnen migreren van het in-procesmodel naar het geïsoleerde werkrolmodel.

Voorbereiden op bijwerken

Voordat u de stackconfiguratie voor uw functie-app in Azure bijwerkt, moet u deze taken voltooien:

1. Controleer uw functies lokaal

Zorg ervoor dat u uw functiecode lokaal test en verifieert op de nieuwe doelversie.

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

Zorg ervoor dat u de doelversie van de .NET SDK hebt geïnstalleerd.

Als u een preview-versie wilt gebruiken, raadpleegt u de Functions-richtlijnen voor preview.NET-versies om ervoor te zorgen dat de versie wordt ondersteund. Er zijn mogelijk extra stappen vereist voor .NET-previews.
Werk uw verwijzingen bij naar de nieuwste versies van: Microsoft.Azure.Functions.Worker en Microsoft.Azure.Functions.Worker.Sdk.
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 Doelframeworks voor specifieke informatie met betrekking tot de gekozen versie.

Het wijzigen van het doelframework van uw project vereist mogelijk ook wijzigingen in onderdelen van uw hulpprogrammaketen, buiten projectcode. In VS Code moet u bijvoorbeeld mogelijk de azureFunctions.deploySubpath extensie-instelling bijwerken via gebruikersinstellingen of het bestand van .vscode/settings.json uw project. Controleer op eventuele afhankelijkheden van de frameworkversie die mogelijk buiten uw projectcode bestaan, als onderdeel van de buildstappen of een CI/CD-pijplijn.
Breng eventuele updates aan voor uw projectcode die vereist zijn voor de nieuwe .NET-versie. Controleer de releaseopmerkingen van de versie op 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 bevestigen dat uw app wordt uitgevoerd zoals verwacht.

2. 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.

Azure-portal
Azure-CLI

Gebruik deze stappen om de runtimeversie van Functions te bepalen:

Zoek in Azure Portal uw functie-app en selecteer Configuratie aan de linkerkant onder Instellingen.
Selecteer het tabblad Runtime-instellingen van de functie en controleer de runtime-versiewaarde om te zien of uw functie-app wordt uitgevoerd op versie 4.x van de Functions-runtime (~4).

Gebruik deze az functionapp config appsettings list opdracht om uw runtimeversie te controleren:

az functionapp config appsettings list --name "<FUNCTION_APP_NAME>" --resource-group "<RESOURCE_GROUP_NAME>"

De FUNCTIONS_EXTENSION_VERSION instelling stelt de runtimeversie in. De waarde betekent ~4 dat uw functie-app al wordt uitgevoerd op de nieuwste secundaire versie van de nieuwste primaire versie (4.x).

Als u uw functie-app eerst moet 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.

App-updates publiceren

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

Tip

Om het updateproces te vereenvoudigen, de downtime voor uw functies te minimaliseren en een potentieel voor terugdraaien te bieden, moet u uw bijgewerkte app publiceren naar een staging-site. Zie Azure Functions-implementatiesites voor meer informatie.

Wanneer u uw bijgewerkte app publiceert naar een staging-site, moet u de specifieke update-instructies 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 u windows of Linux in Azure gebruikt.

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

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

Zoek in Azure Portal uw functie-app en selecteer Configuratie aan de linkerkant. Wanneer u een staging-site gebruikt, moet u eerst de specifieke site selecteren.
Werk op het tabblad Algemene instellingen de Java-versie bij naar de gewenste versie.
Selecteer Opslaan en wanneer u een melding ontvangt over opnieuw opstarten, selecteert u Doorgaan.

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

Zoek in Azure Portal uw functie-app en selecteer Configuratie aan de linkerkant. Wanneer u een staging-site gebruikt, moet u eerst de specifieke site selecteren.
Werk op het tabblad Algemene instellingen .NET-versie bij naar de gewenste versie.
Selecteer Opslaan en wanneer u een melding ontvangt over opnieuw opstarten, selecteert u Doorgaan.

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

Zoek in Azure Portal uw functie-app en selecteer Configuratie aan de linkerkant. Wanneer u een staging-site gebruikt, moet u eerst de specifieke site selecteren.
Werk op het tabblad Algemene instellingen Node.js versie bij naar de gewenste versie.
Selecteer Opslaan en 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:

Zoek in Azure Portal uw functie-app en selecteer Configuratie aan de linkerkant. Wanneer u een staging-site gebruikt, moet u eerst de specifieke site selecteren.
Werk op het tabblad Algemene instellingen .NET-versie bij naar de gewenste versie.
Selecteer Opslaan en wanneer u een melding ontvangt over opnieuw opstarten, selecteert u Doorgaan.

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

Notitie

U kunt de Azure-portal alleen gebruiken om functie-apps bij te werken in Linux die worden gehost in een Premium-abonnement of een Toegewezen (App Service)-abonnement. Voor apps op Linux die worden gehost in een verbruiksabonnement, moet u in plaats daarvan de Azure CLI gebruiken.

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

Zoek in Azure Portal uw functie-app en selecteer Configuratie aan de linkerkant. Wanneer u een staging-site gebruikt, moet u eerst de specifieke site selecteren.
Werk op het tabblad Algemene instellingen de Java-versie bij naar de gewenste versie.
Selecteer Opslaan en wanneer u een melding ontvangt over opnieuw opstarten, selecteert u Doorgaan.

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

Zoek in Azure Portal uw functie-app en selecteer Configuratie aan de linkerkant. Wanneer u een staging-site gebruikt, moet u eerst de specifieke site selecteren.
Werk op het tabblad Algemene instellingen .NET-versie bij naar de gewenste versie.
Selecteer Opslaan en wanneer u een melding ontvangt over opnieuw opstarten, selecteert u Doorgaan.

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

Zoek in Azure Portal uw functie-app en selecteer Configuratie aan de linkerkant. Wanneer u een staging-site gebruikt, moet u eerst de specifieke site selecteren.
Werk op het tabblad Algemene instellingen Node.js versie bij naar de gewenste versie.
Selecteer Opslaan en 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:

Zoek in Azure Portal uw functie-app en selecteer Configuratie aan de linkerkant. Wanneer u een staging-site gebruikt, moet u eerst de specifieke site selecteren.
Werk op het tabblad Algemene instellingen .NET-versie bij naar de gewenste versie.
Selecteer Opslaan en wanneer u een melding ontvangt over opnieuw opstarten, selecteert u Doorgaan.

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

Zoek in Azure Portal uw functie-app en selecteer Configuratie aan de linkerkant. Wanneer u een staging-site gebruikt, moet u eerst de specifieke site selecteren.
Werk op het tabblad Algemene instellingen python-versie bij naar de gewenste versie.

Notitie

U kunt de Python-versie niet wijzigen wanneer deze wordt uitgevoerd in een verbruiksabonnement.
Selecteer Opslaan en wanneer u een melding ontvangt over opnieuw opstarten, selecteert u Doorgaan.

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

Gebruik eerst de az functionapp list-runtimes opdracht om de ondersteunde versiewaarden voor uw taal weer te geven. Voer vervolgens de az functionapp config set opdracht uit om de taalversie van uw functie-app bij te werken:

Voer de az functionapp list-runtimes opdracht uit om de ondersteunde versiewaarden voor .NET weer te geven op het geïsoleerde werkrolmodel:

az functionapp list-runtimes --os "windows" --query "[?runtime == 'java'].{Version:version}" --output table

az functionapp config set --java-version "<VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

az functionapp list-runtimes --os "windows" --query "[?runtime == 'dotnet-isolated'].{Version:version}" --output table

Voer de az functionapp config set opdracht uit om de .NET-versie van uw functie-app bij te werken:

az functionapp config set --net-framework-version "v<VERSION>.0" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

Gebruik eerst de az functionapp list-runtimes opdracht om de ondersteunde versiewaarden voor uw taalstack (Node.js) weer te geven. Voer vervolgens de az functionapp config set opdracht uit om de Node.js versie van uw functie-app bij te werken:

az functionapp list-runtimes --os "windows" --query "[?runtime == 'node'].{Version:version}" --output table

az functionapp config appsettings set --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --settings "WEBSITE_NODE_DEFAULT_VERSION=~<VERSION>" --slot "staging"

az functionapp list-runtimes --os "windows" --query "[?runtime == 'powershell'].{Version:version}" --output table

az functionapp config set --powershell-version "<VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

Vervang in dit voorbeeld <APP_NAME> respectievelijk <RESOURCE_GROUP> de naam van uw functie-app en resourcegroep. Vervang ook door <VERSION> de ondersteunde taalversie waarnaar u het bijwerkt. Als u geen staging-site gebruikt, verwijdert u de --slot parameter.

Notitie

U kunt de Python-versie niet wijzigen wanneer deze wordt uitgevoerd in een verbruiksabonnement.

Voer de az functionapp list-runtimes opdracht uit om de ondersteunde linuxFxVersion site-instelling voor uw taalversie weer te geven:

Voer de az functionapp list-runtimes opdracht uit om de ondersteunde linuxFxVersion site-instelling voor uw taalstackversie weer te geven:

az functionapp list-runtimes --os linux --query "[?runtime == 'python'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'dotnet-isolated'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'node'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'python'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'powershell'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

Voer de az functionapp config set opdracht uit om de site-instelling voor de nieuwe taalversie van uw functie-app bij te werken:

Voer de az functionapp config set opdracht uit om de site-instelling voor de nieuwe stackversie van uw functie-app bij te werken:

az functionapp config set --linux-fx-version "<LANGUAGE|VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

Vervang in dit voorbeeld <APP_NAME> respectievelijk <RESOURCE_GROUP> de naam van uw functie-app en resourcegroep. Vervang ook door <LANGUAGE|VERSION> de linuxFxVersion voor uw update. Als u geen staging-site gebruikt, verwijdert u de --slot parameter.

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

Sites wisselen

Als u de implementatie van uw codeproject hebt uitgevoerd en de instellingen in een staging-site hebt bijgewerkt, moet u de staging-site ten slotte in productie wisselen. Zie Swap slots voor meer informatie.