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

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:

• Az Azure Portalon.
• Az Azure CLI használatával.
• Az Azure PowerShell használatával.

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.

Mivel az Azure Functions a Azure-alkalmazás Szolgáltatásplatformot használja üzemeltetésre, előfordulhat, hogy a Azure-alkalmazás Szolgáltatás környezeti változóiban és alkalmazásbeállításaiban dokumentált, a függvényalkalmazással kapcsolatos néhány beállítás releváns.

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 kettőspont (:) 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, mint a Windows esetében. 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ások beá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 Insights 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 Application Insights szuverén felhőben fut, akkor azt kell használnia APPLICATIONINSIGHTS_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.

APPLICATIONINSIGHTS_AUTHENTICATION_STRING

Engedélyezi az Application Insights elérését a Microsoft Entra-hitelesítéssel. Ezt a beállítást akkor használja, ha Microsoft Entra-hitelesítéssel kell csatlakoznia az Application Insights-munkaterülethez. További információ: Microsoft Entra authentication for Application Insights.

Ha használja APPLICATIONINSIGHTS_AUTHENTICATION_STRING, a megadott érték a felügyelt identitás típusától függ:

Felügyelt identitás	Beállítás értéke
Rendszer által hozzárendelt	Authorization=AAD
Felhasználó által hozzárendelt	Authorization=AAD;ClientId=<USER_ASSIGNED_CLIENT_ID>

Ez a hitelesítési követelmény a Functions-gazdagép, a pillanatkép-hibakereső, a profilkészítő és a nyelvspecifikus ügynökök kapcsolataira vonatkozik. A beállítás használatához a felügyelt identitásnak már elérhetőnek kell lennie a függvényalkalmazás számára, a Monitorozási metrikák közzétevőjével egyenértékű hozzárendelt szerepkörrel.

Feljegyzés

APPLICATIONINSIGHTS_AUTHENTICATION_STRING Ha Microsoft Entra-hitelesítéssel szeretne csatlakozni az Application Insightshoz, tiltsa le az Application Insights helyi hitelesítését is. Ehhez a konfigurációhoz Microsoft Entra-hitelesítés szükséges ahhoz, hogy a telemetriát betöltse a munkaterületre.

APPLICATIONINSIGHTS_CONNECTION_STRING

Az Application Insights 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 Application Insights-példány szuverén felhőben fut, amelyhez egyéni végpont szükséges.

További információ: Kapcsolati sztringek.

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

Ha Microsoft Entra-hitelesítéssel szeretne csatlakozni az Application Insightshoz, használja APPLICATIONINSIGHTS_AUTHENTICATION_STRINGa következőt: .

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

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.

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_ENVIRONMENT Development 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.

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 AzureWebJobsSecretStorageType kubernetes: . Ha AzureWebJobsKubernetesSecretName nincs beállítva, az adattár csak olvashatónak 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ó: Kulcstároló kezelése.

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 AzureWebJobsSecretStorageType keyvault: . A Functions-futtatókörnyezet 4.x és újabb verzióiban támogatott.

Kulcs	Mintaérték
AzureWebJobsSecretStorageKeyVaultClientId	<CLIENT_ID>

További információ: Kulcstároló kezelése.

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 AzureWebJobsSecretStorageType keyvault: . A Functions-futtatókörnyezet 4.x és újabb verzióiban támogatott.

Kulcs	Mintaérték
AzureWebJobsSecretStorageKeyVaultClientSecret	<CLIENT_SECRET>

További információ: Kulcstároló kezelése.

AzureWebJobsSecretStorageKeyVaultName

Ez a beállítás elavult, és csak az Azure Functions-futtatókörnyezet 3.x-es verzióján való futtatáskor lett használva.

A kulcsok tárolására használt kulcstartópéldány neve. Ezt a beállítást csak a Functions-futtatókörnyezet 3.x verziójában használták, amely már nem 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 AzureWebJobsSecretStorageType keyvault: .

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ó: Kulcstároló kezelése.

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 AzureWebJobsSecretStorageType keyvault: . A Functions-futtatókörnyezet 4.x és újabb verzióiban támogatott. További információ: Kulcstároló kezelése.

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 AzureWebJobsSecretStorageType keyvault: .

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://.

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
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ó: Kulcstároló kezelése.

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 AzureWebJobsSecretStorageKeyVaultNamepé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 csak olvashatónak 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ó: Kulcstároló kezelése.

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óért lásd: Csatlakozás gazdagéptárolóhoz identitással.

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óért lásd: Csatlakozás gazdagéptárolóhoz identitással.

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

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óért lásd: Csatlakozás gazdagéptárolóhoz identitással.

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

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óért lásd: Csatlakozás gazdagéptárolóhoz identitással.

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, ~4hogy a főverzió legújabb verzióját használja (például). Ha ugyanannak a főverziónak új alverziói érhetők el, azok automatikusan telepítve lesznek a függvényalkalmazásban.

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
~1	1.x	A támogatás 2026. szeptember 14-én véget ér

