Azure Functions – alkalmazásbeállítási referencia

Cikk
01/13/2024

A függvényalkalmazás alkalmazásbeállításai olyan konfigurációs beállításokat tartalmaznak, amelyek az adott függvényalkalmazás összes függvényét érintik. Ezek a beállítások környezeti változókként érhetők el. Ez a cikk a függvényalkalmazásokban elérhető alkalmazásbeállításokat sorolja fel.

A függvényalkalmazás beállításai többféleképpen is hozzáadhatók, frissíthetők és törölhetők:

A függvényalkalmazás beállításainak módosításához újra kell indítani a függvényalkalmazást.

Ebben a cikkben a kapcsolati sztring értékek csonkolva jelennek meg az olvashatóság érdekében.

Alkalmazásbeállítási szempontok

Az alkalmazásbeállítások használatakor a következő szempontokat kell figyelembe vennie:

A függvényalkalmazás beállításainak módosításához újra kell indítani a függvényalkalmazást.
A beállításnevekben a dupla aláhúzás (__) és a pontosvessző (:) fenntartott értéknek minősül. A dupla aláhúzások hierarchikus elválasztóként vannak értelmezve Windowson és Linuxon is, a kettőspontokat pedig ugyanúgy értelmezi a rendszer, csak Linuxon. A beállítás AzureFunctionsWebHost__hostid=somehost_123456 például a következő JSON-objektumként lesz értelmezve:
```
"AzureFunctionsWebHost": {
    "hostid": "somehost_123456"
}
```
Ebben a cikkben csak dupla aláhúzásjeleket használunk, mivel mindkét operációs rendszeren támogatottak. A felügyelt identitáskapcsolatokat támogató legtöbb beállítás dupla aláhúzásjeleket használ.
Amikor a Functions helyileg fut, az alkalmazásbeállításokat a Values local.settings.json gyűjteményében adhatja meg.
A host.json fájlban és a local.settings.json fájlban más függvényalkalmazás-konfigurációs beállítások is találhatók.
Az alkalmazásbeállítások segítségével felülbírálhatja host.json beállításértékeket anélkül, hogy magát a host.json fájlt kellene módosítania. Ez olyan helyzetekben hasznos, amikor egy adott környezet adott host.json beállításait kell konfigurálnia vagy módosítania. Ez lehetővé teszi host.json beállítások módosítását anélkül, hogy újra közzé kellene tennie a projektet. További információ: host.json referenciacikk.
Ez a cikk a függvényalkalmazások szempontjából legrelevánsabb beállításokat ismerteti. Mivel az Azure Functions az App Service-en fut, más alkalmazásbeállítások is támogatottak. További információ: Környezeti változók és alkalmazásbeállítások a Azure-alkalmazás Szolgáltatásban.
Egyes helyzetekben az App Service-webhely beállításaiban dokumentált beállításokkal is dolgoznia kell.
Az írásvédett App Service-alkalmazásokbeállításainak módosítása nem válaszoló állapotba helyezheti a függvényalkalmazást.
Ügyeljen arra, hogy az alkalmazásbeállítások REST API-kkal, köztük ARM-sablonokkal frissítve frissülnek. Mivel ezek az API-k felülírják a meglévő alkalmazásbeállításokat, a BEÁLLÍTÁSOK REST API-k vagy ARM-sablonok használatával történő hozzáadásakor vagy módosításakor minden meglévő beállítást meg kell adnia. Ha lehetséges, az Azure CLI vagy az Azure PowerShell használatával programozott módon használhatja az alkalmazásbeállításokat. További információ: Az alkalmazásbeállítások használata.

APPINSIGHTS_INSTRUMENTATIONKEY

Az Application Elemzések eszközkulcsa. Ne használja mindkettőt APPINSIGHTS_INSTRUMENTATIONKEY és APPLICATIONINSIGHTS_CONNECTION_STRING. Ha lehetséges, használja a következőt APPLICATIONINSIGHTS_CONNECTION_STRING: . Ha az alkalmazás Elemzések szuverén felhőben fut, akkor azt kell használniaAPPLICATIONINSIGHTS_CONNECTION_STRING. További információkért tekintse meg az Azure Functions monitorozásának konfigurálását ismertető témakört.

Kulcs	Mintaérték
APPINSIGHTS_INSTRUMENTATIONKEY	`55555555-af77-484b-9032-64f83bb83bb`

Ne használja mindkettőt APPINSIGHTS_INSTRUMENTATIONKEY és APPLICATIONINSIGHTS_CONNECTION_STRING. APPLICATIONINSIGHTS_CONNECTION_STRING Használata ajánlott.

Feljegyzés

2025. március 31-én megszűnik az eszközkulcsalapú betöltés támogatása. A rendszerállapot-kulcsok betöltése továbbra is működni fog, de a továbbiakban nem biztosítunk frissítéseket vagy támogatást a funkcióhoz. Váltás kapcsolati sztring az új képességek kihasználásához.

APPLICATIONINSIGHTS_CONNECTION_STRING

Az Alkalmazás Elemzések kapcsolati sztring. Ne használja mindkettőt APPINSIGHTS_INSTRUMENTATIONKEY és APPLICATIONINSIGHTS_CONNECTION_STRING. Bár a használat APPLICATIONINSIGHTS_CONNECTION_STRING minden esetben ajánlott, a következő esetekben szükséges:

Ha a függvényalkalmazás a kapcsolati sztring használatával támogatott hozzáadott testreszabásokat igényel.
Ha az alkalmazás Elemzések példány szuverén felhőben fut, amelyhez egyéni végpont szükséges.

További információ: Csatlakozás ion sztringek.

Kulcs	Mintaérték
APPLICATIONINSIGHTS_CONNECTION_STRING	`InstrumentationKey=...`

AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL

Fontos

Az Azure Functions-proxyk az Azure Functions-futtatókörnyezet 1.x és 3.x verzióinak örökölt funkciói. A 4.x verzió örökölt támogatásával kapcsolatos további információkért lásd a Functions proxykat.

Alapértelmezés szerint a Függvény-proxyk parancsikon használatával api-hívásokat küldhetnek a proxykról közvetlenül az ugyanabban a függvényalkalmazásban található függvényekre. Ez a parancsikon új HTTP-kérés létrehozása helyett használható. Ezzel a beállítással letilthatja a parancsikon viselkedését.

Kulcs	Érték	Leírás
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL	`true`	A helyi függvényalkalmazás egyik függvényére mutató háttér-URL-címmel rendelkező hívások nem lesznek közvetlenül a függvénynek küldve. Ehelyett a rendszer visszairányítja a kéréseket a függvényalkalmazás HTTP-előtérére.
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL	`false`	A helyi függvényalkalmazás egyik függvényére mutató háttér URL-címmel rendelkező hívások közvetlenül a függvénynek lesznek továbbítva. `false` az alapértelmezett érték.

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES

Fontos

Ez a beállítás azt szabályozza, hogy a karakterek %2F perjelekként vannak-e dekódolva az útvonalparaméterekben, amikor beszúrják őket a háttérBELI URL-címre.

Kulcs	Érték	Leírás
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES	`true`	A kódolt perjelekkel rendelkező útvonalparaméterek dekódolva vannak.
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES	`false`	A rendszer minden útvonalparamétert változatlanul ad át, ami az alapértelmezett viselkedés.

Vegyük például a tartomány egyik függvényalkalmazásának proxies.json fájlját myfunction.com .

{
    "$schema": "http://json.schemastore.org/proxies",
    "proxies": {
        "root": {
            "matchCondition": {
                "route": "/{*all}"
            },
            "backendUri": "example.com/{all}"
        }
    }
}

Ha AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES be van állítva true, az URL-cím example.com/api%2ftest a következő lesz example.com/api/test: . Alapértelmezés szerint az URL-cím változatlan marad example.com/test%2fapi. További információ: Functions-proxyk.

