Aktualizace verzí zásobníku jazyků ve službě Azure Functions

Článek
07/06/2024

Podpora libovolného zásobníku jazyka ve službě Azure Functions je omezená na konkrétní verze. Jakmile budou k dispozici nové verze, budete možná chtít aplikace aktualizovat, aby využívaly jejich funkce. Podpora ve službě Functions může také končit u starších verzí, obvykle v souladu s časovými osami ukončení komunity. Podrobnosti najdete v zásadách podpory modulu runtime jazyka. Pokud chcete zajistit, aby vaše aplikace nadále dostávaly podporu, měli byste je podle pokynů uvedených v tomto článku aktualizovat na nejnovější dostupné verze.

Způsob aktualizace aplikace funkcí závisí na:

Jazyk, který používáte k vytváření funkcí; nezapomeňte zvolit programovací jazyk v horní části článku.
Operační systém, na kterém vaše aplikace běží v Azure: Windows nebo Linux.
Plán hostování.

Poznámka:

V tomto článku se dozvíte, jak aktualizovat verzi aplikace .NET pomocí izolovaného pracovního modelu. Aplikace, které běží ve starších verzích .NET s modelem v procesu, se můžou aktualizovat na cíl .NET 8 nebo můžou migrovat z modelu v procesu do izolovaného pracovního modelu.

Příprava na aktualizaci

Než aktualizujete konfiguraci zásobníku pro vaši aplikaci funkcí v Azure, měli byste dokončit tyto úlohy:

1. Místní ověření funkcí

Ujistěte se, že kód funkce testujete a ověřujete místně v nové cílové verzi.

Pomocí následujícího postupu aktualizujte projekt na místním počítači:

Ujistěte se, že jste nainstalovali cílovou verzi sady .NET SDK.

Pokud cílíte na verzi Preview, projděte si pokyny ke službě Functions pro verze Preview .NET a ujistěte se, že je verze podporovaná. Pro verze Preview .NET se můžou vyžadovat další kroky.
Aktualizujte odkazy na nejnovější verze: Microsoft.Azure.Functions.Worker a Microsoft.Azure.Functions.Worker.Sdk.
Aktualizujte cílovou architekturu projektu na novou verzi. U projektů jazyka <TargetFramework> C# je nutné aktualizovat prvek v .csproj souboru. Podrobnosti týkající se zvolené verze najdete v cílových architekturách .

Změna cílové architektury projektu může také vyžadovat změny částí sady nástrojů mimo kód projektu. V nástroji VS Code může být například potřeba aktualizovat azureFunctions.deploySubpath nastavení rozšíření prostřednictvím uživatelských nastavení nebo souboru projektu .vscode/settings.json . V rámci kroků sestavení nebo kanálu CI/CD zkontrolujte všechny závislosti na verzi architektury, které můžou existovat mimo kód projektu.
Proveďte všechny aktualizace kódu projektu, které vyžaduje nová verze .NET. Konkrétní informace najdete v poznámkách k verzi verze. Pomocníka pro upgrade platformy .NET můžete použít také k aktualizaci kódu v reakci na změny ve velkých verzích.

Po provedení těchto změn znovu sestavte projekt a otestujte ho, abyste potvrdili, že vaše aplikace běží podle očekávání.

2. Přechod na nejnovější modul runtime Functions

Ujistěte se, že je vaše aplikace funkcí spuštěná na nejnovější verzi modulu runtime Služby Functions (verze 4.x). Verzi modulu runtime můžete určit na webu Azure Portal nebo pomocí Azure CLI.

Azure Portal
Azure CLI

K určení verze modulu runtime služby Functions použijte tento postup:

Na webu Azure Portal vyhledejte aplikaci funkcí a na levé straně v části Nastavení vyberte Možnost Konfigurace.
Vyberte kartu Nastavení modulu runtime funkce a zkontrolujte hodnotu verze modulu runtime, abyste zjistili, jestli je vaše aplikace funkcí spuštěná ve verzi 4.x modulu runtime služby Functions (~4).

Pomocí tohoto az functionapp config appsettings list příkazu zkontrolujte verzi modulu runtime:

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

Nastavení FUNCTIONS_EXTENSION_VERSION nastaví verzi modulu runtime. Hodnota ~4 znamená, že vaše aplikace funkcí už běží na nejnovější podverzi nejnovější hlavní verze (4.x).

