Azure Functions futtatókörnyezet-verzió megcélzása

A függvényalkalmazások az Azure Functions-futtatókörnyezet egy adott verzióján futnak. Alapértelmezés szerint a függvényalkalmazások a Functions-futtatókörnyezet legújabb 4.x verziójában jönnek létre. A függvényalkalmazások csak akkor támogatottak, ha támogatott főverzión futnak. Ez a cikk azt ismerteti, hogyan konfigurálhat egy függvényalkalmazást az Azure-ban egy adott verzió megcélzására vagy rögzítésére , ha szükséges.

Egy adott verzió megcélzásának módja attól függ, hogy Windowst vagy Linuxot futtat- e. A cikk ezen verziója támogatja a Windowst. Válassza ki az operációs rendszert a cikk tetején.

Egy adott verzió megcélzásának módja attól függ, hogy Windowst vagy Linuxot futtat- e. A cikk ezen verziója támogatja a Linuxot. Válassza ki az operációs rendszert a cikk tetején.

Fontos

Ha lehetséges, mindig az Azure Functions-futtatókörnyezet legújabb támogatott verzióján futtassa a függvényeket. Csak akkor rögzítse az alkalmazást egy adott verzióra, ha erre a legújabb verzióval kapcsolatos probléma miatt utasítják. Mindig lépjen a legújabb futtatókörnyezeti verzióra, amint a függvények megfelelően futnak.

A helyi fejlesztés során az Azure Functions Core Tools telepített verziójának meg kell egyeznie az Azure-beli függvényalkalmazás által használt fő futtatókörnyezeti verzióval. További információ: Core Tools-verziók.

A futtatókörnyezet verziójának frissítése

Ha lehetséges, mindig az Azure Functions-futtatókörnyezet legújabb támogatott verzióján kell futtatnia a függvényalkalmazásokat. Ha a függvényalkalmazás jelenleg a futtatókörnyezet egy régebbi verzióján fut, át kell telepítenie az alkalmazást a 4.x verzióra

Ha az alkalmazás rendelkezik meglévő funkciókkal, óvintézkedéseket kell tennie, mielőtt egy későbbi fő futtatókörnyezeti verzióra vált. Az alábbi cikkek részletesen ismertetik a főbb verziók közötti kompatibilitástörő változásokat, beleértve a nyelvspecifikus kompatibilitástörő módosításokat is. Emellett részletes útmutatást is nyújtanak a meglévő függvényalkalmazás sikeres áttelepítéséhez.

• Migrálás a 3.x futtatókörnyezetből a 4.x-es verzióra
• Migrálás az 1.x futtatókörnyezetből a 4.x-es verzióra

Az aktuális futtatókörnyezeti verzió meghatározásához tekintse meg az aktuális futtatókörnyezeti verziót.

Az aktuális futtatókörnyezeti verzió megtekintése

A függvényalkalmazás aktuális futtatókörnyezeti verzióját az alábbi módokon tekintheti meg:

Azure Portal

A függvényalkalmazás által jelenleg használt futtatókörnyezeti verzió megtekintéséhez és frissítéséhez kövesse az alábbi lépéseket:

1. Az Azure Portalon keresse meg a függvényalkalmazást.

2. Bontsa ki a Beállítások elemet, majd válassza a Konfiguráció lehetőséget.

3. A Függvény futtatókörnyezet beállításai lapon jegyezze fel a futtatókörnyezet verzióját. Ebben a példában a verzió a következőre ~4van állítva: .

   

Azure CLI

Az alkalmazásbeállítást az FUNCTIONS_EXTENSION_VERSION Azure CLI-ből tekintheti meg.

Az Azure CLI használatával tekintse meg az aktuális futtatókörnyezeti verziót a az functionapp config appsettings list következő paranccsal:

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

Ebben a kódban cserélje le <function_app> a függvényalkalmazás nevére. Cserélje le <my_resource_group> a függvényalkalmazás erőforráscsoportjának nevét is.

A következő részleges kimenet jelenik meg FUNCTIONS_EXTENSION_VERSION :

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