AZURE_FUNCTIONS_ENVIRONMENT

Konfigurálja a függvényalkalmazás futtatókörnyezetét, amikor az Azure-ban fut. Ezt az értéket az inicializálás során olvassa be a rendszer, és a futtatókörnyezet csak ezeket az értékeket tartja tiszteletben:

Érték	Leírás
`Production`	Egy éles környezetet jelöl, amely csökkentett naplózással és teljes teljesítményoptimalizálással rendelkezik. Ez az alapértelmezett érték, ha `AZURE_FUNCTIONS_ENVIRONMENT` nincs beállítva, vagy nem támogatott értékre van beállítva.
`Staging`	Átmeneti környezetet jelöl, például átmeneti ponton való futtatáskor.
`Development`	A fejlesztés környezeti támogatás részletesebb naplózást és egyéb csökkentett teljesítményoptimalizálást. Az Azure Functions Core Tools a helyi számítógépen való futtatáskor állítja be `AZURE_FUNCTIONS_ENVIRONMENTDevelopment` a beállításokat. Ez a beállítás nem bírálható felül a local.settings.json fájlban.

Ezt a beállítást használja ahelyett ASPNETCORE_ENVIRONMENT , hogy az Azure-beli futtatókörnyezetet másra Productionkellene módosítania. További információ: Környezetalapú indítási osztály és metódusok.

Ez a beállítás nem érhető el a Functions-futtatókörnyezet 1.x verziójában.

AzureFunctionsJobHost__*

A Functions-futtatókörnyezet 2.x és újabb verzióiban az alkalmazásbeállítások felülbírálhatják host.json beállításokat az aktuális környezetben. Ezek a felülbírálások a nevesített AzureFunctionsJobHost__path__to__settingalkalmazásbeállításokként vannak kifejezve. További információért olvassa el a Host.json értékek felülbírálása témakört.

AzureFunctionsWebHost__hostid

Beállítja egy adott függvényalkalmazás gazdagépazonosítóját, amelynek egyedi azonosítónak kell lennie. Ez a beállítás felülírja az alkalmazás automatikusan létrehozott gazdagépazonosító-értékét. Ezt a beállítást csak akkor használja, ha meg kell akadályoznia az azonos tárfiókot használó függvényalkalmazások közötti gazdagépazonosító-ütközéseket.

A gazdagépazonosítónak meg kell felelnie a következő követelményeknek:

Legyen 1 és 32 karakter között
csak kisbetűket, számokat és kötőjeleket tartalmaz
Nem kötőjellel kezdődik vagy végződik
Egymást követő kötőjelek nélkül

Az azonosítók létrehozásának egyszerű módja, ha GUID-t vesz fel, eltávolítja a kötőjeleket, és kisbetűssé teszi, például a GUID 1835D7B5-5C98-4790-815D-072CC94C6F71 értékké 1835d7b55c984790815d072cc94c6f71alakításával.

Kulcs	Mintaérték
AzureFunctionsWebHost__hostid	`myuniquefunctionappname123456789`

További információkért lásd a gazdagépazonosítóval kapcsolatos szempontokat.

AzureWebJobsDashboard

Ez a beállítás elavult, és csak akkor támogatott, ha az Azure Functions-futtatókörnyezet 1.x verzióján fut.

Nem kötelező tárfiók kapcsolati sztring naplók tárolására és megjelenítésére a portál Monitor lapján. A tárfióknak általános célúnak kell lennie, amely támogatja a blobokat, az üzenetsorokat és a táblákat. További információ: Tárfiókok követelményei.

Kulcs	Mintaérték
AzureWebJobsDashboard	`DefaultEndpointsProtocol=https;AccountName=...`

AzureWebJobsDisableHomepage

Egy érték true letiltja a függvényalkalmazás gyökér URL-címéhez megjelenített alapértelmezett kezdőlapot. Az alapértelmezett érték false.

Kulcs	Mintaérték
AzureWebJobsDisableHomepage	`true`

Ha ez az alkalmazásbeállítás nincs megadva vagy be van állítva false, a következő példához hasonló lap jelenik meg az URL-címre <functionappname>.azurewebsites.netválaszul.

Függvényalkalmazás kezdőlapja

AzureWebJobsDotNetReleaseCompilation

true a .NET-kód összeállításakor a Kiadás mód használatát jelenti; false Azt jelenti, hogy hibakeresési módot használ. Az alapértelmezett szint a true.

Kulcs	Mintaérték
AzureWebJobsDotNetReleaseCompilation	`true`

AzureWebJobsFeatureFlags

Az engedélyezendő bétafunkciók vesszővel tagolt listája. Az ezen jelzők által engedélyezett bétafunkciók nem állnak készen az éles működésre, de az éles használat előtt engedélyezhetők kísérleti célokra.

Kulcs	Mintaérték
AzureWebJobsFeatureFlags	`feature1,feature2,EnableProxies`

A listához hozzáadva EnableProxies újra engedélyezheti a proxykat a Functions-futtatókörnyezet 4.x verziójában, miközben az Azure API Managementbe való migrálást tervezi. További információ: Proxyk újbóli engedélyezése a Functions v4.x-ben.

AzureWebJobsKubernetesSecretName

A kulcsok tárolásához használt Kubernetes Titkos kulcsok erőforrást jelzi. Csak a Kubernetesben való futtatás esetén támogatott. Ehhez a beállításhoz be kell állítania a következőt AzureWebJobsSecretStorageTypekubernetes: . Ha AzureWebJobsKubernetesSecretName nincs beállítva, az adattár írásvédettnek minősül. Ebben az esetben az értékeket az üzembe helyezés előtt kell létrehozni. Az Azure Functions Core Tools automatikusan létrehozza az értékeket a Kubernetesben való üzembe helyezéskor.

Kulcs	Mintaérték
AzureWebJobsKubernetesSecretName	`<SECRETS_RESOURCE>`

További információ: Titkos tárházak.

AzureWebJobsSecretStorageKeyVaultClientId

A felhasználó által hozzárendelt felügyelt identitás ügyfélazonosítója vagy a kulcsokat tároló tároló eléréséhez használt alkalmazásregisztráció. Ehhez a beállításhoz be kell állítania a következőt AzureWebJobsSecretStorageTypekeyvault: . A Functions-futtatókörnyezet 4.x és újabb verzióiban támogatott.

Kulcs	Mintaérték
AzureWebJobsSecretStorageKeyVaultClientId	`<CLIENT_ID>`

További információ: Titkos tárházak.

AzureWebJobsSecretStorageKeyVaultClientSecret

A felhasználó által hozzárendelt felügyelt identitás vagy a kulcsokat tároló tároló eléréséhez használt alkalmazásregisztráció ügyfélazonosítójának titkos kódja. Ehhez a beállításhoz be kell állítania a következőt AzureWebJobsSecretStorageTypekeyvault: . A Functions-futtatókörnyezet 4.x és újabb verzióiban támogatott.

Kulcs	Mintaérték
AzureWebJobsSecretStorageKeyVaultClientSecret	`<CLIENT_SECRET>`

További információ: Titkos tárházak.

AzureWebJobsSecretStorageKeyVaultName

A kulcsok tárolására használt kulcstartópéldány neve. Ez a beállítás csak a Functions-futtatókörnyezet 3.x verziójában támogatott. A 4.x verzióhoz használja a következőt AzureWebJobsSecretStorageKeyVaultUri: . Ehhez a beállításhoz be kell állítania a következőt AzureWebJobsSecretStorageTypekeyvault: .

A tárolónak rendelkeznie kell az üzemeltetési erőforrás rendszer által hozzárendelt felügyelt identitásának megfelelő hozzáférési szabályzattal. A hozzáférési szabályzatnak a következő titkos engedélyeket kell adnia az identitásnak: Get,Set, Listés Delete.
Ha a függvények helyileg futnak, a rendszer a fejlesztői identitást használja, a beállításoknak pedig a local.settings.json fájlban kell lenniük.

