Ange körningsversion för Azure Functions

En funktionsapp körs på en specifik version av Azure Functions-körningen. Som standard skapas funktionsappar i den senaste 4.x-versionen av Functions-körningen. Dina funktionsappar stöds endast när de körs på en huvudversion som stöds. Den här artikeln beskriver hur du konfigurerar en funktionsapp i Azure för att rikta eller fästa en viss version vid behov.

Hur du riktar in dig på en viss version beror på om du kör Windows eller Linux. Den här versionen av artikeln stöder Windows. Välj ditt operativsystem överst i artikeln.

Hur du riktar in dig på en viss version beror på om du kör Windows eller Linux. Den här versionen av artikeln stöder Linux. Välj ditt operativsystem överst i artikeln.

Viktigt!

När det är möjligt kör du alltid dina funktioner på den senaste versionen av Azure Functions-körningen som stöds. Du bör bara fästa appen på en viss version om du uppmanas att göra det på grund av ett problem med den senaste versionen. Flytta alltid upp till den senaste körningsversionen så snart dina funktioner kan köras korrekt.

Under den lokala utvecklingen måste den installerade versionen av Azure Functions Core Tools matcha den större körningsversion som används av funktionsappen i Azure. Mer information finns i Core Tools-versioner.

Uppdatera körningsversionen

När det är möjligt bör du alltid köra dina funktionsappar på den senaste versionen av Azure Functions-körningen som stöds. Om din funktionsapp för närvarande körs på en äldre version av körningen bör du migrera appen till version 4.x

När appen har befintliga funktioner måste du vidta försiktighetsåtgärder innan du går över till en senare större körningsversion. I följande artiklar beskrivs icke-bakåtkompatibla ändringar mellan större versioner, inklusive språkspecifika icke-bakåtkompatibla ändringar. De ger dig också stegvisa instruktioner för en lyckad migrering av din befintliga funktionsapp.

• Migrera från körningsversion 3.x till version 4.x
• Migrera från körningsversion 1.x till version 4.x

Information om hur du fastställer din aktuella körningsversion finns i Visa den aktuella körningsversionen.

Visa den aktuella körningsversionen

Du kan visa den aktuella körningsversionen av funktionsappen på något av följande sätt:

Azure-portalen

Följ dessa steg om du vill visa och uppdatera körningsversionen som för närvarande används av en funktionsapp:

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

2. Expandera Inställningar och välj sedan Konfiguration.

3. På fliken Inställningar för funktionskörning noterar du Körningsversionen. I det här exemplet är versionen inställd på ~4.

   

Azure CLI

Du kan visa appinställningen FUNCTIONS_EXTENSION_VERSION från Azure CLI.

Med hjälp av Azure CLI visar du den aktuella körningsversionen med az functionapp config appsettings list kommandot :

az functionapp config appsettings list --name <function_app> \
--resource-group <my_resource_group>

I den här koden ersätter du <function_app> med namnet på funktionsappen. Ersätt <my_resource_group> även med namnet på resursgruppen för funktionsappen.

Du ser FUNCTIONS_EXTENSION_VERSION följande partiella utdata:

[
  {
    "name": "FUNCTIONS_EXTENSION_VERSION",
    "slotSetting": false,
    "value": "~4"
  },
  {
    "name": "FUNCTIONS_WORKER_RUNTIME",
    "slotSetting": false,
    "value": "dotnet"
  },
  
  ...
]

Välj Öppna Cloud Shell i föregående kodexempel för att köra kommandot i Azure Cloud Shell. Du kan också köra Azure CLI lokalt för att köra det här kommandot. När du kör lokalt måste du först köra az login för att logga in.

Azure PowerShell

Om du vill kontrollera Azure Functions-körningen använder du följande cmdlet:

Get-AzFunctionAppSetting -Name "<FUNCTION_APP>" -ResourceGroupName "<RESOURCE_GROUP>"

Ersätt <FUNCTION_APP> med namnet på funktionsappen och <RESOURCE_GROUP>. Det aktuella värdet för inställningen FUNCTIONS_EXTENSION_VERSION returneras i hash-tabellen.

Fäst på en specifik version

Med Azure Functions kan du använda appinställningen FUNCTIONS_EXTENSION_VERSION för att rikta in dig på körningsversionen som används av en viss funktionsapp. Om du bara anger huvudversionen (~4) uppdateras funktionsappen automatiskt till nya delversioner av körningen när de blir tillgängliga. Delversionsuppdateringar görs automatiskt eftersom nya delversioner sannolikt inte kommer att introducera ändringar som skulle bryta dina funktioner.

Linux-appar använder platsinställningen linuxFxVersion tillsammans med FUNCTIONS_EXTENSION_VERSION för att fastställa rätt Linux-basavbildning där du kan köra dina funktioner. När du skapar en ny funktionsapp i Linux väljer körningen automatiskt rätt basavbildning för dig baserat på körningsversionen av språkstacken.

Om du fäster på en specifik körningsversion startas funktionsappen om.

När du anger en specifik delversion (till exempel 4.0.12345) i FUNCTIONS_EXTENSION_VERSIONfästs funktionsappen på den specifika versionen av körningen tills du uttryckligen väljer att gå tillbaka till automatiska versionsuppdateringar. Du bör bara fästa på en viss delversion tillräckligt länge för att lösa eventuella problem med din funktionsapp som hindrar dig från att rikta in dig på huvudversionen. Äldre mindre versioner tas regelbundet bort från produktionsmiljön. När funktionsappen fästs på en delversion som senare tas bort körs funktionsappen i stället på den närmaste befintliga versionen i stället för den version som anges i FUNCTIONS_EXTENSION_VERSION. Mindre versionsborttagningar meddelas i App Service-meddelanden.