Az előző kód példában a Cloud Shell megnyitása lehetőséget választva futtassa a parancsot az Azure Cloud Shellben. A parancs végrehajtásához helyileg is futtathatja az Azure CLI-t. Helyi futtatáskor először futtatnia az login kell a bejelentkezést.

Azure PowerShell

Az Azure Functions futtatókörnyezetének ellenőrzéséhez használja a következő parancsmagot:

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

Cserélje le <FUNCTION_APP> a függvényalkalmazás nevére és <RESOURCE_GROUP>a . A rendszer a FUNCTIONS_EXTENSION_VERSION beállítás aktuális értékét adja vissza a kivonattáblában.

Rögzítés egy adott verzióra

Az Azure Functions lehetővé teszi, hogy az FUNCTIONS_EXTENSION_VERSION alkalmazásbeállítással megcélozza az adott függvényalkalmazás által használt futtatókörnyezeti verziót. Ha csak a főverziót (~4) adja meg, a függvényalkalmazás automatikusan frissül a futtatókörnyezet új alverzióira, amint elérhetővé válnak. Az alverziófrissítések automatikusan befejeződnek, mert az új alverziók valószínűleg nem vezetnek be olyan módosításokat, amelyek megszakítják a függvényeket.

A Linux-alkalmazások a linuxFxVersion webhelybeállítást FUNCTIONS_EXTENSION_VERSION és a megfelelő Linux-alaprendszerképet használják a függvények futtatásához. Amikor új függvényalkalmazást hoz létre Linuxon, a futtatókörnyezet automatikusan kiválasztja a megfelelő alaprendszerképet a nyelvi verem futtatókörnyezeti verziója alapján.

Ha rögzít egy adott futtatókörnyezeti verziót, a függvényalkalmazás újraindul.

Ha egy adott alverziót (például 4.0.12345) FUNCTIONS_EXTENSION_VERSIONad meg, a függvényalkalmazás a futtatókörnyezet adott verziójára van rögzítve, amíg explicit módon vissza nem lép az automatikus verziófrissítésekre. Csak egy adott alverziót rögzíthet elég ideig, hogy elhárítsa a függvényalkalmazással kapcsolatos problémákat, amelyek megakadályozzák, hogy a főverziót célozza. A régebbi alverziók rendszeresen törlődnek az éles környezetből. Ha a függvényalkalmazás egy később eltávolított alverzióra van rögzítve, a függvényalkalmazás a legközelebbi meglévő verzión fut a megadott FUNCTIONS_EXTENSION_VERSIONverzió helyett. Az alverziók eltávolítását az App Service közleményei jelentik be.

Feljegyzés

Amikor a Visual Studióból egy olyan alkalmazásba próbál közzétenni, amely a futtatókörnyezet egy adott alverziójára van rögzítve, egy párbeszédpanel kéri, hogy frissítsen a legújabb verzióra, vagy mondja le a közzétételt. Ha el szeretné kerülni ezt az ellenőrzést, ha egy adott alverziót kell használnia, adja hozzá a <DisableFunctionExtensionVersionUpdate>true</DisableFunctionExtensionVersionUpdate> tulajdonságot a .csproj fájlhoz.

Az alábbi módszerek egyikével ideiglenesen rögzítheti az alkalmazást a futtatókörnyezet egy adott verziójára:

Azure Portal

A függvényalkalmazás által jelenleg használt futtatókörnyezeti verzió megtekintéséhez és frissítéséhez kövesse az alábbi lépéseket:

1. Az Azure Portalon keresse meg a függvényalkalmazást.

2. Bontsa ki a Beállítások elemet, majd válassza a Konfiguráció lehetőséget.

3. A Függvény futtatókörnyezet beállításai lapon jegyezze fel a futtatókörnyezet verzióját. Ebben a példában a verzió a következőre ~4van állítva: .

   

3. Ha az alkalmazást egy adott alverzióra szeretné rögzíteni, a bal oldali panelen bontsa ki a Beállítások elemet, majd válassza a Környezeti változók lehetőséget.

4. Az Alkalmazás beállításai lapon válassza a FUNCTIONS_EXTENSION_VERSION lehetőséget, módosítsa az Értéket a szükséges alverzióra, majd válassza az Alkalmaz lehetőséget.

