Uppdatera språkstackversioner i Azure Functions

Artikel
10/17/2024

Stödet för en viss språkstack i Azure Functions är begränsat till specifika versioner. När nya versioner blir tillgängliga kanske du vill uppdatera dina appar för att dra nytta av deras funktioner. Stödet i Functions kan också sluta för äldre versioner, vanligtvis anpassat till communityns tidslinjer för slut på support. Mer information finns i supportprincipen för Språkkörning. För att säkerställa att dina appar fortsätter att få support bör du följa anvisningarna i den här artikeln för att uppdatera dem till de senaste tillgängliga versionerna.

Hur du uppdaterar funktionsappen beror på:

Det språk som du använder för att skapa dina funktioner; se till att välja programmeringsspråk överst i artikeln.
Operativsystemet som appen körs på i Azure: Windows eller Linux.
Värdplanen.

Kommentar

Den här artikeln visar hur du uppdaterar .NET-versionen av en app med hjälp av den isolerade arbetsmodellen. Appar som körs på äldre versioner av .NET med den pågående modellen kan uppdateras till .NET 8 som mål, eller så kan de migrera från den pågående modellen till den isolerade arbetsmodellen.

Förbereda för uppdatering

Innan du uppdaterar stackkonfigurationen för funktionsappen i Azure bör du utföra följande uppgifter:

1. Kontrollera dina funktioner lokalt

Kontrollera att du testar och verifierar funktionskoden lokalt på den nya målversionen.

Följ dessa steg för att uppdatera projektet på den lokala datorn:

Kontrollera att du har installerat målversionen av .NET SDK.

Om du riktar in dig på en förhandsversion läser du functions-vägledningen för förhandsversioner av .NET för att säkerställa att versionen stöds. Ytterligare steg kan krävas för .NET-förhandsversioner.
Uppdatera dina referenser till de senaste versionerna av: Microsoft.Azure.Functions.Worker och Microsoft.Azure.Functions.Worker.Sdk.
Uppdatera projektets målramverk till den nya versionen. För C#-projekt måste du uppdatera elementet <TargetFramework> .csproj i filen. Mer information om den valda versionen finns i Målramverk .

Att ändra projektets målramverk kan också kräva ändringar i delar av verktygskedjan, utanför projektkoden. I VS Code kan du till exempel behöva uppdatera tilläggsinställningen azureFunctions.deploySubpath via användarinställningar eller projektets .vscode/settings.json fil. Kontrollera om det finns beroenden för den ramverksversion som kan finnas utanför projektkoden, som en del av byggstegen eller en CI/CD-pipeline.
Gör eventuella uppdateringar av projektkoden som krävs av den nya .NET-versionen. Mer information finns i versionens viktig information. Du kan också använda .NET Upgrade Assistant för att uppdatera koden som svar på ändringar i större versioner.

När du har gjort ändringarna återskapar du projektet och testar det för att bekräfta att appen körs som förväntat.

2. Flytta till den senaste Functions-körningen

Kontrollera att funktionsappen körs på den senaste versionen av Functions-körningen (version 4.x). Du kan fastställa körningsversionen antingen i Azure Portal eller med hjälp av Azure CLI.

Azure-portalen
Azure CLI

Använd de här stegen för att fastställa din Functions-körningsversion:

Leta upp funktionsappen i Azure Portal och välj Konfiguration till vänster under Inställningar.
Välj fliken Funktionskörningsinställningar och kontrollera värdet för Körningsversion för att se om funktionsappen körs på version 4.x av Functions-körningen (~4).

Använd det här az functionapp config appsettings list kommandot för att kontrollera körningsversionen:

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

Inställningen FUNCTIONS_EXTENSION_VERSION anger körningsversionen. Värdet ~4 innebär att funktionsappen redan körs på den senaste delversionen av den senaste huvudversionen (4.x).

Om du först behöver uppdatera funktionsappen till version 4.x läser du Migrera appar från Azure Functions version 1.x till version 4.x eller Migrera appar från Azure Functions version 3.x till version 4.x. Du bör följa anvisningarna i dessa artiklar i stället för att bara ändra inställningen FUNCTIONS_EXTENSION_VERSION .

Publicera appuppdateringar

Om du har uppdaterat appen så att den körs korrekt i den nya versionen publicerar du appuppdateringarna innan du uppdaterar stackkonfigurationen för funktionsappen.

Dricks

För att förenkla uppdateringsprocessen, minimera stilleståndstiden för dina funktioner och ge en potential för återställning bör du publicera din uppdaterade app till ett mellanlagringsfack. Mer information finns i Distributionsfack för Azure Functions.

När du publicerar din uppdaterade app till ett mellanlagringsfack ska du följa instruktionerna för platsspecifika uppdateringar i resten av den här artikeln. Du växlar senare den uppdaterade mellanlagringsplatsen till produktion.

Uppdatera stackkonfigurationen

Hur du uppdaterar stackkonfigurationen beror på om du kör i Windows eller på Linux i Azure.

När du använder ett mellanlagringsfack måste du rikta dina uppdateringar till rätt fack.

Använd följande steg för att uppdatera Java-versionen:

Leta upp funktionsappen i Azure Portal och välj Konfiguration till vänster. När du använder ett mellanlagringsfack måste du först välja det specifika facket.
På fliken Allmänna inställningar uppdaterar du Java-versionen till önskad version.
Välj Spara och när du får ett meddelande om en omstart väljer du Fortsätt.

Använd följande steg för att uppdatera .NET-versionen:

Leta upp funktionsappen i Azure Portal och välj Konfiguration till vänster. När du använder ett mellanlagringsfack måste du först välja det specifika facket.
På fliken Allmänna inställningar uppdaterar du .NET-versionen till önskad version.
Välj Spara och när du får ett meddelande om en omstart väljer du Fortsätt.

Använd följande steg för att uppdatera Node.js version:

Leta upp funktionsappen i Azure Portal och välj Konfiguration till vänster. När du använder ett mellanlagringsfack måste du först välja det specifika facket.
På fliken Allmänna inställningar uppdaterar du Node.js version till önskad version.
Välj Spara och när du får ett meddelande om en omstart väljer du Fortsätt. Den här ändringen uppdaterar programinställningen WEBSITE_NODE_DEFAULT_VERSION .

Använd följande steg för att uppdatera PowerShell-versionen:

Leta upp funktionsappen i Azure Portal och välj Konfiguration till vänster. När du använder ett mellanlagringsfack måste du först välja det specifika facket.
På fliken Allmänna inställningar uppdaterar du .NET-versionen till önskad version.
Välj Spara och när du får ett meddelande om en omstart väljer du Fortsätt.

Python-appar stöds inte i Windows. Välj fliken Linux i stället.

Kommentar

Du kan bara använda Azure Portal för att uppdatera funktionsappar på Linux som finns i en Premium-plan eller en dedikerad (App Service)-plan. För appar i Linux som finns i en förbrukningsplan måste du i stället använda Azure CLI.

Använd följande steg för att uppdatera Java-versionen:

Leta upp funktionsappen i Azure Portal och välj Konfiguration till vänster. När du använder ett mellanlagringsfack måste du först välja det specifika facket.
På fliken Allmänna inställningar uppdaterar du Java-versionen till önskad version.
Välj Spara och när du får ett meddelande om en omstart väljer du Fortsätt.

Använd följande steg för att uppdatera .NET-versionen:

Leta upp funktionsappen i Azure Portal och välj Konfiguration till vänster. När du använder ett mellanlagringsfack måste du först välja det specifika facket.
På fliken Allmänna inställningar uppdaterar du .NET-versionen till önskad version.
Välj Spara och när du får ett meddelande om en omstart väljer du Fortsätt.

Använd följande steg för att uppdatera Node.js version:

Leta upp funktionsappen i Azure Portal och välj Konfiguration till vänster. När du använder ett mellanlagringsfack måste du först välja det specifika facket.
På fliken Allmänna inställningar uppdaterar du Node.js version till önskad version.
Välj Spara och när du får ett meddelande om en omstart väljer du Fortsätt. Den här ändringen uppdaterar programinställningen WEBSITE_NODE_DEFAULT_VERSION .

Använd följande steg för att uppdatera PowerShell-versionen:

Leta upp funktionsappen i Azure Portal och välj Konfiguration till vänster. När du använder ett mellanlagringsfack måste du först välja det specifika facket.
På fliken Allmänna inställningar uppdaterar du .NET-versionen till önskad version.
Välj Spara och när du får ett meddelande om en omstart väljer du Fortsätt.

Python-appar stöds inte i Windows. Välj fliken Linux i stället.

Leta upp funktionsappen i Azure Portal och välj Konfiguration till vänster. När du använder ett mellanlagringsfack måste du först välja det specifika facket.
På fliken Allmänna inställningar uppdaterar du Python-versionen till önskad version.

Kommentar

Du kan inte ändra Python-versionen när du kör i en förbrukningsplan.
Välj Spara och när du får ett meddelande om en omstart väljer du Fortsätt.

Python-appar stöds inte i Windows. Välj fliken Linux i stället.

az functionapp list-runtimes Använd först kommandot för att visa de versionsvärden som stöds för ditt språk. az functionapp config set Kör sedan kommandot för att uppdatera språkversionen av funktionsappen:

az functionapp list-runtimes Kör kommandot för att visa de versionsvärden som stöds för .NET i den isolerade arbetsmodellen:

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

az functionapp config set Kör kommandot för att uppdatera .NET-versionen av funktionsappen:

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

az functionapp list-runtimes Använd först kommandot för att visa de versionsvärden som stöds för din språkstack (Node.js). az functionapp config set Kör sedan kommandot för att uppdatera Node.js versionen av funktionsappen:

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"

I det här exemplet ersätter <APP_NAME> du och <RESOURCE_GROUP> med namnet på din funktionsapp respektive resursgrupp. Ersätt <VERSION> även med den språkversion som stöds som du uppdaterar till. Om du inte använder ett mellanlagringsfack tar du bort parametern --slot .

Kommentar

Du kan inte ändra Python-versionen när du kör i en förbrukningsplan.

az functionapp list-runtimes Kör kommandot för att visa den webbplatsinställning som stöds linuxFxVersion för språkversionen:

az functionapp list-runtimes Kör kommandot för att visa den webbplatsinställning som stöds linuxFxVersion för språkstackens version:

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

az functionapp config set Kör kommandot för att uppdatera platsinställningen för den nya språkversionen av funktionsappen:

az functionapp config set Kör kommandot för att uppdatera platsinställningen för den nya stackversionen av funktionsappen:

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

I det här exemplet ersätter <APP_NAME> du och <RESOURCE_GROUP> med namnet på din funktionsapp respektive resursgrupp. Ersätt <LANGUAGE|VERSION> även med linuxFxVersion för uppdateringen. Om du inte använder ett mellanlagringsfack tar du bort parametern --slot .

Funktionsappen startas om när du har uppdaterat versionen.

Växla fack

Om du har utfört distributionen av kodprojektet och uppdaterat inställningarna i ett mellanlagringsfack måste du äntligen byta mellanlagringsplatsen till produktion. Mer information finns i Växla fack.