Kulcs	Mintaérték
AzureWebJobsSecretStorageKeyVaultName	`<VAULT_NAME>`

További információ: Titkos tárházak.

AzureWebJobsSecretStorageKeyVaultTenantId

A kulcsokat tároló tároló eléréséhez használt alkalmazásregisztráció bérlőazonosítója. Ehhez a beállításhoz be kell állítania a következőt AzureWebJobsSecretStorageTypekeyvault: . A Functions-futtatókörnyezet 4.x és újabb verzióiban támogatott. További információ: Titkos tárházak.

Kulcs	Mintaérték
AzureWebJobsSecretStorageKeyVaultTenantId	`<TENANT_ID>`

AzureWebJobsSecretStorageKeyVaultUri

A kulcsok tárolására használt kulcstartópéldány URI-ja. A Functions-futtatókörnyezet 4.x és újabb verzióiban támogatott. Ez az ajánlott beállítás kulcstartópéldány kulcstárolóhoz való használatához. Ehhez a beállításhoz be kell állítania a következőt AzureWebJobsSecretStorageTypekeyvault: .

Az AzureWebJobsSecretStorageKeyVaultUri értéknek a Key Vault áttekintési lapján megjelenő Tároló URI teljes értékének kell lennie, beleértve a https://.

Kulcs	Mintaérték
AzureWebJobsSecretStorageKeyVaultUri	`https://<VAULT_NAME>.vault.azure.net`

További információ: Key Vault-hivatkozások használata az Azure Functionshez.

AzureWebJobsSecretStorageSas

Blob Storage SAS-URL-cím a kulcstárolóhoz használt második tárfiókhoz. Alapértelmezés szerint a Functions a megadott fiókot használja.AzureWebJobsStorage Ha ezt a titkos tárbeállítást használja, győződjön meg arról, hogy AzureWebJobsSecretStorageType nincs explicit módon beállítva vagy be van állítva blob. További információ: Titkos tárházak.

Kulcs	Mintaérték
AzureWebJobsSecretStorageSas	`<BLOB_SAS_URL>`

AzureWebJobsSecretStorageType

Megadja a kulcstárolóhoz használni kívánt adattárat vagy szolgáltatót. A kulcsok mindig titkosítva lesznek, mielőtt a függvényalkalmazáshoz egyedi titkos kóddal vannak tárolva.

Kulcs	Érték	Leírás
AzureWebJobsSecretStorageType	`blob`	A kulcsok egy Blob Storage-tárolóban vannak tárolva a `AzureWebJobsStorage` beállítás által biztosított fiókban. A Blob Storage az alapértelmezett viselkedés, ha `AzureWebJobsSecretStorageType` nincs beállítva. Másik tárfiók megadásához a `AzureWebJobsSecretStorageSas` beállítással jelezze egy második tárfiók SAS-URL-címét.
AzureWebJobsSecretStorageType	`files`	A kulcsok megmaradnak a fájlrendszerben. Ez az alapértelmezett viselkedés a Functions 1.x-hez.
AzureWebJobsSecretStorageType	`keyvault`	A kulcsok tárolása egy kulcstartó által beállított `AzureWebJobsSecretStorageKeyVaultName`példányban történik.
AzureWebJobsSecretStorageType	`kubernetes`	Csak akkor támogatott, ha a Functions-futtatókörnyezetet a Kubernetesben futtatja. Ha `AzureWebJobsKubernetesSecretName` nincs beállítva, az adattár írásvédettnek minősül. Ebben az esetben az értékeket az üzembe helyezés előtt kell létrehozni. Az Azure Functions Core Tools automatikusan létrehozza az értékeket a Kubernetesben való üzembe helyezéskor.

További információ: Titkos tárházak.

AzureWebJobsStorage

Megadja egy Azure Storage-fiók kapcsolati sztring, amelyet a Functions-futtatókörnyezet a normál műveletekhez használ. A Functions által használt tárfiók egyes felhasználási területei közé tartoznak a kulcskezelés, az időzítő eseményindítóinak kezelése és az Event Hubs ellenőrzőpontjai. A tárfióknak általános célúnak kell lennie, amely támogatja a blobokat, az üzenetsorokat és a táblákat. További információ: Tárfiókok követelményei.

Kulcs	Mintaérték
AzureWebJobsStorage	`DefaultEndpointsProtocol=https;AccountName=...`

A kapcsolati sztring helyett használhat identitásalapú kapcsolatot ehhez a tárfiókhoz. További információ: Csatlakozás a tárterület identitással való üzemeltetéséhez.

AzureWebJobsStorage__accountName

Identitásalapú tárkapcsolat használata esetén a tárfiók nevét adja meg a kapcsolati sztring AzureWebJobsStoragehelyett. Ez a szintaxis egyedi, AzureWebJobsStorage és nem használható más identitásalapú kapcsolatokhoz.

Kulcs	Mintaérték
AzureWebJobsStorage__accountName	`<STORAGE_ACCOUNT_NAME>`

Szuverén felhők esetén vagy egyéni DNS használata esetén inkább a szolgáltatásspecifikus AzureWebJobsStorage__*ServiceUri beállításokat kell használnia.

AzureWebJobsStorage__blobServiceUri

Identitásalapú tárolási kapcsolat használatakor beállítja a tárfiók blobszolgáltatásának adatsík URI-ját.

Kulcs	Mintaérték
AzureWebJobsStorage__blobServiceUri	`https://<STORAGE_ACCOUNT_NAME>.blob.core.windows.net`

Ezt a beállítást a szuverén felhők helyett AzureWebJobsStorage__accountName vagy egyéni DNS használata esetén használja. További információ: Csatlakozás a tárterület identitással való üzemeltetéséhez.

AzureWebJobsStorage__queueServiceUri

Identitásalapú tárkapcsolat használatakor beállítja a tárfiók üzenetsor-szolgáltatásának adatsík URI-ját.

Kulcs	Mintaérték
AzureWebJobsStorage__queueServiceUri	`https://<STORAGE_ACCOUNT_NAME>.queue.core.windows.net`

AzureWebJobsStorage__tableServiceUri

Identitásalapú tárolási kapcsolat használatakor beállítja a tárfiók egyik táblaszolgáltatásának adatsík URI-ját.

Kulcs	Mintaérték
AzureWebJobsStorage__tableServiceUri	`https://<STORAGE_ACCOUNT_NAME>.table.core.windows.net`

AzureWebJobs_TypeScriptPath

A TypeScripthez használt fordító elérési útja. Szükség esetén felülbírálhatja az alapértelmezett beállítást.

Kulcs	Mintaérték
AzureWebJobs_TypeScriptPath	`%HOME%\typescript`

DOCKER_REGISTRY_SERVER_PASSWORD

A privát tárolóregisztrációs adatbázis eléréséhez használt jelszót jelzi. Ez a beállítás csak akkor szükséges, ha a tárolóalapú függvényalkalmazást privát tárolóregisztrációs adatbázisból telepíti. További információ: Környezeti változók és alkalmazásbeállítások a Azure-alkalmazás Szolgáltatásban.

DOCKER_REGISTRY_SERVER_URL

Egy privát tárolóregisztrációs adatbázis URL-címét jelzi. Ez a beállítás csak akkor szükséges, ha a tárolóalapú függvényalkalmazást privát tárolóregisztrációs adatbázisból telepíti. További információ: Környezeti változók és alkalmazásbeállítások a Azure-alkalmazás Szolgáltatásban.

DOCKER_REGISTRY_SERVER_USERNAME

A privát tárolóregisztrációs adatbázis eléréséhez használt fiókot jelöli. Ez a beállítás csak akkor szükséges, ha a tárolóalapú függvényalkalmazást privát tárolóregisztrációs adatbázisból telepíti. További információ: Környezeti változók és alkalmazásbeállítások a Azure-alkalmazás Szolgáltatásban.

