Nyelvi veremverziók frissítése az Azure Functionsben

Az Azure Functions adott nyelvi veremeinek támogatása adott verziókra korlátozódik. Az új verziók elérhetővé válásával érdemes lehet frissíteni az alkalmazásokat, hogy kihasználhassák a szolgáltatásaikat. A Függvények támogatása a régebbi verziók esetében is megszűnhet, amelyek általában a közösségi támogatás megszűnésének ütemtervéhez igazodnak. Részletekért tekintse meg a nyelvi futtatókörnyezet támogatási szabályzatát . Annak érdekében, hogy az alkalmazások továbbra is támogatást kapjanak, a cikkben ismertetett utasításokat követve frissítse őket a legújabb elérhető verziókra.

A függvényalkalmazás frissítésének módja a következőtől függ:

• A függvények létrehozásához használt nyelv; ügyeljen arra, hogy a cikk tetején válassza ki a programozási nyelvet.
• Az az operációs rendszer, amelyen az alkalmazás az Azure-ban fut: Windows vagy Linux.
• Az üzemeltetési terv.

Feljegyzés

Ez a cikk bemutatja, hogyan frissítheti az alkalmazás .NET-verzióját az izolált feldolgozói modell használatával. A folyamatalapú modellel rendelkező .NET régebbi verzióin futó alkalmazások frissíthetnek a .NET 8-ra, vagy migrálhatnak a folyamatban lévő modellről az izolált feldolgozói modellre.

Felkészülés a frissítésre

Mielőtt frissítené a függvényalkalmazás veremkonfigurációját az Azure-ban, végezze el az alábbi feladatokat:

1. A függvények helyi ellenőrzése

Győződjön meg arról, hogy a függvénykódot helyileg teszteli és ellenőrzi az új célverzióban.

Az alábbi lépésekkel frissítheti a projektet a helyi számítógépen:

1. Győződjön meg arról, hogy telepítette a .NET SDK célverzióját.

   Ha előzetes verziót céloz meg, tekintse meg az előzetes verziójú .NET-verziókhoz tartozó Functions-útmutatót, és győződjön meg arról, hogy a verzió támogatott. A .NET-előzetes verziókhoz további lépésekre lehet szükség.

2. Frissítse a Microsoft.Azure.Functions.Worker és a Microsoft.Azure.Functions.Worker.Sdk legújabb verzióira mutató hivatkozásokat.

3. Frissítse a projekt cél-keretrendszerét az új verzióra. C#-projektek esetén frissítenie kell a <TargetFramework> fájl elemét .csproj . A kiválasztott verzióval kapcsolatos konkrétumokért tekintse meg a cél-keretrendszereket.

   A projekt célkeretének módosítása az eszközlánc egyes részeit is szükségessé teheti a projektkódon kívül. Előfordulhat például, hogy a VS Code-ban frissítenie kell a bővítménybeállítást a azureFunctions.deploySubpath felhasználói beállítások vagy a projekt fájlja .vscode/settings.json segítségével. A buildelési lépések vagy a CI/CD-folyamat részeként ellenőrizze, hogy vannak-e függőségek a keretrendszer verzióján, amelyek a projektkódon kívül is létezhetnek.

4. Végezze el a projekt kódjának az új .NET-verzióhoz szükséges frissítéseit. A részletekért tekintse meg a verzió kibocsátási megjegyzéseit. A .NET frissítési segéd használatával is frissítheti a kódot a főbb verziók változásaira reagálva.

Miután végrehajtotta ezeket a módosításokat, építse újra a projektet, és tesztelje, hogy az alkalmazás a várt módon fut-e.

2. Ugrás a legújabb Functions-futtatókörnyezetre

Győződjön meg arról, hogy a függvényalkalmazás a Functions-futtatókörnyezet legújabb verzióján fut (4.x verzió). A futtatókörnyezet verzióját az Azure Portalon vagy az Azure CLI használatával határozhatja meg.

Azure Portal

Az alábbi lépésekkel állapíthatja meg a Functions futtatókörnyezetének verzióját:

1. Az Azure Portalon keresse meg a függvényalkalmazást, és válassza a Konfiguráció lehetőséget a bal oldalon a Beállítások területen.

2. Válassza a Függvény futtatókörnyezet beállításai lapot, és ellenőrizze a Futtatókörnyezet verzióértékét , és ellenőrizze, hogy a függvényalkalmazás a Functions-futtatókörnyezet (~4)4.x verzióján fut-e.

   

Azure CLI

Ezzel a az functionapp config appsettings list paranccsal ellenőrizheti a futtatókörnyezet verzióját:

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

A FUNCTIONS_EXTENSION_VERSION beállítás beállítja a futtatókörnyezet verzióját. Az érték ~4 azt jelenti, hogy a függvényalkalmazás már a legújabb főverzió (4.x) legújabb alverzióján fut.