5. Válassza az Alkalmaz lehetőséget, majd válassza a Megerősítés lehetőséget a módosítások alkalmazásához és az alkalmazás újraindításához.

Azure CLI

A függvényalkalmazás alkalmazásbeállítását FUNCTIONS_EXTENSION_VERSION az az functionapp config appsettings set paranccsal frissítheti.

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

Cserélje le <FUNCTION_APP> a függvényalkalmazás nevére és <RESOURCE_GROUP> a függvényalkalmazás erőforráscsoportjának nevére. Cserélje le <VERSION> azt az alverziót is, amelyre ideiglenesen szüksége van.

Az előző kód példában a Cloud Shell megnyitása lehetőséget választva futtassa a parancsot az Azure Cloud Shellben. A parancs végrehajtásához helyileg is futtathatja az Azure CLI-t. Helyi futtatáskor először futtatnia az login kell a bejelentkezést.

Azure PowerShell

Ezzel a szkripttel rögzítheti a Functions-futtatókörnyezetet:

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

Cserélje le <FUNCTION_APP> a függvényalkalmazás nevére és <RESOURCE_GROUP> a függvényalkalmazás erőforráscsoportjának nevére. Cserélje le <VERSION> azt az alverziót is, amelyre ideiglenesen szüksége van. A visszaadott kivonatoló táblában ellenőrizheti a FUNCTIONS_EXTENSION_VERSION beállítás frissített értékét.

A függvényalkalmazás az alkalmazásbeállítás módosítása után újraindul.

Ha a függvényalkalmazást Linuxon egy adott futtatókörnyezeti verzióra szeretné rögzíteni, a webhelybeállításban linuxFxVersion egy verzióspecifikus alaprendszerkép URL-címét kell beállítania a formátumbanDOCKER|<PINNED_VERSION_IMAGE_URI>.

Fontos

A Linuxon rögzített függvényalkalmazások nem kapnak rendszeres biztonsági és gazdagépfunkció-frissítéseket. Ha egy támogatási szakember nem javasolja, használja a beállítást és egy FUNCTIONS_EXTENSION_VERSION szabványos linuxFxVersion értéket a nyelvhez és a verzióhoz, például Python|3.9. Érvényes értékekért tekintse meg a referenciacikketlinuxFxVersion.

Egy adott futtatókörnyezetbe való rögzítés jelenleg nem támogatott a használatalapú csomagban futó Linux-függvényalkalmazások esetében.

Az alábbi példa egy linuxFxVersion Node.js 16-os függvényalkalmazásnak a 4.14.0.3 adott futtatókörnyezeti verziójához való rögzítéséhez szükséges értéket mutatja be:

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

Szükség esetén a támogatási szakember egy érvényes alaprendszerkép-URI-t biztosít az alkalmazáshoz.

A következő Azure CLI-parancsokkal tekintheti meg és állíthatja be a linuxFxVersion. Jelenleg nem állítható be linuxFxVersion a portálon vagy az Azure PowerShell használatával:

• Az aktuális futtatókörnyezeti verzió megtekintéséhez használja az az functionapp config show parancsot:

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

  Ebben a kódban cserélje le <function_app> a függvényalkalmazás nevére. Cserélje le <my_resource_group> a függvényalkalmazás erőforráscsoportjának nevére is. A függvény az aktuális értéket linuxFxVersion adja vissza.

• A függvényalkalmazás beállításának linuxFxVersion frissítéséhez használja az az functionapp config set parancsot:

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

  Cserélje le <FUNCTION_APP> a függvényalkalmazás nevére. Cserélje le <RESOURCE_GROUP> a függvényalkalmazás erőforráscsoportjának nevére is. Végül cserélje le <LINUX_FX_VERSION> egy támogatási szakember által adott kép értékét.

Ezeket a parancsokat az Azure Cloud Shellből futtathatja, ha az előző kód példákban az Open Cloud Shellt választja. Az Azure CLI-vel helyileg is végrehajthatja ezt a parancsot a az login bejelentkezés végrehajtása után.

A függvényalkalmazás a webhelykonfiguráció módosítása után újraindul.

Következő lépések

Kibocsátási megjegyzések futtatókörnyezeti verziókhoz