DOCKER_SHM_SIZE

Beállítja a megosztott memória méretét (bájtban), amikor a Python-feldolgozó megosztott memóriát használ. További információ: Megosztott memória.

Kulcs	Mintaérték
DOCKER_SHM_SIZE	`268435456`

A fenti érték ~256 MB megosztott memóriaméretet állít be.

Ehhez be FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED kell állítani a következőt 1: .

ENABLE_ORYX_BUILD

Azt jelzi, hogy az Oryx buildrendszert használják-e az üzembe helyezés során. ENABLE_ORYX_BUILD Távoli buildek Linuxon történő telepítésekor be kell állítani true . További információ: Távoli build.

Kulcs	Mintaérték
ENABLE_ORYX_BUILD	`true`

FUNCTION_APP_EDIT_MODE

Azt jelzi, hogy szerkesztheti-e a függvényalkalmazást az Azure Portalon. Az érvényes értékek a következők: readwrite és readonly.

Kulcs	Mintaérték
FUNCTION_APP_EDIT_MODE	`readonly`

Az értéket a futtatókörnyezet állítja be a függvényalkalmazás nyelvi verem és üzembe helyezési állapota alapján. További információ: Az Azure Portal fejlesztési korlátozásai.

FUNCTIONS_EXTENSION_VERSION

A függvényalkalmazást üzemeltető Functions-futtatókörnyezet verziója. A főverzióval rendelkező tilde (~) azt jelenti, ~3hogy a főverzió legújabb verzióját használja (például). Ha ugyanahhoz a főverzióhoz új verziók érhetők el, azok automatikusan telepítve lesznek a függvényalkalmazásban. Ha az alkalmazást egy adott verzióra szeretné rögzíteni, használja a teljes verziószámot (például 3.0.12345). Az alapértelmezett szint a ~3. Egy érték ~1 rögzíti az alkalmazást a futtatókörnyezet 1.x-es verziójára. További információkért tekintse meg az Azure Functions futtatókörnyezeti verzióinak áttekintését. Az érték ~4 azt jelenti, hogy az alkalmazás a futtatókörnyezet 4.x verzióján fut.

Kulcs	Mintaérték
FUNCTIONS_EXTENSION_VERSION	`~4`

A következő fő futtatókörnyezeti verzióértékek támogatottak:

Érték	Futtatókörnyezeti cél	Megjegyzés
`~4`	4.x	Ajánlott
`~3`	3.x	Már nem támogatott
`~2`	2.x	Már nem támogatott
`~1`	1.x	A támogatás 2026. szeptember 14-én véget ér

FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR

Ez az alkalmazásbeállítás ideiglenesen lehetővé teszi Node.js alkalmazások számára a kompatibilitástörő módosítást, amely megkönnyíti a belépési pontok hibáinak elhárítását Node.js 18-os vagy újabb verzióban. Erősen ajánlott használni true, különösen a programozási modell v4-alkalmazásokhoz, amelyek mindig belépési pontfájlokat használnak. A kompatibilitástörő módosítás (false) nélküli viselkedés figyelmen kívül hagyja a belépési pontok hibáit, és nem naplózza őket az Alkalmazás Elemzések.

A Node.js v20-tól kezdve az alkalmazásbeállításnak nincs hatása, és a kompatibilitástörő változás viselkedése mindig engedélyezve van.

A Node.js 18-ás vagy alacsonyabb verzió esetén az alkalmazásbeállítás használható, és az alapértelmezett viselkedés attól függ, hogy a hiba a modell v4-függvényének regisztrálása előtt vagy után következik-e be:

Ha a hiba korábban jelentkezik (például ha a 3. modellt használja, vagy a belépési pontfájl nem létezik), az alapértelmezett viselkedés megegyezik false.
Ha a hiba a következő után jelentkezik (például ha ismétlődő modell v4-függvényeket próbál regisztrálni), az alapértelmezett viselkedés megegyezik true.

Kulcs	Érték	Leírás
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR	`true`	Tiltsa le a belépési pontok hibáit, és jelentkezzen be az Alkalmazás Elemzések.
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR	`false`	Hagyja figyelmen kívül a belépési pontok hibáit, és ne jelentkezzen be az Alkalmazás Elemzések.

FUNCTIONS_V2_COMPATIBILITY_MODE

Fontos

Ez a beállítás már nem támogatott. Eredetileg egy rövid távú áthidaló megoldás volt engedélyezve azoknak az alkalmazásoknak, amelyek a v2.x futtatókörnyezetet célozták meg, hogy ehelyett a v3.x futtatókörnyezetben fussanak, miközben továbbra is támogatottak. Az 1.x verzión futó régi alkalmazások kivételével minden függvényalkalmazásnak a Functions-futtatókörnyezet 4.x-es verzióján kell futnia: FUNCTIONS_EXTENSION_VERSION=~4. További információkért tekintse meg az Azure Functions futtatókörnyezeti verzióinak áttekintését.

FUNCTIONS_REQUEST_BODY_SIZE_LIMIT

Felülbírálja a HTTP-végpontoknak küldött kérések törzsméretére vonatkozó alapértelmezett korlátot. Az érték bájtokban van megadva, és a kérések alapértelmezett maximális mérete 104857600 bájt.

Kulcs	Mintaérték
FUNCTIONS_REQUEST_BODY_SIZE_LIMIT	`250000000`

FUNCTIONS_WORKER_PROCESS_COUNT

Meghatározza a nyelvi feldolgozó folyamatok maximális számát, amelynek alapértelmezett értéke .1 A megengedett maximális érték a következő 10: . A függvényhívások egyenletesen oszlanak el a nyelvi feldolgozó folyamatok között. A nyelvi feldolgozó folyamatok 10 másodpercenként jönnek létre, amíg el nem éri a megadott FUNCTIONS_WORKER_PROCESS_COUNT számot. Több nyelvi feldolgozó folyamat használata nem ugyanaz, mint a skálázás. Ezt a beállítást akkor érdemes használni, ha a számítási feladat processzorhoz kötött és I/O-kötésű hívásokat használ. Ez a beállítás az összes nyelvi futtatókörnyezetre vonatkozik, kivéve a folyamatban futó .NET-et (FUNCTIONS_WORKER_RUNTIME=dotnet).

Kulcs	Mintaérték
FUNCTIONS_WORKER_PROCESS_COUNT	`2`

FUNCTIONS_WORKER_RUNTIME

A munkavégző futtatókörnyezet nyelvének vagy nyelvi veremének betöltése a függvényalkalmazásban. Ez megfelel az alkalmazásban használt nyelvnek (például python). Az Azure Functions-futtatókörnyezet 2.x verziójától kezdve egy adott függvényalkalmazás csak egyetlen nyelvet támogat.

Kulcs	Mintaérték
FUNCTIONS_WORKER_RUNTIME	`node`

Érvényes értékek:

Érték	Nyelv/nyelv verem
`dotnet`	C# (osztálykönyvtár) C# (szkript)
`dotnet-isolated`	C# (izolált feldolgozói folyamat)
`java`	Java
`node`	JavaScript TypeScript
`powershell`	PowerShell
`python`	Python
`custom`	Egyéb

FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED

Ez a beállítás lehetővé teszi, hogy a Python-feldolgozó megosztott memóriát használjon az átviteli sebesség javítása érdekében. Engedélyezze a megosztott memóriát, ha a Python-függvényalkalmazás memória szűk keresztmetszeteket ér el.

Kulcs	Mintaérték
FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED	`1`

Ha ez a beállítás engedélyezve van, a DOCKER_SHM_SIZE beállítással beállíthatja a megosztott memória méretét. További információ: Megosztott memória.

JAVA_OPTS