Kommentar

När du försöker publicera från Visual Studio till en app som är fäst på en viss delversion av körningen uppmanas du i en dialogruta att uppdatera till den senaste versionen eller avbryta publiceringen. Om du vill undvika den här kontrollen när du måste använda en viss delversion lägger du till <DisableFunctionExtensionVersionUpdate>true</DisableFunctionExtensionVersionUpdate> egenskapen i .csproj filen.

Använd någon av dessa metoder för att tillfälligt fästa appen på en viss version av körningen:

Azure-portalen

Följ dessa steg om du vill visa och uppdatera körningsversionen som för närvarande används av en funktionsapp:

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

2. Expandera Inställningar och välj sedan Konfiguration.

3. På fliken Inställningar för funktionskörning noterar du Körningsversionen. I det här exemplet är versionen inställd på ~4.

   

3. Om du vill fästa appen på en viss delversion expanderar du Inställningar i den vänstra rutan och väljer sedan Miljövariabler.

4. På fliken Appinställningar väljer du FUNCTIONS_EXTENSION_VERSION, ändrar Värde till den delversion som krävs och väljer sedan Använd.

5. Välj Använd och välj sedan Bekräfta för att tillämpa ändringarna och starta om appen.

Azure CLI

Du kan uppdatera appinställningen FUNCTIONS_EXTENSION_VERSION i funktionsappen med kommandot az functionapp config appsettings set .

az functionapp config appsettings set --name <FUNCTION_APP> \
--resource-group <RESOURCE_GROUP> \
--settings FUNCTIONS_EXTENSION_VERSION=<VERSION>

Ersätt <FUNCTION_APP> med namnet på funktionsappen och <RESOURCE_GROUP> med namnet på resursgruppen för funktionsappen. Ersätt <VERSION> också med den specifika delversion som du tillfälligt behöver rikta in dig på.

Välj Öppna Cloud Shell i föregående kodexempel för att köra kommandot i Azure Cloud Shell. Du kan också köra Azure CLI lokalt för att köra det här kommandot. När du kör lokalt måste du först köra az login för att logga in.

Azure PowerShell

Använd det här skriptet för att fästa Functions-körningen:

Update-AzFunctionAppSetting -Name "<FUNCTION_APP>" -ResourceGroupName "<RESOURCE_GROUP>" -AppSetting @{"FUNCTIONS_EXTENSION_VERSION" = "<VERSION>"} -Force

Ersätt <FUNCTION_APP> med namnet på funktionsappen och <RESOURCE_GROUP> med namnet på resursgruppen för funktionsappen. Ersätt <VERSION> också med den specifika delversion som du tillfälligt behöver rikta in dig på. Du kan kontrollera det uppdaterade värdet för FUNCTIONS_EXTENSION_VERSION inställningen i den returnerade hash-tabellen.

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

Om du vill fästa funktionsappen på en specifik körningsversion i Linux anger du en versionsspecifik basavbildnings-URL i webbplatsinställningen linuxFxVersion i formatet DOCKER|<PINNED_VERSION_IMAGE_URI>.

Viktigt!

Fästa funktionsappar i Linux får inte regelbundna uppdateringar av säkerhets- och värdfunktioner. Om du inte rekommenderas av en supportpersonal använder du FUNCTIONS_EXTENSION_VERSION inställningen och ett standardvärde linuxFxVersion för ditt språk och din version, till exempel Python|3.9. Giltiga värden finns i referensartikelnlinuxFxVersion.

Det går för närvarande inte att fästa vid en viss körning för Linux-funktionsappar som körs i en förbrukningsplan.

I följande exempel visas det linuxFxVersion värde som krävs för att fästa en Node.js 16-funktionsapp på en specifik körningsversion av 4.14.0.3:

DOCKER|mcr.microsoft.com/azure-functions/node:4.14.0.3-node16

När det behövs kan en supportpersonal ge dig en giltig basavbildnings-URI för ditt program.

Använd följande Azure CLI-kommandon för att visa och ange linuxFxVersion. Du kan för närvarande inte ange linuxFxVersion i portalen eller med hjälp av Azure PowerShell:

• Om du vill visa den aktuella körningsversionen använder du kommandot az functionapp config show :

  az functionapp config show --name <function_app> \
  --resource-group <my_resource_group> --query 'linuxFxVersion' -o tsv
  

  I den här koden ersätter du <function_app> med namnet på funktionsappen. Ersätt <my_resource_group> också med namnet på resursgruppen för funktionsappen. Det aktuella värdet linuxFxVersion för returneras.

• Om du vill uppdatera linuxFxVersion inställningen i funktionsappen använder du kommandot az functionapp config set :

  az functionapp config set --name <FUNCTION_APP> \
  --resource-group <RESOURCE_GROUP> \
  --linux-fx-version <LINUX_FX_VERSION>
  

  Ersätt <FUNCTION_APP> med namnet på funktionsappen. Ersätt <RESOURCE_GROUP> också med namnet på resursgruppen för funktionsappen. Ersätt slutligen <LINUX_FX_VERSION> med värdet för en specifik bild som tillhandahålls av en supportpersonal.

Du kan köra dessa kommandon från Azure Cloud Shell genom att välja Öppna Cloud Shell i föregående kodexempel. Du kan också använda Azure CLI lokalt för att köra det här kommandot när du az login har kört för att logga in.

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

Nästa steg

Viktig information för körningsversioner