Så här riktar du Azure Functions körningsversioner

En funktionsapp körs på en specifik version av Azure Functions-körningen. Det finns tre huvudversioner: 3.x, 2.x och 1.x. Som standard skapas funktionsappar i version 3.x av körningen. I den här artikeln förklaras hur du konfigurerar en funktionsapp i Azure så att den körs på den version du väljer. Information om hur du konfigurerar en lokal utvecklingsmiljö för en viss version finns i Koda och testa Azure Functions lokalt.

Hur du manuellt riktar in dig på en viss version beror på om du kör Windows eller Linux.

Automatiska och manuella versionsuppdateringar

Det här avsnittet gäller inte när du kör funktionsappen på Linux.

Azure Functions kan du ange en specifik version av körningen i Windows som mål med hjälp av FUNCTIONS_EXTENSION_VERSION programinställningen i en funktionsapp. Funktionsappen behålls på den angivna huvudversionen tills du uttryckligen väljer att flytta till en ny version. Om du bara anger huvudversionen uppdateras funktionsappen automatiskt till nya mindre versioner av körningen när de blir tillgängliga. Nya mindre versioner bör inte introducera större ändringar.

Om du anger en delversion (till exempel "2.0.12345") fästs funktionsappen på den specifika versionen tills du uttryckligen ändrar den. Äldre mindre versioner tas regelbundet bort från produktionsmiljön. Om delversionen tas bort går funktionsappen tillbaka till att köras på den senaste versionen i stället för den version som angetts i FUNCTIONS_EXTENSION_VERSION . Därför bör du snabbt lösa eventuella problem med funktionsappen som kräver en specifik delversion. Sedan kan du gå tillbaka till huvudversionen som mål. Mindre versionsborttagningar tillkännages i App Service meddelanden.

Anteckning

Om du fäster en viss huvudversion av Azure Functions och sedan försöker publicera till Azure med hjälp av Visual Studio visas ett dialogfönster där du uppmanas att uppdatera till den senaste versionen eller avbryta publiceringen. Undvik detta genom att lägga till <DisableFunctionExtensionVersionUpdate>true</DisableFunctionExtensionVersionUpdate> egenskapen i .csproj filen.

När en ny version är offentligt tillgänglig ger en uppmaning i portalen dig möjlighet att flytta upp till den versionen. När du har flyttat till en ny version kan du alltid använda FUNCTIONS_EXTENSION_VERSION programinställningen för att gå tillbaka till en tidigare version.

I följande tabell visas värdena FUNCTIONS_EXTENSION_VERSION för varje huvudversion för att aktivera automatiska uppdateringar:

Högre version FUNCTIONS_EXTENSION_VERSION Värde
3.x ~3
2.x ~2
1.x ~1

En ändring i körningsversionen gör att en funktionsapp startas om.

Anteckning

.NET-funktionsappar fästa för ~2.0 att välja bort den automatiska uppgraderingen till .NET Core 3.1. Mer information finns i Functions v2.x-överväganden.

Visa och uppdatera den aktuella körningsversionen

Det här avsnittet gäller inte när du kör funktionsappen på Linux.

Du kan ändra körningsversionen som används av funktionsappen. På grund av risken för större ändringar kan du bara ändra körningsversionen innan du har skapat några funktioner i funktionsappen.

Viktigt

Även om körningsversionen bestäms av inställningen bör du bara göra den här ändringen i Azure Portal inte FUNCTIONS_EXTENSION_VERSION genom att ändra inställningen direkt. Det beror på att portalen verifierar dina ändringar och gör andra relaterade ändringar efter behov.

Använd följande procedur för att visa och uppdatera den körningsversion som för närvarande används av en funktionsapp.

  1. I Azure-portalen bläddrar du till din funktionsapp.

  2. Under Inställningar väljer du konfiguration. Leta upp körnings versionen på fliken funktion körnings inställningar . Observera den aktuella körnings versionen. I exemplet nedan är versionen inställd på ~3.

    Visa körnings versionen.

  3. Om du vill fästa funktionsappen till version 1.x-körningen väljer du ~ 1 under Körningsversion. Den här växeln är inaktiverad när du har funktioner i appen.

  4. När du ändrar körningsversionen går du tillbaka till fliken Översikt och väljer Starta om för att starta om appen. Funktionsappen startar om och körs på version 1.x-körningen, och version 1.x-mallarna används när du skapar funktioner.

    Starta om din Function-app.

Anteckning

Med Azure Portal kan du inte ändra körningsversionen för en funktionsapp som redan innehåller funktioner.

Funktionsappen startas om efter att ändringen har gjorts i programinställningen.

Manuella versionsuppdateringar i Linux

Om du vill fästa en Linux-funktionsapp till en specifik värdversion anger du avbildnings-URL:en i fältet "LinuxFxVersion" i platskonfigurationen. Exempel: om vi vill fästa en nod 10-funktionsapp till exempel värdversion 3.0.13142 –

För Linux App Service/elastiska Premium-appar – Ställ LinuxFxVersion in på DOCKER|mcr.microsoft.com/azure-functions/node:3.0.13142-node10-appservice .

För appar med Linux-förbrukning – Ställ LinuxFxVersion in på DOCKER|mcr.microsoft.com/azure-functions/mesh:3.0.13142-node10 .

Visning och ändring av platskonfigurationsinställningar för funktionsappar stöds inte i Azure Portal. Använd Azure CLI i stället.

Funktionsappen startas om när ändringen har gjorts i platskonfigurationen.

Anteckning

För appar som körs i en förbrukningsplan kan LinuxFxVersion inställningen till en viss bild öka kallstartstiderna. Det beror på att om du fäster på en viss bild förhindrar Functions från att använda några kallstartsoptimeringar.

Nästa steg