A Java-függvények futtatásához használt Java-virtuális gép (JVM) testreszabására szolgál prémium csomagon vagy dedikált csomagon való futtatáskor. Használatalapú csomagon való futtatáskor használja a következőt languageWorkers__java__arguments: . További információ: JVM testreszabása.

languageWorkersjavaarguments

A Java-függvények használatalapú futtatásakor használt Java virtuális gép (JVM) testreszabására szolgál. Ez a beállítás növeli a használati tervben futó Java-függvények hideg kezdési idejét. Prémium vagy dedikált csomag esetén használja a következőt JAVA_OPTS: . További információ: JVM testreszabása.

MDMaxBackgroundUpgradePeriod

A PowerShell-függvényalkalmazások felügyelt függőségek háttérfrissítési időszakát 7.00:00:00 szabályozza, amelynek alapértelmezett értéke (heti).

Minden PowerShell-feldolgozó folyamat elindítja a modulfrissítések ellenőrzését a PowerShell-galéria a folyamat indításakor és utánMDMaxBackgroundUpgradePeriod. Ha egy új modulverzió elérhető a PowerShell-galéria, az telepítve lesz a fájlrendszerre, és elérhetővé válik a PowerShell-feldolgozók számára. Ennek az értéknek a csökkentése lehetővé teszi, hogy a függvényalkalmazás hamarabb szerezze be az újabb modulverziókat, de növeli az alkalmazás erőforrás-használatát is (hálózati I/O, CPU, tároló). Ennek az értéknek a növelése csökkenti az alkalmazás erőforrás-használatát, de késleltetheti az új modulverziók alkalmazását is.

Kulcs	Mintaérték
MDMaxBackgroundUpgradePeriod	`7.00:00:00`

További információ: Függőségkezelés.

MDNewSnapshotCheckPeriod

Megadja, hogy az egyes PowerShell-feldolgozók milyen gyakran ellenőrzik, hogy a felügyelt függőségfrissítések telepítve lettek-e. Az alapértelmezett gyakoriság 01:00:00 (óránként).

Miután telepítette az új modulverziókat a fájlrendszerre, minden PowerShell-feldolgozó folyamatot újra kell indítani. A PowerShell-feldolgozók újraindítása hatással van az alkalmazás rendelkezésre állására, mivel az megszakíthatja a függvények aktuális végrehajtását. Amíg az összes PowerShell-feldolgozó folyamat újra nem indul, a függvényhívások a régi vagy az új modulverziókat használhatják. Az összes PowerShell-feldolgozó újraindítása befejeződött a következőn belül MDNewSnapshotCheckPeriod: .

A PowerShell-feldolgozó minden MDNewSnapshotCheckPeriodesetben ellenőrzi, hogy telepítették-e a felügyelt függőségi frissítéseket. A frissítések telepítésekor újraindul a rendszer. Az érték növelése csökkenti az újraindítások miatti megszakítások gyakoriságát. A növekedés azonban megnövelheti azt az időt is, amely alatt a függvényhívások nem meghatározott módon használhatják a régi vagy az új modulverziókat.

Kulcs	Mintaérték
MDNewSnapshotCheckPeriod	`01:00:00`

További információ: Függőségkezelés.

MDMinBackgroundUpgradePeriod

A korábbi felügyelt függőségek frissítési ellenőrzése utáni időszak egy újabb frissítési ellenőrzés megkezdése előtt, alapértelmezés szerint 1.00:00:00 (naponta).

A gyakori feldolgozói újraindítások túlzott modulfrissítéseinek elkerülése érdekében a modulfrissítések ellenőrzése nem történik meg, ha bármely feldolgozó már kezdeményezte az utolsó MDMinBackgroundUpgradePeriodbejelentkezést.

Kulcs	Mintaérték
MDMinBackgroundUpgradePeriod	`1.00:00:00`

További információ: Függőségkezelés.

PIP_INDEX_URL

Ezzel a beállítással felülbírálhatja a Python-csomagindex alap URL-címét, amely alapértelmezés szerint az https://pypi.org/simple. Ezt a beállítást akkor használja, ha egyéni függőségekkel kell távoli buildet futtatnia. Ezek az egyéni függőségek lehetnek a PEP 503 -nak (az egyszerű adattár API-nak) megfelelő csomagindex-adattárban vagy egy olyan helyi könyvtárban, amely ugyanazt a formátumot követi.

Kulcs	Mintaérték
PIP_INDEX_URL	`http://my.custom.package.repo/simple`

További információkért tekintse meg pip az egyéni függőségek dokumentációját --index-url a Python fejlesztői referenciaanyagában.

PIP_EXTRA_INDEX_URL

Ennek a beállításnak az értéke a Python-alkalmazások egyéni csomagjainak további index URL-címét jelzi, amelyet a --index-url. Ezt a beállítást akkor használja, ha távoli buildet kell futtatnia egy extra csomagindexben található egyéni függőségek használatával. Ugyanazokat a szabályokat kell követnie, mint a --index-url.

Kulcs	Mintaérték
PIP_EXTRA_INDEX_URL	`http://my.custom.package.repo/simple`

További információkért tekintse meg pip a Python fejlesztői referencia dokumentációját és egyéni függőségeit.--extra-index-url

PROJEKT

Egy folyamatos üzembe helyezési beállítás, amely tájékoztatja a Kudu üzembe helyezési szolgáltatását a csatlakoztatott adattár mappáiról az üzembe helyezhető projekt helyének megadásához.

Kulcs	Mintaérték
PROJEKT	`WebProject/WebProject.csproj`

PYTHON_ISOLATE_WORKER_DEPENDENCIES

A konfiguráció a Python-függvényalkalmazásokra vonatkozik. Meghatározza a modulbetöltési sorrend rangsorolását. Alapértelmezés szerint ez az érték a következőre 0van állítva: .

Kulcs	Érték	Leírás
PYTHON_ISOLATE_WORKER_DEPENDENCIES	`0`	Rangsorolja a Python-kódtárak betöltését a Belső Python-feldolgozó függőségeiből, ami az alapértelmezett viselkedés. Előfordulhat, hogy a requirements.txt definiált külső kódtárak árnyékoltak.
PYTHON_ISOLATE_WORKER_DEPENDENCIES	`1`	Rangsorolja a Python-kódtárak betöltését az alkalmazás requirements.txt definiált csomagjából. Ez megakadályozza, hogy a kódtárak ütköznek a belső Python-feldolgozó kódtáraival.

PYTHON_ENABLE_DEBUG_LOGGING

Lehetővé teszi a hibakeresési szintű naplózást egy Python-függvényalkalmazásban. Egy érték lehetővé teszi a 1 hibakeresési szintű naplózást. E beállítás nélkül vagy értékével 0csak az információkat és a magasabb szintű naplókat küldi el a Python-feldolgozó a Functions-gazdagépnek. Ezt a beállítást használhatja a Python-függvényvégrehajtások hibakereséséhez vagy nyomon követéséhez.

A Python-függvények hibakeresésekor szükség szerint állítsa be a hibakeresési vagy nyomkövetési naplózási szintet is a host.json fájlban. További információ: Az Azure Functions monitorozásának konfigurálása.

PYTHON_ENABLE_WORKER_EXTENSIONS

A konfiguráció a Python-függvényalkalmazásokra vonatkozik. Ez a beállítás lehetővé teszi, hogy 1 a feldolgozó betöltse a requirements.txt definiált Python-feldolgozóbővítményeket . Lehetővé teszi a függvényalkalmazás számára, hogy hozzáférjen a külső csomagok által biztosított új funkciókhoz. Emellett megváltoztathatja a függvénybetöltés és a hívás viselkedését az alkalmazásban. Győződjön meg arról, hogy a választott bővítmény megbízható, mivel fennáll a használat kockázata. Az Azure Functions nem vállal kifejezett garanciát a bővítményekre. A bővítmények használatához látogasson el a bővítmény manuális oldalára vagy az olvasási dokumentumba. Alapértelmezés szerint ez az érték a következőre 0van kapcsolva: .