Ha először frissítenie kell a függvényalkalmazást a 4.x verzióra, olvassa el az Alkalmazások migrálása az Azure Functions 1.x-es verziójáról a 4.x-es verzióra vagy az Alkalmazások migrálása az Azure Functions 3.x-es verziójáról a 4.x-es verzióra című témakört. A beállítások módosítása FUNCTIONS_EXTENSION_VERSION helyett kövesse az ezekben a cikkekben található utasításokat.

Alkalmazásfrissítések közzététele

Ha úgy frissítette az alkalmazást, hogy megfelelően fusson az új verzión, tegye közzé az alkalmazásfrissítéseket, mielőtt frissíti a függvényalkalmazás veremkonfigurációját.

Tipp.

A frissítési folyamat egyszerűsítése, a függvények állásidejének minimalizálása és a visszaállítás lehetősége érdekében közzé kell tennie a frissített alkalmazást egy átmeneti ponton. További információ: Azure Functions üzembehelyezési pontok.

A frissített alkalmazás átmeneti ponton való közzétételekor mindenképpen kövesse a cikk többi részében található pontspecifikus frissítési utasításokat. Később felcserélheti a frissített előkészítési pontot az éles környezetbe.

A verem konfigurációjának frissítése

A veremkonfiguráció frissítésének módja attól függ, hogy Windowson vagy Linuxon fut-e az Azure-ban.

Előkészítési pont használata esetén ügyeljen arra, hogy a frissítéseket a megfelelő pontra célozza.

A Windows

A Java-verzió frissítéséhez kövesse az alábbi lépéseket:

1. Az Azure Portalon keresse meg a függvényalkalmazást, és válassza a Konfiguráció lehetőséget a bal oldalon. Előkészítési pont használata esetén először jelölje ki az adott pontot.

2. Az Általános beállítások lapon frissítse a Java-verziót a kívánt verzióra.

   

3. Válassza a Mentés lehetőséget, és ha értesítést kap az újraindításról, válassza a Folytatás lehetőséget.

A .NET-verzió frissítéséhez kövesse az alábbi lépéseket:

1. Az Azure Portalon keresse meg a függvényalkalmazást, és válassza a Konfiguráció lehetőséget a bal oldalon. Előkészítési pont használata esetén először jelölje ki az adott pontot.

2. Az Általános beállítások lapon frissítse a .NET-verziót a kívánt verzióra.

   

3. Válassza a Mentés lehetőséget, és ha értesítést kap az újraindításról, válassza a Folytatás lehetőséget.

A Node.js verziójának frissítéséhez kövesse az alábbi lépéseket:

1. Az Azure Portalon keresse meg a függvényalkalmazást, és válassza a Konfiguráció lehetőséget a bal oldalon. Előkészítési pont használata esetén először jelölje ki az adott pontot.

2. Az Általános beállítások lapon frissítse Node.js verziót a kívánt verzióra.

   

3. Válassza a Mentés lehetőséget, és ha értesítést kap az újraindításról, válassza a Folytatás lehetőséget. Ez a módosítás frissíti az WEBSITE_NODE_DEFAULT_VERSION alkalmazás beállításait.

A PowerShell-verzió frissítéséhez kövesse az alábbi lépéseket:

1. Az Azure Portalon keresse meg a függvényalkalmazást, és válassza a Konfiguráció lehetőséget a bal oldalon. Előkészítési pont használata esetén először jelölje ki az adott pontot.

2. Az Általános beállítások lapon frissítse a .NET-verziót a kívánt verzióra.

   

3. Válassza a Mentés lehetőséget, és ha értesítést kap az újraindításról, válassza a Folytatás lehetőséget.

A Python-alkalmazások windowsos használata nem támogatott. Válassza inkább a Linux lapot.

Linux

Feljegyzés

Az Azure Portal használatával csak prémium csomagban vagy dedikált (App Service-) csomagban üzemeltetett Linuxon futó függvényalkalmazásokat frissíthet. A használatalapú csomagban üzemeltetett Linux-alkalmazások esetében ehelyett az Azure CLI-t kell használnia.

A Java-verzió frissítéséhez kövesse az alábbi lépéseket:

1. Az Azure Portalon keresse meg a függvényalkalmazást, és válassza a Konfiguráció lehetőséget a bal oldalon. Előkészítési pont használata esetén először jelölje ki az adott pontot.

2. Az Általános beállítások lapon frissítse a Java-verziót a kívánt verzióra.

   

3. Válassza a Mentés lehetőséget, és ha értesítést kap az újraindításról, válassza a Folytatás lehetőséget.

A .NET-verzió frissítéséhez kövesse az alábbi lépéseket:

1. Az Azure Portalon keresse meg a függvényalkalmazást, és válassza a Konfiguráció lehetőséget a bal oldalon. Előkészítési pont használata esetén először jelölje ki az adott pontot.

