Dela via

Uppdatera språkstackversioner i Azure Functions

I Azure Functions är stödet för en språkstack begränsat till specifika versioner. När nya versioner blir tillgängliga kanske du vill uppdatera funktionsapparna för att dra nytta av nya funktioner. Stödet i Functions kan också avslutas för äldre versioner och är vanligtvis anpassat till tidslinjer för communityns slut på support. Mer information finns i supportprincipen för språkkörning. För versioner av olika språk som stöds, se Språk efter körningsversion.

Följ anvisningarna i den här artikeln för att uppdatera dem till de senaste tillgängliga versionerna för att säkerställa att dina funktionsappar fortsätter att få support. Hur du uppdaterar funktionsappen beror på flera faktorer:

  • Det språk du använder för att utveckla dina funktionsappar. Se till att välja programmeringsspråket överst i den här artikeln.
  • Operativsystemet som funktionsappen körs på i Azure: Windows eller Linux.
  • Värdplanen.

Kommentar

Den här artikeln visar hur du uppdaterar .NET-versionen av en funktionsapp som använder den isolerade arbetsmodellen. Om din funktionsapp körs på en äldre version av .NET och använder den processbaserade modellen bör du överväga följande alternativ:

Förutsättningar

  • Ett Azure-konto med en aktiv prenumeration. Skapa en kostnadsfritt.
  • En funktionsapp som finns i någon av följande Functions-planer:
    • Premie
    • Dedicated
    • Consumption

Förbereda funktionsappen

Innan du uppdaterar stackkonfigurationen för funktionsappen i Azure slutför du uppgifterna i följande avsnitt.

Verifiera din funktionsapp lokalt

Testa och verifiera funktionsappkoden lokalt på den nya målversionen.

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

  1. Kontrollera att målversionen av .NET SDK är installerad.

    Om du riktar in dig på en förhandsversion kan du läsa Funktionsvägledning för förhandsversioner av .NET för att säkerställa att versionen stöds. Att använda .NET-förhandsversioner kan kräva fler steg.

  2. Uppdatera dina referenser till de senaste versionerna av Microsoft.Azure.Functions.Worker och Microsoft.Azure.Functions.Worker.Sdk.

  3. Uppdatera projektets målramverk till den nya versionen. För C#-projekt måste du uppdatera elementet <TargetFramework> i .csproj-filen . Mer information om din version finns i Målramverk.

    Att ändra projektets målramverk kan också kräva ändringar i delar av verktygskedjan, utanför projektkoden. I Visual Studio Code kan du till exempel behöva uppdatera tilläggsinställningen azureFunctions.deploySubpath i dina användarinställningar eller projektets .vscode/settings.json-fil . Kontrollera om det finns beroenden för den ramverksversion som finns utanför projektkoden, som en del av byggstegen eller en CI/CD-pipeline (kontinuerlig integrering och kontinuerlig leverans).

  4. Gör eventuella uppdateringar av projektkoden som den nya .NET-versionen kräver. Mer information finns i versionsanteckningarna. 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 genomfört ändringarna återskapar du projektet och testar det för att bekräfta att funktionsappen körs som förväntat.

Flytta till den senaste Functions-körmiljön

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.

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

  1. Leta upp och välj din funktionsapp i Azure-portalen. På sidomenyn väljer du Inställningar>Konfiguration.

  2. Gå till fliken Inställningar för funktionskörning och kontrollera värdet för Körningsversion . Funktionsappen ska köras på version 4.x av Functions-körningen (~4).

Om du 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. Följ anvisningarna i dessa artiklar i stället för att bara ändra inställningen FUNCTIONS_EXTENSION_VERSION .

Publicera funktionsappuppdateringar

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

Dricks

För att effektivisera uppdateringsprocessen, minimera stilleståndstiden för dina funktionsappar och tillhandahålla en potentiell version för återställning bör du publicera din uppdaterade funktionsapp till ett mellanlagringsfack. Mer information finns i Distributionsfack för Azure Functions.

När du publicerar din uppdaterade funktionsapp 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 din funktionsapp körs i Windows eller i Linux i Azure.

När du använder ett mellanlagringsfack ser du till att rikta dina uppdateringar till rätt fack.

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

  1. Leta upp och välj din funktionsapp i Azure-portalen. På sidomenyn väljer du Inställningar>Konfiguration. Om du har ett mellanlagringsfack väljer du det specifika facket.

  2. På fliken Allmänna inställningar uppdaterar du Java-versionen till önskad version.

  3. Välj Spara. 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:

  1. Leta upp och välj din funktionsapp i Azure-portalen. På sidomenyn väljer du Inställningar>Konfiguration. Om du har ett mellanlagringsfack väljer du det specifika facket.

  2. På fliken Allmänna inställningar uppdaterar du .NET-versionen till önskad version.

  3. Välj Spara. 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:

  1. Leta upp och välj din funktionsapp i Azure-portalen. På sidomenyn väljer du Inställningar>Konfiguration. Om du har ett mellanlagringsfack väljer du det specifika facket.

  2. På fliken Allmänna inställningar uppdaterar duNode.js Version till önskad version.

  3. Välj Spara. 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:

  1. Leta upp och välj din funktionsapp i Azure-portalen. På sidomenyn väljer du Inställningar>Konfiguration. Om du har ett mellanlagringsfack väljer du det specifika facket.

  2. På fliken Allmänna inställningar uppdaterar du PowerShell Core-versionen till önskad version.

  3. Välj Spara. När du får ett meddelande om en omstart väljer du Fortsätt.

Python-appar stöds inte i Windows. Gå till fliken Linux i stället.

Funktionsappen startas om när du har uppdaterat versionen.

Växla fack

Om du använder ett mellanlagringsfack för att distribuera kodprojektet och uppdatera inställningarna byter du mellanlagringsplatsen till produktion. Mer information finns i Växla fack.

Relaterat innehåll

Java-utvecklarguide

Processguide för isolerad C#-arbetsprocess

Node.js utvecklarguide

Python-utvecklarguide

Guide för PowerShell-utvecklare