Kulcs	Érték	Leírás
PYTHON_ENABLE_WORKER_EXTENSIONS	`0`	Tiltsa le a Python-feldolgozó bővítményeket.
PYTHON_ENABLE_WORKER_EXTENSIONS	`1`	Lehetővé teszi a Python-feldolgozó számára a bővítmények betöltését requirements.txt.

PYTHON_THREADPOOL_THREAD_COUNT

Megadja, hogy egy Python-nyelvi feldolgozó legfeljebb hány szálat használna függvényhívások végrehajtásához, a Python-verzió 3.8 alapértelmezett értékével 1 és az alábbi értékekkel. Python-verzió és újabb verziók 3.9 esetén az érték a következőre Nonevan állítva: . Ez a beállítás nem garantálja a végrehajtás során beállított szálak számát. A beállítás lehetővé teszi, hogy a Python kibontsa a szálak számát a megadott értékre. A beállítás csak a Python-függvényalkalmazásokra vonatkozik. A beállítás emellett a szinkron függvények meghívására is vonatkozik, és nem a koroutinokra.

Kulcs	Mintaérték	Maximális érték
PYTHON_THREADPOOL_THREAD_COUNT	2	32

SCALE_CONTROLLER_LOGGING_ENABLED

Ez a beállítás jelenleg előzetes verzióban érhető el.

Ez a beállítás az Azure Functions skálázási vezérlőjének naplózását szabályozza. További információ: Skálázásvezérlő naplói.

Kulcs	Mintaérték
SCALE_CONTROLLER_LOGGING_ENABLED	`AppInsights:Verbose`

A kulcs értékét a következő formátumban <DESTINATION>:<VERBOSITY>adja meg:

Tulajdonság Leírás

<DESTINATION> Az a cél, ahová a naplókat elküldik. Az érvényes értékek a következők: AppInsights és Blob.
Ha használjaAppInsights, győződjön meg arról, hogy az alkalmazás Elemzések engedélyezve van a függvényalkalmazásban.
A célhely Blobbeállításakor a rendszer naplókat hoz létre egy blobtárolóban azure-functions-scale-controller , amely az alkalmazásbeállításban beállított alapértelmezett tárfiókban AzureWebJobsStorage van.

<VERBOSITY> Megadja a naplózás szintjét. A támogatott értékek a következők None: , Warningés Verbose.
Ha be van Verboseállítva, a skálázási vezérlő naplózza a feldolgozók számának minden változásának okát, valamint a tényezők eseményindítóira vonatkozó információkat ezekre a döntésekre. Részletes naplók közé tartoznak az eseményindítók figyelmeztetései és az eseményindítók által a skálázásvezérlő futtatása előtt és után használt kivonatok.

Tulajdonság	Leírás
`<DESTINATION>`	Az a cél, ahová a naplókat elküldik. Az érvényes értékek a következők: `AppInsights` és `Blob`. Ha használja`AppInsights`, győződjön meg arról, hogy az alkalmazás Elemzések engedélyezve van a függvényalkalmazásban. A célhely `Blob`beállításakor a rendszer naplókat hoz létre egy blobtárolóban `azure-functions-scale-controller` , amely az alkalmazásbeállításban beállított alapértelmezett tárfiókban `AzureWebJobsStorage` van.
`<VERBOSITY>`	Megadja a naplózás szintjét. A támogatott értékek a következők `None`: , `Warning`és `Verbose`. Ha be van `Verbose`állítva, a skálázási vezérlő naplózza a feldolgozók számának minden változásának okát, valamint a tényezők eseményindítóira vonatkozó információkat ezekre a döntésekre. Részletes naplók közé tartoznak az eseményindítók figyelmeztetései és az eseményindítók által a skálázásvezérlő futtatása előtt és után használt kivonatok.

Tipp.

Ne feledje, hogy bár a skálázási vezérlő naplózását engedélyezve hagyja, az hatással van a függvényalkalmazás monitorozásának lehetséges költségeire. Fontolja meg a naplózás engedélyezését, amíg elegendő adatot nem gyűjt ahhoz, hogy megértse, hogyan működik a skálázási vezérlő, majd tiltsa le.

SCM_DO_BUILD_DURING_DEPLOYMENT

Szabályozza a távoli buildelési viselkedést az üzembe helyezés során. Ha SCM_DO_BUILD_DURING_DEPLOYMENT be van állítva true, a projekt az üzembe helyezés során távolról lesz felépítve.

Kulcs	Mintaérték
SCM_DO_BUILD_DURING_DEPLOYMENT	`true`

SCM_LOGSTREAM_TIMEOUT

Másodpercek alatt szabályozza az időtúllépést a streamnaplókhoz való csatlakozáskor. Az alapértelmezett érték 7200 (2 óra).

Kulcs	Mintaérték
SCM_LOGSTREAM_TIMEOUT	`1800`

A fenti mintaérték 1800 30 perces időtúllépést állít be. További információ: Streamelési végrehajtási naplók engedélyezése az Azure Functionsben.

WEBSITE_CONTENTAZUREFILECONNECTIONSTRING

Csatlakozás ion sztring olyan tárfiókhoz, ahol a függvényalkalmazás kódja és konfigurációja eseményvezérelt skálázási tervekben van tárolva. További információ: Storage-fiók kapcsolatbeállítása.

Kulcs	Mintaérték
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING	`DefaultEndpointsProtocol=https;AccountName=...`

Ez a beállítás a Windowson és Linuxon futó Consumption és Elastic Premium csomaghoz szükséges. Nem szükséges dedikált csomagalkalmazásokhoz, amelyeket nem skáláz dinamikusan a Functions.

A beállítás módosítása vagy eltávolítása miatt a függvényalkalmazás nem indul el. További információért tekintse meg ezt a hibaelhárítási cikket.

Az Azure Files nem támogatja a felügyelt identitás használatát a fájlmegosztás elérésekor. További információ: Az Azure Files által támogatott hitelesítési forgatókönyvek.

WEBSITE_CONTENTOVERVNET

Egy érték 1 lehetővé teszi a függvényalkalmazás skálázását, ha a tárfiókja virtuális hálózatra van korlátozva. Ezt a beállítást engedélyeznie kell, ha a tárfiókot virtuális hálózatra korlátozza. Csak a használata WEBSITE_CONTENTAZUREFILECONNECTIONSTRINGesetén szükséges. További információ: Tárfiók korlátozása virtuális hálózatra.

Kulcs	Mintaérték
WEBSITE_CONTENTOVERVNET	`1`

Prémium és dedikált (App Service) csomagokban támogatott (Standard és újabb). Használatalapú csomagon való futtatáskor nem támogatott.

WEBSITE_CONTENTSHARE

Annak a fájlmegosztásnak a neve, amelyet a Functions a függvényalkalmazás kódjának és konfigurációs fájljainak tárolására használ. Ezt a tartalmat eseményvezérelt skálázási tervek igénylik. A .-val együtt WEBSITE_CONTENTAZUREFILECONNECTIONSTRINGhasználva Az alapértelmezett érték a futtatókörnyezet által létrehozott egyedi sztring, amely a függvényalkalmazás nevével kezdődik. További információ: Storage-fiók kapcsolatbeállítása.

Kulcs	Mintaérték
WEBSITE_CONTENTSHARE	`functionapp091999e2`

Ez a beállítás windowsos és linuxos használatalapú és prémium szintű csomagokhoz szükséges. Nem szükséges dedikált csomagalkalmazásokhoz, amelyeket nem skáláz dinamikusan a Functions.

A megosztás a függvényalkalmazás létrehozásakor jön létre. A beállítás módosítása vagy eltávolítása miatt a függvényalkalmazás nem indul el. További információért tekintse meg ezt a hibaelhárítási cikket.