Az érték ~4 azt jelenti, hogy az alkalmazás a futtatókörnyezet 4.x verzióján fut. Egy érték ~1 rögzíti az alkalmazást a futtatókörnyezet 1.x-es verziójára. A 2.x és 3.x futtatókörnyezeti verziók már nem támogatottak. További információkért tekintse meg az Azure Functions futtatókörnyezeti verzióinak áttekintését. Ha a támogatási szolgálat azt kéri, hogy rögzítse az alkalmazást egy adott alverzióra, használja a teljes verziószámot (például 4.0.12345). További információ: Azure Functions futtatókörnyezet-verziók megcélzása.

FUNCTIONS_INPROC_NET8_ENABLED

Azt jelzi, hogy egy alkalmazás használhatja-e a .NET 8-at a folyamatban lévő modellen. A .NET 8 folyamaton belüli modellen való használatához ezt az értéket a következőre kell állítani 1: . A .NET 8 célra való frissítésével kapcsolatos részletes útmutatásért tekintse meg az egyéb szükséges konfigurációs értékeket is.

Kulcs	Mintaérték
FUNCTIONS_INPROC_NET8_ENABLED	1

Állítsa be úgy, hogy 0 letiltsa a .NET 8 támogatását a folyamatban lévő modellen.

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 Application Insightsban.

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ást használja, é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 Application Insightsban.
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 Application Insightsban.

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_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_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.

languageWorkers__java__arguments

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álja AppInsights, győződjön meg arról, hogy az Application Insights 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.

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

Kapcsolati sztring a tárfiókhoz, ahol a függvényalkalmazás kódja és konfigurációja eseményvezérelt skálázási csomagokban 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

Fontos

WEBSITE_CONTENTOVERVNET egy régi alkalmazásbeállítás, amelyet a vnetContentShareEnabled helytulajdonság vált fel .

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álathoz WEBSITE_CONTENTSHARE és WEBSITE_CONTENTAZUREFILECONNECTIONSTRINGa . További információ: Tárfiók korlátozása virtuális hálózatra.

Kulcs	Mintaérték
WEBSITE_CONTENTOVERVNET	1

Ez az alkalmazásbeállítás az Elastic Premium és a Dedikált (App Service) csomagokban (Standard és újabb) szükséges. Használatalapú csomagon való futtatáskor nem támogatott.

Feljegyzés

Különös figyelmet kell fordítania arra, hogy az ugyanazon csomagban több függvényalkalmazás által megosztott tárfiókban lévő tartalommegosztáshoz útválasztást alkalmazzon. További információ: Konzisztens útválasztás virtuális hálózatokon keresztül a Storage-szempontok című cikkben.

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_SERVER

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_SERVER	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_SETTINGS

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_SETTINGS	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	Csomag	Érték
A 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_USE_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_USE_PLACEHOLDER	1

WEBSITE_USE_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_USE_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 az összes alkalmazásforgalom a virtuális hálózaton keresztül van irányítva. Erre a beállításra akkor lesz szüksége, ha regionális virtuális hálózati integrációt konfigurál az Elastic Premium és a Dedikált üzemeltetési csomagokban. 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_SERVICE_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 .

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 Functions-futtatókörnyezet néhány perc inaktivitás után tétlen lesz, amely pont csak egy HTTP-eseményindítóhoz érkező kérések ébresztik fel a függvényalkalmazást. 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ő triggerfüggvényeket 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.

functionsRuntimeAdminIsolationEnabled

Meghatározza, hogy a függvényalkalmazás beépített rendszergazdai (/admin) végpontjai elérhetők-e. Ha az alapértelmezett értékre van false állítva, az alkalmazás engedélyezi a végpontokra irányuló kéréseket/admin, amikor ezek a kérések egy főkulcsot mutatnak be a kérésben. Amikor truea /admin végpontok nem érhetők el, még fő kulccsal sem.

Ez a tulajdonság nem állítható be a Linux-használat termékváltozatán futó alkalmazásokhoz, és nem állítható be az Azure Functions 1.x-es verzióján futó alkalmazásokhoz. Ha az 1.x verziót használja, először át kell telepítenie a 4.x verzióra.

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.

vnetContentShareEnabled

A Prémium csomagban futó alkalmazások fájlmegosztással tárolják a tartalmakat. Ennek a tartalommegosztásnak a neve az WEBSITE_CONTENTSHARE alkalmazásbeállításban van tárolva, és a kapcsolati sztring a rendszer tárolja.WEBSITE_CONTENTAZUREFILECONNECTIONSTRING A függvényalkalmazás és a tartalommegosztás közötti forgalom virtuális hálózaton keresztüli átirányításához a következőt kell beállítania vnetContentShareEnabled true: . A webhelytulajdonság engedélyezése követelmény, ha a tárfiókot egy virtuális hálózatra korlátozza az Elastic Premium és a Dedikált üzemeltetési csomagokban.

Feljegyzés