Pokud potřebujete nejprve aktualizovat aplikaci funkcí na verzi 4.x, přečtěte si téma Migrace aplikací z Azure Functions verze 1.x na verzi 4.x nebo Migrace aplikací z Azure Functions verze 3.x na verzi 4.x. Měli byste postupovat podle pokynů v těchto článcích, a ne jenom měnit FUNCTIONS_EXTENSION_VERSION nastavení.

Publikování aktualizací aplikací

Pokud jste aplikaci aktualizovali tak, aby běžela správně na nové verzi, publikujte aktualizace aplikace před aktualizací konfigurace zásobníku pro vaši aplikaci funkcí.

Tip

Pokud chcete zjednodušit proces aktualizace, minimalizovat výpadky vašich funkcí a poskytnout potenciál pro vrácení zpět, měli byste aktualizovanou aplikaci publikovat do přípravného slotu. Další informace najdete v tématu Sloty nasazení služby Azure Functions.

Při publikování aktualizované aplikace do přípravného slotu nezapomeňte postupovat podle pokynů pro aktualizaci konkrétního slotu ve zbývající části tohoto článku. Později aktualizovaný přípravný slot prohodíte do produkčního prostředí.

Aktualizace konfigurace zásobníku

Způsob aktualizace konfigurace zásobníku závisí na tom, jestli používáte Windows nebo Linux v Azure.

Při použití přípravného slotu nezapomeňte aktualizace cílit na správný slot.

K aktualizaci verze Javy použijte následující postup:

Na webu Azure Portal vyhledejte aplikaci funkcí a na levé straně vyberte Možnost Konfigurace . Při použití přípravného slotu nezapomeňte nejprve vybrat konkrétní slot.
Na kartě Obecné nastavení aktualizujte verzi Javy na požadovanou verzi.
Vyberte Uložit a až se zobrazí oznámení o restartování, vyberte Pokračovat.

K aktualizaci verze .NET použijte následující postup:

Na webu Azure Portal vyhledejte aplikaci funkcí a na levé straně vyberte Možnost Konfigurace . Při použití přípravného slotu nezapomeňte nejprve vybrat konkrétní slot.
Na kartě Obecné nastavení aktualizujte verzi .NET na požadovanou verzi.
Vyberte Uložit a až se zobrazí oznámení o restartování, vyberte Pokračovat.

Pomocí následujících kroků aktualizujte verzi Node.js:

Na webu Azure Portal vyhledejte aplikaci funkcí a na levé straně vyberte Možnost Konfigurace . Při použití přípravného slotu nezapomeňte nejprve vybrat konkrétní slot.
Na kartě Obecné nastavení aktualizujte Node.js verzi na požadovanou verzi.
Vyberte Uložit a až se zobrazí oznámení o restartování, vyberte Pokračovat. Tato změna aktualizuje WEBSITE_NODE_DEFAULT_VERSION nastavení aplikace.

K aktualizaci verze PowerShellu použijte následující postup:

Na webu Azure Portal vyhledejte aplikaci funkcí a na levé straně vyberte Možnost Konfigurace . Při použití přípravného slotu nezapomeňte nejprve vybrat konkrétní slot.
Na kartě Obecné nastavení aktualizujte verzi .NET na požadovanou verzi.
Vyberte Uložit a až se zobrazí oznámení o restartování, vyberte Pokračovat.

Aplikace v Pythonu nejsou ve Windows podporované. Místo toho vyberte kartu Linux.

Poznámka:

K aktualizaci aplikací funkcí v Linuxu hostovaných v plánu Premium nebo plánu Dedicated (App Service) můžete použít jenom Azure Portal. U aplikací v Linuxu hostovaných v plánu Consumption musíte místo toho použít Azure CLI.

K aktualizaci verze Javy použijte následující postup:

Na webu Azure Portal vyhledejte aplikaci funkcí a na levé straně vyberte Možnost Konfigurace . Při použití přípravného slotu nezapomeňte nejprve vybrat konkrétní slot.
Na kartě Obecné nastavení aktualizujte verzi Javy na požadovanou verzi.
Vyberte Uložit a až se zobrazí oznámení o restartování, vyberte Pokračovat.

K aktualizaci verze .NET použijte následující postup:

Na webu Azure Portal vyhledejte aplikaci funkcí a na levé straně vyberte Možnost Konfigurace . Při použití přípravného slotu nezapomeňte nejprve vybrat konkrétní slot.
Na kartě Obecné nastavení aktualizujte verzi .NET na požadovanou verzi.
Vyberte Uložit a až se zobrazí oznámení o restartování, vyberte Pokračovat.

Pomocí následujících kroků aktualizujte verzi Node.js:

Na webu Azure Portal vyhledejte aplikaci funkcí a na levé straně vyberte Možnost Konfigurace . Při použití přípravného slotu nezapomeňte nejprve vybrat konkrétní slot.
Na kartě Obecné nastavení aktualizujte Node.js verzi na požadovanou verzi.
Vyberte Uložit a až se zobrazí oznámení o restartování, vyberte Pokračovat. Tato změna aktualizuje WEBSITE_NODE_DEFAULT_VERSION nastavení aplikace.

K aktualizaci verze PowerShellu použijte následující postup:

Na webu Azure Portal vyhledejte aplikaci funkcí a na levé straně vyberte Možnost Konfigurace . Při použití přípravného slotu nezapomeňte nejprve vybrat konkrétní slot.
Na kartě Obecné nastavení aktualizujte verzi .NET na požadovanou verzi.
Vyberte Uložit a až se zobrazí oznámení o restartování, vyberte Pokračovat.

Aplikace v Pythonu nejsou ve Windows podporované. Místo toho vyberte kartu Linux.

Na webu Azure Portal vyhledejte aplikaci funkcí a na levé straně vyberte Možnost Konfigurace . Při použití přípravného slotu nezapomeňte nejprve vybrat konkrétní slot.
Na kartě Obecné nastavení aktualizujte verzi Pythonu na požadovanou verzi.

Poznámka:

Verzi Pythonu nemůžete změnit při spuštění v plánu Consumption.
Vyberte Uložit a až se zobrazí oznámení o restartování, vyberte Pokračovat.

Aplikace v Pythonu nejsou ve Windows podporované. Místo toho vyberte kartu Linux.

Nejprve pomocí az functionapp list-runtimes příkazu zobrazte podporované hodnoty verzí pro váš jazyk. Potom spuštěním az functionapp config set příkazu aktualizujte jazyková verze vaší aplikace funkcí:

Spuštěním az functionapp list-runtimes příkazu zobrazte podporované hodnoty verzí pro .NET v izolovaném pracovním modelu:

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

Spuštěním az functionapp config set příkazu aktualizujte verzi aplikace funkcí .NET:

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

Nejprve pomocí az functionapp list-runtimes příkazu zobrazte podporované hodnoty verzí pro váš zásobník jazyků (Node.js). Potom spuštěním az functionapp config set příkazu aktualizujte Node.js verzi vaší aplikace funkcí:

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"

V tomto příkladu nahraďte <APP_NAME> a <RESOURCE_GROUP> zadejte název vaší aplikace funkcí a skupiny prostředků. Nahraďte <VERSION> také podporovanou jazykovou verzi, na kterou aktualizujete. Pokud nepoužíváte přípravný slot, odeberte --slot parametr.

Poznámka:

Verzi Pythonu nemůžete změnit při spuštění v plánu Consumption.

Spuštěním az functionapp list-runtimes příkazu zobrazte podporované linuxFxVersion nastavení webu pro vaši jazykovou verzi:

Spuštěním az functionapp list-runtimes příkazu zobrazte podporované linuxFxVersion nastavení webu pro vaši verzi sady jazyků:

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

Spuštěním az functionapp config set příkazu aktualizujte nastavení webu pro novou jazyková verzi vaší aplikace funkcí:

Spuštěním az functionapp config set příkazu aktualizujte nastavení webu pro novou verzi vaší aplikace funkcí:

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

V tomto příkladu nahraďte <APP_NAME> a <RESOURCE_GROUP> zadejte název vaší aplikace funkcí a skupiny prostředků. Nahraďte <LANGUAGE|VERSION> linuxFxVersion také aktualizací. Pokud nepoužíváte přípravný slot, odeberte --slot parametr.

Po aktualizaci verze se vaše aplikace funkcí restartuje.

Prohození slotů

Pokud provádíte nasazení projektu kódu a aktualizujete nastavení v přípravném slotu, budete nakonec muset přípravný slot prohodit do produkčního prostředí. Další informace najdete v tématu Prohození slotů.