Az üzembe helyezés során az alábbi szempontok vonatkoznak egy Azure Resource Manager-sablon vagy Bicep-fájl használatával egy függvényalkalmazás létrehozására:

Ha nem állít be WEBSITE_CONTENTSHARE értéket a fő függvényalkalmazáshoz vagy a tárolóhelyeken lévő alkalmazásokhoz, a rendszer egyedi megosztási értékeket hoz létre Önnek. Az ARM-sablon üzembe helyezéséhez ajánlott módszer a nem beállítás.WEBSITE_CONTENTSHARE
Vannak olyan esetek, amikor az WEBSITE_CONTENTSHARE értéket előre definiált értékre kell állítania, például ha biztonságos tárfiókot használ egy virtuális hálózaton. Ebben az esetben minden üzembehelyezési ponthoz meg kell adnia a fő függvényalkalmazás és az alkalmazás egyedi megosztási nevét. Virtuális hálózat által védett tárfiókok esetén a megosztást is létre kell hoznia az automatizált üzembe helyezés részeként. További információ: Biztonságos üzemelő példányok.
Ne hozzon létre WEBSITE_CONTENTSHARE pontbeállítást.
Ha megadja WEBSITE_CONTENTSHARE, az értéknek követnie kell ezt az útmutatást a megosztásnevekhez.

WEBSITE_DNS_Standard kiadás RVER

Beállítja az alkalmazás által az IP-címek feloldásakor használt DNS-kiszolgálót. Ez a beállítás gyakran szükséges bizonyos hálózati funkciók, például az Azure DNS privát zónái és privát végpontok használatakor.

Kulcs	Mintaérték
WEBSITE_DNS_Standard kiadás RVER	`168.63.129.16`

WEBSITE_ENABLE_BROTLI_ENCODING

Azt szabályozza, hogy a Brotli-kódolást használja-e tömörítéshez az alapértelmezett gzip-tömörítés helyett. Ha WEBSITE_ENABLE_BROTLI_ENCODING be van állítva 1, a rendszer Brotli kódolást használ, ellenkező esetben gzip kódolást használ.

WEBSITE_FUNCTIONS_ARMCACHE_ENABLED

Letiltja a gyorsítótárazást a függvényalkalmazások Azure Resource Manager-sablonokkal történő üzembe helyezésekor.

Kulcs	Mintaérték
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED	0

WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT

Az alkalmazás által felskálázható példányok maximális száma. Az alapértelmezett érték nincs korlátozva.

Fontos

Ez a beállítás előzetes verzióban érhető el. Hozzáadtunk egy alkalmazástulajdonságot a függvények maximális felskálázásához , és ez a javasolt módszer a vertikális felskálázás korlátozására.

Kulcs	Mintaérték
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT	`5`

WEBSITE_NODE_DEFAULT_VERSION

Csak Windows rendszeren. Beállítja a Node.js verzióját a függvényalkalmazás Windows rendszeren való futtatásakor. Használjon tilde (~) tilde-t, hogy a futtatókörnyezet a célzott főverzió legújabb elérhető verzióját használja. Ha például be van ~18állítva, a Node.js 18 legújabb verziója lesz használatban. Ha egy főverziót egy tilde-vel céloz meg, nem kell manuálisan frissítenie az alverziót.

Kulcs	Mintaérték
WEBSITE_NODE_DEFAULT_VERSION	`~18`

WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_Standard kiadás TTINGS

Ha prémium csomagban futó függvényalkalmazáson végez pontcserét , a felcserélés meghiúsulhat, ha az alkalmazás által használt dedikált tárfiók hálózatkorlátozással rendelkezik. Ezt a hibát egy örökölt alkalmazásnaplózási funkció okozza, amelyet a Functions és az App Service is megosztott. Ez a beállítás felülírja az örökölt naplózási funkciót, és lehetővé teszi a felcserélést.

Kulcs	Mintaérték
WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_Standard kiadás TTINGS	`0`

Adjon hozzá WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS egy értéket 0 az összes tárolóhelyhez, hogy meggyőződjön arról, hogy az örökölt diagnosztikai beállítások nem tiltják le a felcseréléseket. Ezt a beállítást és értéket is hozzáadhatja csak az éles ponthoz üzembehelyezési pontként (ragadós) beállításként.

WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS

Alapértelmezés szerint a függvényalkalmazások verzióbeállításai az egyes pontokra vonatkoznak. Ez a beállítás a függvények üzembehelyezési pontok használatával történő frissítésekor használatos. Ez megakadályozza a nem várt viselkedést a verzióváltás után. Állítsa be 0 éles környezetben és a pontban, hogy az összes verzióbeállítás is felcserélve legyen. További információ: Frissítés pontok használatával.

Kulcs	Mintaérték
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS	`0`

WEBSITE_RUN_FROM_PACKAGE

Lehetővé teszi, hogy a függvényalkalmazás egy csomagfájlból fusson, amely helyileg csatlakoztatható vagy üzembe helyezhető egy külső URL-címen.

Kulcs	Mintaérték
WEBSITE_RUN_FROM_PACKAGE	`1`

Az érvényes értékek olyan URL-címek, amelyek egy külső üzembehelyezési csomagfájl helyére kerülnek, vagy 1. Ha be van 1állítva, a csomagnak a d:\home\data\SitePackages mappában kell lennie. Ha engedélyezve van a WEBSITE_RUN_FROM_PACKAGE zip-alapú üzembe helyezés, a rendszer automatikusan feltölti a csomagot erre a helyre. Az előzetes verzióban ezt a beállítást nevezték el WEBSITE_RUN_FROM_ZIP. További információ: Függvények futtatása csomagfájlból.

Külső csomag URL-címéről történő üzembe helyezéskor manuálisan is szinkronizálnia kell az eseményindítókat. További információ: Triggerszinkronizálás.

WEBSITE_SKIP_CONTENTSHARE_VALIDATION

A WEBSITE_CONTENTAZUREFILECONNECTIONSTRING és a WEBSITE_CONTENTSHARE beállításai további ellenőrzési ellenőrzésekkel biztosítják az alkalmazás megfelelő indítását. Az alkalmazásbeállítások létrehozása sikertelen, ha a függvényalkalmazás hálózati korlátozások vagy egyéb korlátozó tényezők miatt nem tud megfelelően meghívni az alsóbb rétegbeli tárfiókba vagy a Key Vaultba. Ha WEBSITE_SKIP_CONTENTSHARE_VALIDATION értékre van állítva 1, a rendszer kihagyja az érvényesítési ellenőrzést, ellenkező esetben az érték alapértelmezés szerint a következő lesz 0 , és az érvényesítés lezajlott.

Kulcs	Mintaérték
WEBSITE_SKIP_CONTENTSHARE_VALIDATION	`1`

Ha az ellenőrzés kihagyva, és a kapcsolati sztring vagy a tartalommegosztás érvénytelen, az alkalmazás nem fog tudni megfelelően elindulni. Ebben az esetben a függvények HTTP 500-hibákat adnak vissza. További információ: Hibaelhárítási hiba: "Az Azure Functions Futtatókörnyezet nem érhető el"

WEBSITE_SLOT_NAME

Írásvédett. Az aktuális üzembehelyezési pont neve. Az éles pont neve .Production

Kulcs	Mintaérték
WEBSITE_SLOT_NAME	`Production`

WEBSITE_TIME_ZONE

Lehetővé teszi a függvényalkalmazás időzónájának a beállítását.

Kulcs	OS	Mintaérték
WEBSITE_TIME_ZONE	Windows	`Eastern Standard Time`
WEBSITE_TIME_ZONE	Linux	`America/New_York`

A CRON-kifejezések esetén használt alapértelmezett időzóna az egyezményes világidő (UTC). Ha a CRON-kifejezést egy másik időzóna alapján szeretné beállítani, hozzon létre egy alkalmazásbeállítást a függvényalkalmazáshoz.WEBSITE_TIME_ZONE

