Přehled verzí modulu runtime Azure Functions

Článek
03/19/2024

Aplikace funkcí běží na konkrétní verzi modulu runtime Azure Functions. Ve výchozím nastavení se aplikace funkcí vytvářejí v nejnovější verzi modulu runtime Functions 4.x. Vaše aplikace funkcí se podporují jenom v podporované hlavní verzi. Tento článek vysvětluje, jak nakonfigurovat aplikaci funkcí v Azure tak, aby cílila nebo připnula konkrétní verzi v případě potřeby.

Způsob, jakým cílíte na konkrétní verzi, závisí na tom, jestli používáte Windows nebo Linux. Tato verze článku podporuje Windows. V horní části článku vyberte svůj operační systém.

Způsob, jakým cílíte na konkrétní verzi, závisí na tom, jestli používáte Windows nebo Linux. Tato verze článku podporuje Linux. V horní části článku vyberte svůj operační systém.

Důležité

Pokud je to možné, měli byste vždy spouštět funkce na nejnovější podporované verzi modulu runtime Azure Functions. Aplikaci byste měli připnout jenom na konkrétní verzi, když k tomu dáte pokyn kvůli problému v nejnovější verzi. Vždy byste měli přejít na nejnovější verzi modulu runtime, jakmile budou vaše funkce moct správně běžet.

Během místního vývoje musí nainstalovaná verze nástrojů Azure Functions Core Tools odpovídat hlavní verzi modulu runtime používanou aplikací funkcí v Azure. Další informace najdete v tématu Verze nástrojů Core Tools.

Aktualizace verze modulu runtime

Pokud je to možné, měli byste vždy spouštět aplikace funkcí na nejnovější podporované verzi modulu runtime Azure Functions. Pokud je vaše aplikace funkcí aktuálně spuštěná ve starší verzi modulu runtime, měli byste aplikaci migrovat na verzi 4.x.

Pokud má vaše aplikace existující funkce, musíte před přechodem na novější hlavní verzi modulu runtime provést preventivní opatření. Následující články popisují zásadní změny mezi hlavními verzemi, včetně zásadních změn specifických pro jednotlivé jazyky. Poskytují také podrobné pokyny pro úspěšnou migraci vaší stávající aplikace funkcí.

Pokud chcete zjistit aktuální verzi modulu runtime, přečtěte si téma Zobrazení aktuální verze modulu runtime.

Zobrazení aktuální verze modulu runtime

Aktuální verzi modulu runtime aplikace funkcí můžete zobrazit jedním z těchto způsobů:

Následující postup slouží k zobrazení a aktualizaci verze modulu runtime, kterou aktuálně používá aplikace funkcí.

Na webu Azure Portal přejděte do aplikace funkcí.
V části Nastavení zvolte Konfigurace. Na kartě Nastavení modulu runtime funkce vyhledejte verzi modulu runtime. Poznamenejte si konkrétní verzi modulu runtime. V následujícím příkladu je verze nastavena na ~4.

Můžete se podívat FUNCTIONS_EXTENSION_VERSION z Azure CLI.

Pomocí Azure CLI zobrazte aktuální verzi modulu runtime pomocí az functionapp config appsettings list příkazu.

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

V tomto kódu nahraďte <function_app> názvem vaší aplikace funkcí. Nahraďte <my_resource_group> také názvem skupiny prostředků pro vaši aplikaci funkcí.

Zobrazí se FUNCTIONS_EXTENSION_VERSION následující výstup, který byl zkrácen pro přehlednost:

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

V předchozím příkladu kódu zvolte Otevřít Cloud Shell a spusťte příkaz v Azure Cloud Shellu. Spuštěním tohoto příkazu můžete také místně spustit Azure CLI. Při místním spuštění musíte nejprve spustit az login přihlášení.

Pokud chcete zkontrolovat modul runtime Azure Functions, použijte následující rutinu:

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

Nahraďte <FUNCTION_APP> názvem vaší aplikace funkcí a <RESOURCE_GROUP>. Aktuální hodnota FUNCTIONS_EXTENSION_VERSION nastavení se vrátí v tabulce hash.

Připnutí na konkrétní verzi

Azure Functions umožňuje použít FUNCTIONS_EXTENSION_VERSION nastavení aplikace k cílení na verzi modulu runtime používanou danou aplikací funkcí. Pokud zadáte jenom hlavní verzi (~4), aplikace funkcí se automaticky aktualizuje na nové podverze modulu runtime, jakmile budou dostupné. Aktualizace podverze se provádějí automaticky, protože nové podverze by neměly zavádět zásadní změny.

Aplikace pro Linux používají linuxFxVersion nastavení webu spolu s FUNCTIONS_EXTENSION_VERSION určením správné základní image Linuxu, ve které se mají spouštět funkce. Při vytváření nové aplikace funtion v Linuxu modul runtime automaticky zvolí správnou základní image na základě verze modulu runtime vašeho zásobníku jazyků.

Připnutí na konkrétní verzi modulu runtime způsobí restartování aplikace funkcí.

Když zadáte konkrétní podverzi (například 4.0.12345) v FUNCTIONS_EXTENSION_VERSION, aplikace funkcí se připne k této konkrétní verzi modulu runtime, dokud se explicitně nerozhodnete přejít zpět na automatické aktualizace. Měli byste připnout jenom na konkrétní podverzi dostatečně dlouho, abyste vyřešili všechny problémy s vaší aplikací funkcí, které vám brání v cílení na hlavní verzi. Starší podverze se pravidelně odebírají z produkčního prostředí. Když jste připnuti k podverzi, která se odebere, vaše aplikace funkcí se místo verze nastavené v FUNCTIONS_EXTENSION_VERSIONaplikaci funkcí spustí na nejbližší existující verzi. Odebrání podverze se oznamuje v oznámeních služby App Service.