Különös figyelmet kell fordítania arra, hogy az ugyanazon csomagban több függvényalkalmazás által megosztott tárfiókban lévő tartalommegosztáshoz útválasztást alkalmazzon. További információ: Konzisztens útválasztás virtuális hálózatokon keresztül a Storage-szempontok című cikkben.

Ez a webhelytulajdonság felülírja az örökölt WEBSITE_CONTENTOVERVNET beállítást.

vnetImagePullEnabled

A Functions támogatja a Linux-tárolókban futó függvényalkalmazásokat. A virtuális hálózaton belüli tárolóregisztrációs adatbázishoz való csatlakozáshoz és lekéréshez be kell állítania a következőt vnetImagePullEnabled true: . Ez a webhelytulajdonság az Elastic Premium és a Dedikált üzemeltetési csomagokban támogatott. A Rugalmas használat csomag nem támaszkodik a webhelytulajdonságokra vagy az alkalmazásbeállításokra a hálózatkezelés konfigurálásához. További információ: Flex Consumption plan elavulások.

vnetRouteAllEnabled

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 true azt jelzi, hogy az összes alkalmazásforgalom a virtuális hálózaton keresztül van irányítva. Ezt a beállítást akkor használja, ha regionális virtuális hálózati integrációt konfigurál az Elastic Premium és a Dedikált csomagokban. 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. További információ: Alkalmazás-útválasztás konfigurálása.

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

Rugalmas kihasználtságú csomag elavulása

A Rugalmas használat csomagban ezek a webhelytulajdonságok és alkalmazásbeállítások elavultak, és nem használhatók függvényalkalmazás-erőforrások létrehozásakor:

Beállítás/tulajdonság	Ok
ENABLE_ORYX_BUILD	A rugalmas használatban való üzembe helyezéskor a remoteBuild paraméter váltja fel
FUNCTIONS_EXTENSION_VERSION	Az alkalmazásbeállítást a háttérrendszer állítja be. A ~1 érték figyelmen kívül hagyható.
FUNCTIONS_WORKER_RUNTIME	Helyébe a következő lép name : properties.functionAppConfig.runtime
FUNCTIONS_WORKER_RUNTIME_VERSION	Helyébe a következő lép version : properties.functionAppConfig.runtime
FUNCTIONS_MAX_HTTP_CONCURRENCY	A skálázás és az egyidejűség eseményindító szakasza váltja fel
FUNCTIONS_WORKER_PROCESS_COUNT	Érvénytelen beállítás
FUNCTIONS_WORKER_DYNAMIC_CONCURRENCY_ENABLED	Érvénytelen beállítás
SCM_DO_BUILD_DURING_DEPLOYMENT	A rugalmas használatban való üzembe helyezéskor a remoteBuild paraméter váltja fel
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING	A functionAppConfig üzembe helyezési szakasza váltotta fel
WEBSITE_CONTENTOVERVNET	Nem használható hálózatkezeléshez a Flex-használatban
WEBSITE_CONTENTSHARE	A functionAppConfig üzembe helyezési szakasza váltotta fel
WEBSITE_DNS_SERVER	A DNS öröklődik a Flex integrált virtuális hálózatától
WEBSITE_NODE_DEFAULT_VERSION	Helyébe a következő lép version : properties.functionAppConfig.runtime
WEBSITE_RUN_FROM_PACKAGE	Nincs használatban a Rugalmas használatban lévő üzembe helyezésekhez
WEBSITE_SKIP_CONTENTSHARE_VALIDATION	A tartalommegosztás nem használatos a Flex-használatban
WEBSITE_VNET_ROUTE_ALL	Nem használható hálózatkezeléshez a Flex-használatban
properties.alwaysOn	Nem érvényes
properties.containerSize	Átnevezve: instanceMemoryMB
properties.ftpsState	Az FTPS nem támogatott
properties.isReserved	Nem érvényes
properties.IsXenon	Nem érvényes
properties.javaVersion	Helyébe a következő lép version : properties.functionAppConfig.runtime
properties.LinuxFxVersion	Helyébe a következő lép: properties.functionAppConfig.runtime
properties.netFrameworkVersion	Helyébe a következő lép version : properties.functionAppConfig.runtime
properties.powerShellVersion	Helyébe a következő lép version : properties.functionAppConfig.runtime
properties.siteConfig.functionAppScaleLimit	Átnevezve: maximumInstanceCount
properties.siteConfig.preWarmedInstanceCount	Átnevezve: alwaysReadyInstances
properties.use32BitWorkerProcess	A 32 bites nem támogatott
properties.vnetBackupRestoreEnabled	Nem használható hálózatkezeléshez a Flex-használatban
properties.vnetContentShareEnabled	Nem használható hálózatkezeléshez a Flex-használatban
properties.vnetImagePullEnabled	Nem használható hálózatkezeléshez a Flex-használatban
properties.vnetRouteAllEnabled	Nem használható hálózatkezeléshez a Flex-használatban
properties.windowsFxVersion	Nem érvényes

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