A beállítás értéke az operációs rendszertől és a függvényalkalmazás alapjául szolgáló csomagtól függ.

Operációs rendszer	Felkészülés	Érték
Windows	Mind	Állítsa be az értéket a kívánt időzóna nevére a Windows parancs által megadott párok második sora alapján `tzutil.exe /L`
Linux	Prémium Dedikált	Állítsa be az értéket a kívánt időzóna nevére a tz-adatbázisban látható módon.

Feljegyzés

WEBSITE_TIME_ZONE és TZ jelenleg nem támogatottak, ha a Linuxon futó használatalapú csomagban futnak. Ebben az esetben ssl-sel kapcsolatos problémákat állíthat be WEBSITE_TIME_ZONE vagy TZ hozhat létre, és a metrikák leállhatnak az alkalmazás működésében.

Például az USA keleti ideje (amelyet Eastern Standard Time a (Windows) vagy America/New_York a (Linux) képviselnek) jelenleg UTC-05:00-t használ a téli idő szerint, és UTC-04:00-t a nyári időszámítás során. Ha minden nap 10:00-kor szeretné aktiválni az időzítőt, hozzon létre egy alkalmazásbeállítást a függvényalkalmazáshozWEBSITE_TIME_ZONE, állítsa az értéket (Windows) vagy America/New_York (Linux) értékre Eastern Standard Time , majd használja a következő NCRONTAB kifejezést:

"0 0 10 * * *"

Ha használja WEBSITE_TIME_ZONE az időt, a megadott időzónában az idő megváltozik, beleértve a nyári időszámítást és a téli idő változásait.

WEBSITE_U Standard kiadás_PLACEHOLDER

Azt jelzi, hogy egy adott hidegindítási optimalizálást használjon-e a használatalapú csomag futtatásakor. Állítsa be, hogy 0 letiltsa a használatalapú csomag hidegindításos optimalizálását.

Kulcs	Mintaérték
WEBSITE_U Standard kiadás_PLACEHOLDER	`1`

WEBSITE_U Standard kiadás_PLACEHOLDER_DOTNETISOLATED

Azt jelzi, hogy használjon-e egy adott hidegindítási optimalizálást a .NET izolált feldolgozói folyamatfüggvényeinek a Használat terven való futtatásakor. Állítsa be, hogy 0 letiltsa a használatalapú csomag hidegindításos optimalizálását.

Kulcs	Mintaérték
WEBSITE_U Standard kiadás_PLACEHOLDER_DOTNETISOLATED	`1`

WEBSITE_VNET_ROUTE_ALL

Fontos

WEBSITE_VNET_ROUTE_ALL egy régi alkalmazásbeállítás, amelyet a vnetRouteAllEnabled webhelybeállítás váltott fel.

Azt jelzi, hogy az alkalmazásból érkező összes kimenő forgalom a virtuális hálózaton keresztül van-e irányítva. A beállítás értéke 1 azt jelzi, hogy a rendszer az összes forgalmat a virtuális hálózaton keresztül irányítja. Erre a beállításra a regionális virtuális hálózati integráció funkcióinak használatakor van szükség. Akkor is használatos, ha egy virtuális hálózati NAT-átjárót használ egy statikus kimenő IP-cím definiálásához.

Kulcs	Mintaérték
WEBSITE_VNET_ROUTE_ALL	`1`

WEBSITES_ENABLE_APP_Standard kiadás RVICE_STORAGE

Azt jelzi, hogy a /home címtár meg van-e osztva a skálázott példányok között, és az alapértelmezett érték a true. Ezt a függvényalkalmazás tárolóban való üzembe helyezésekor kell beállítania false . d

App Service-webhely beállításai

Bizonyos konfigurációkat az App Service szintjén kell fenntartani, például a nyelvi verziókat. Ezek a beállítások a portálon, REST API-k használatával vagy az Azure CLI vagy az Azure PowerShell használatával kezelhetők. Az alábbiakban a futtatókörnyezet nyelvétől, operációs rendszerétől és verzióitól függően szükséges webhelybeállításokra lehet szükség:

alwaysOn

Dedikált (App Service) csomagban futó függvényalkalmazások esetén a függvény-futtatókörnyezet néhány perc inaktivitás után tétlen lesz, amely pont csak a HTTP-eseményindítókhoz érkező kérések ébresztik fel a függvényeket. Ha meg szeretné győződni arról, hogy a nem HTTP által aktivált függvények megfelelően futnak, beleértve az Időzítő eseményindítót is, engedélyezze az Always On beállítást a függvényalkalmazáshoz a webhelybeállítás értékének truebeállításávalalwaysOn.

linuxFxVersion

A Linuxon linuxFxVersion futó függvényalkalmazások esetében a nyelvspecifikus feldolgozó folyamat nyelvét és verzióját jelzi. Ez az információ, valamint FUNCTIONS_EXTENSION_VERSIONannak meghatározására szolgál, hogy melyik linuxos tárolólemezkép van telepítve a függvényalkalmazás futtatásához. Ez a beállítás beállítható előre definiált értékre vagy egyéni kép URI-ra.

Ez az érték a Linux-függvényalkalmazás létrehozásakor van beállítva. Előfordulhat, hogy ARM-sablonhoz és Bicep-üzemelő példányokhoz, valamint bizonyos frissítési forgatókönyvekhez be kell állítania.

Érvényes linuxFxVersion-értékek

Az alábbi Azure CLI-paranccsal megtekintheti az aktuális linuxFxVersion értékek táblázatát a Functions támogatott futtatókörnyezeti verziójával:

az functionapp list-runtimes --os linux --query "[].{stack:join(' ', [runtime, version]), LinuxFxVersion:linux_fx_version, SupportedFunctionsVersions:to_string(supported_functions_versions[])}" --output table

Az előző parancs megköveteli, hogy frissítsen az Azure CLI 2.40-es verziójára.

Egyéni rendszerképek

Amikor saját egyéni Linux-tárolót hoz létre és tart fenn a függvényalkalmazáshoz, az linuxFxVersion érték formátuma DOCKER|<IMAGE_URI>a következő példában látható:

linuxFxVersion = "DOCKER|contoso.com/azurefunctionsimage:v1.0.0"

Ez az üzembe helyezett tároló beállításjegyzék-forrását jelzi. További információ: A tárolók és az Azure Functions használata.

Fontos

Saját tárolók létrehozásakor frissítenie kell a tároló alaprendszerképét a legújabb támogatott alaprendszerképre. Az Azure Functions támogatott alaprendszerképei nyelvspecifikusak, és az Azure Functions alaprendszerkép-adattárában találhatók.

A Functions csapata elkötelezett amellett, hogy havi frissítéseket tegyen közzé ezekhez az alaplemezképekhez. A rendszeres frissítések közé tartoznak a legújabb alverziófrissítések és biztonsági javítások mind a Functions-futtatókörnyezethez, mind a nyelvekhez. Rendszeresen frissítenie kell a tárolót a legújabb alaprendszerképről, és újból üzembe kell helyeznie a tároló frissített verzióját.

netFrameworkVersion

A .NET adott verzióját állítja be a C# függvényekhez. További információ: Függvényalkalmazás frissítése az Azure-ban.

powerShellVersion

Beállítja a PowerShell adott verzióját, amelyen a függvények futnak. További információ: A PowerShell-verzió módosítása.

Helyi futtatáskor ehelyett a FUNCTIONS_WORKER_RUNTIME_VERSION local.settings.json fájlban lévő beállítást kell használnia.

vnetrouteallenabled

Ez a webhelybeállítás felülírja az örökölt WEBSITE_VNET_ROUTE_ALL beállítást.

Következő lépések

Megtudhatja, hogyan frissítheti az alkalmazásbeállításokat

Konfigurációs beállítások megtekintése a host.json fájlban

Az App Service-alkalmazások egyéb alkalmazásbeállításainak megtekintése