Poznámka:

Když se pokusíte publikovat ze sady Visual Studio do aplikace, která je připnutá ke konkrétní podverzi modulu runtime, zobrazí se dialogové okno s výzvou k aktualizaci na nejnovější verzi nebo zrušení publikování. Pokud se chcete této kontrole vyhnout, musíte použít konkrétní podverzi, přidejte do <DisableFunctionExtensionVersionUpdate>true</DisableFunctionExtensionVersionUpdate> souboru vlastnost .csproj .

K dočasnému připnutí aplikace na konkrétní verzi modulu runtime použijte jednu z těchto metod:

Následující postup slouží k zobrazení a aktualizaci verze modulu runtime, kterou aktuálně používá aplikace funkcí.

Na webu Azure Portal přejděte do aplikace funkcí.
V části Nastavení zvolte Konfigurace. Na kartě Nastavení modulu runtime funkce vyhledejte verzi modulu runtime. Poznamenejte si konkrétní verzi modulu runtime. V následujícím příkladu je verze nastavena na ~4.

Pokud chcete aplikaci připnout na konkrétní podverzi, vyberte nastavení>aplikace FUNCTIONS_EXTENSION_VERSION, změňte hodnotu na požadovanou podverzi a vyberte OK.
Výběrem možnosti Uložit>pokračovat použijte změny a restartujte aplikaci.

Nastavení v aplikaci funkcí můžete aktualizovat FUNCTIONS_EXTENSION_VERSION příkazem az functionapp config appsettings set .

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

Zvolte Vyzkoušet v předchozím příkladu kódu a spusťte příkaz v Azure Cloud Shellu. Spuštěním tohoto příkazu můžete také místně spustit Azure CLI. Při místním spuštění musíte nejprve spustit az login přihlášení.

Tento skript použijte k připnutí modulu runtime Služby Functions:

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

Nahraďte <FUNCTION_APP> názvem vaší aplikace funkcí a <RESOURCE_GROUP> názvem skupiny prostředků pro vaši aplikaci funkcí. Nahraďte <VERSION> také konkrétní podverzi, na kterou dočasně potřebujete cílit. Aktualizovanou hodnotu FUNCTIONS_EXTENSION_VERSION nastavení můžete ověřit ve vrácené tabulce hash.

Aplikace funkcí se restartuje po provedení změny nastavení aplikace.

Pokud chcete připnout aplikaci funkcí na konkrétní verzi modulu runtime v Linuxu, nastavíte adresu URL základní image specifickou pro verzi v linuxFxVersion nastavení webu ve formátu DOCKER|<PINNED_VERSION_IMAGE_URI>.

Důležité

Připnuté aplikace funkcí v Linuxu nedostávají pravidelné aktualizace zabezpečení a hostování funkcí. Pokud ji nedoporučuje pracovník podpory, použijte FUNCTIONS_EXTENSION_VERSION nastavení a standardní linuxFxVersion hodnotu pro váš jazyk a verzi, například Python|3.9. Platné hodnoty najdete v referenčním linuxFxVersion článku.

Připnutí na konkrétní modul runtime se v současné době nepodporuje pro aplikace funkcí linuxu spuštěné v plánu Consumption.

Následuje příklad linuxFxVersion hodnoty potřebné k připnutí aplikace funkcí Node.js 16 na konkrétní verzi modulu runtime 4.14.0.3:

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

V případě potřeby vám může pracovník podpory poskytnout platný identifikátor URI základní image pro vaši aplikaci.

K zobrazení a nastavení linuxFxVersionpříkazu Azure CLI použijte následující příkazy Azure CLI. Aktuálně nemůžete nastavit linuxFxVersion na portálu nebo pomocí Azure PowerShellu.

Pokud chcete zobrazit aktuální verzi modulu runtime, použijte příkaz az functionapp config show .
```
az functionapp config show --name <function_app> \
--resource-group <my_resource_group> --query 'linuxFxVersion' -o tsv
```
V tomto kódu nahraďte <function_app> názvem vaší aplikace funkcí. Nahraďte <my_resource_group> také názvem skupiny prostředků pro vaši aplikaci funkcí. Vrátí se aktuální hodnota linuxFxVersion .
Pokud chcete aktualizovat linuxFxVersion nastavení v aplikaci funkcí, použijte příkaz az functionapp config set .
```
az functionapp config set --name <FUNCTION_APP> \
--resource-group <RESOURCE_GROUP> \
--linux-fx-version <LINUX_FX_VERSION>
```
Nahraďte <FUNCTION_APP> názvem vaší aplikace funkcí. Nahraďte <RESOURCE_GROUP> také názvem skupiny prostředků pro vaši aplikaci funkcí. Nakonec nahraďte <LINUX_FX_VERSION> hodnotou konkrétního obrázku poskytnutého pracovníkem podpory.

Tyto příkazy můžete spustit z Azure Cloud Shellutak, že v předchozích příkladech kódu zvolíte Open Cloud Shell. Tento příkaz můžete spustit také místně pomocí Azure CLI po spuštění az login a přihlásit se.

Aplikace funkcí se restartuje po provedení změny konfigurace webu.

Další kroky

Viz poznámky k verzi pro verze modulu runtime

Přehled verzí modulu runtime Azure Functions

Aktualizace verze modulu runtime

Zobrazení aktuální verze modulu runtime

Připnutí na konkrétní verzi

Další kroky

Další materiály