2. Az Általános beállítások lapon frissítse a .NET-verziót a kívánt verzióra.

   

3. Válassza a Mentés lehetőséget, és ha értesítést kap az újraindításról, válassza a Folytatás lehetőséget.

A Node.js verziójának frissítéséhez kövesse az alábbi lépéseket:

1. Az Azure Portalon keresse meg a függvényalkalmazást, és válassza a Konfiguráció lehetőséget a bal oldalon. Előkészítési pont használata esetén először jelölje ki az adott pontot.

2. Az Általános beállítások lapon frissítse Node.js verziót a kívánt verzióra.

   

3. Válassza a Mentés lehetőséget, és ha értesítést kap az újraindításról, válassza a Folytatás lehetőséget. Ez a módosítás frissíti az WEBSITE_NODE_DEFAULT_VERSION alkalmazás beállításait.

A PowerShell-verzió frissítéséhez kövesse az alábbi lépéseket:

1. Az Azure Portalon keresse meg a függvényalkalmazást, és válassza a Konfiguráció lehetőséget a bal oldalon. Előkészítési pont használata esetén először jelölje ki az adott pontot.

2. Az Általános beállítások lapon frissítse a .NET-verziót a kívánt verzióra.

   

3. Válassza a Mentés lehetőséget, és ha értesítést kap az újraindításról, válassza a Folytatás lehetőséget.

A Python-alkalmazások windowsos használata nem támogatott. Válassza inkább a Linux lapot.

1. Az Azure Portalon keresse meg a függvényalkalmazást, és válassza a Konfiguráció lehetőséget a bal oldalon. Előkészítési pont használata esetén először jelölje ki az adott pontot.

2. Az Általános beállítások lapon frissítse a Python-verziót a kívánt verzióra.

   

   Feljegyzés

   A Python-verzió nem módosítható használatalapú csomagban való futtatáskor.

3. Válassza a Mentés lehetőséget, és ha értesítést kap az újraindításról, válassza a Folytatás lehetőséget.

A Windows

A Python-alkalmazások windowsos használata nem támogatott. Válassza inkább a Linux lapot.

Először a az functionapp list-runtimes paranccsal tekintse meg a nyelv támogatott verzióértékeit. Ezután futtassa a parancsot a az functionapp config set függvényalkalmazás nyelvi verziójának frissítéséhez:

Futtassa a az functionapp list-runtimes parancsot a .NET támogatott verzióértékeinek megtekintéséhez az izolált feldolgozómodellen:

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

Futtassa a az functionapp config set parancsot a függvényalkalmazás .NET-verziójának frissítéséhez:

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

Először a az functionapp list-runtimes parancs használatával tekintse meg a nyelvi verem támogatott verzióértékeit (Node.js). Ezután futtassa a parancsot a az functionapp config set függvényalkalmazás Node.js verziójának frissítéséhez:

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"  

Ebben a példában cserélje le és <RESOURCE_GROUP> írja be <APP_NAME> a függvényalkalmazás és az erőforráscsoport nevét. Cserélje le <VERSION> azt a támogatott nyelvi verziót is, amelyre frissít. Ha nem átmeneti pontot használ, távolítsa el a paramétert --slot .

Linux

Feljegyzés

A Python-verzió nem módosítható használatalapú csomagban való futtatáskor.

Futtassa a az functionapp list-runtimes parancsot a nyelvi verzió támogatott linuxFxVersion webhelybeállításainak megtekintéséhez:

Futtassa a az functionapp list-runtimes parancsot a nyelvi verem verziójának támogatott linuxFxVersion webhelybeállításainak megtekintéséhez:

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

Futtassa a az functionapp config set parancsot a függvényalkalmazás új nyelvi verziójának webhelybeállításának frissítéséhez:

Futtassa a az functionapp config set parancsot a függvényalkalmazás új veremverziójának webhelybeállításának frissítéséhez:

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

Ebben a példában cserélje le és <RESOURCE_GROUP> írja be <APP_NAME> a függvényalkalmazás és az erőforráscsoport nevét. Cserélje le <LANGUAGE|VERSION> a linuxFxVersion frissítésre is. Ha nem átmeneti pontot használ, távolítsa el a paramétert --slot .

A függvényalkalmazás a verzió frissítése után újraindul.

Pontok felcserélése

Ha elvégezte a kódprojekt üzembe helyezését és a beállítások frissítését egy átmeneti ponton, végül fel kell cserélnie az előkészítési pontot az éles környezetbe. További információ: Pontok felcserélése.

Következő lépések

Java fejlesztői útmutató

C# izolált feldolgozói folyamat útmutatója

Node.js fejlesztői útmutató

Python fejlesztői útmutató

A PowerShell fejlesztői útmutatója