Referenční materiály k nastavení aplikací pro Azure Functions
Nastavení aplikace v aplikaci funkcí obsahují možnosti konfigurace, které ovlivňují všechny funkce pro danou aplikaci funkcí. K těmto nastavením se přistupuje jako k proměnným prostředí. Tento článek obsahuje seznam nastavení aplikace, která jsou k dispozici v aplikacích funkcí.
Nastavení aplikace funkcí můžete přidat, aktualizovat a odstranit několika způsoby:
Změny nastavení aplikace funkcí vyžadují restartování aplikace funkcí.
V tomto článku jsou příklady připojovací řetězec hodnoty zkráceny pro čitelnost.
Vzhledem k tomu, že Azure Functions využívá platformu Aplikace Azure Service k hostování, můžou být některá nastavení relevantní pro hostování vaší aplikace funkcí popsané v proměnných prostředí a nastavení aplikace v Aplikace Azure Service.
Důležité informace o nastavení aplikace
Při používání nastavení aplikace byste měli vědět o následujících aspektech:
Změny nastavení aplikace funkcí vyžadují restartování aplikace funkcí.
V názvech nastavení se za rezervované hodnoty považují dvojité podtržítko (
__
) a dvojtečka (:
). Dvojitá podtržítka se interpretují jako hierarchické oddělovače v systémech Windows i Linux a dvojtečky se interpretují stejným způsobem pouze v Linuxu. NastaveníAzureFunctionsWebHost__hostid=somehost_123456
by se například interpretovalo jako následující objekt JSON:"AzureFunctionsWebHost": { "hostid": "somehost_123456" }
V tomto článku se používají pouze dvojitá podtržítka, protože jsou podporovány v obou operačních systémech. Většina nastavení, která podporují připojení spravovaných identit, používají dvojité podtržítka.
Když se functions spustí místně, nastavení aplikace se zadává v
Values
kolekci v local.settings.json.V souboru host.json a v souboru local.settings.json existují další možnosti konfigurace aplikace funkcí.
Nastavení aplikace můžete použít k přepsání hodnot nastavení host.json bez nutnosti měnit host.json samotný soubor. To je užitečné pro scénáře, ve kterých potřebujete nakonfigurovat nebo upravit konkrétní nastavení host.json pro konkrétní prostředí. To vám také umožní změnit nastavení host.json, aniž byste museli projekt znovu publikovat. Další informace najdete v referenčním článku host.json.
Tento článek popisuje nastavení, která jsou pro vaše aplikace funkcí nejrelevantní. Protože služba Azure Functions běží ve službě App Service, podporují se také další nastavení aplikace. Další informace najdete v tématu Proměnné prostředí a nastavení aplikace ve službě Aplikace Azure Service.
Některé scénáře také vyžadují práci s nastavením zdokumentovanými v nastavení webu služby App Service.
Změna nastavení aplikace App Service jen pro čtení může aplikaci funkcí umístit do nereagujícího stavu.
Při aktualizaci nastavení aplikace využijte rozhraní REST API, včetně šablon ARM. Vzhledem k tomu, že tato rozhraní API nahrazují stávající nastavení aplikace, musíte zahrnout všechna existující nastavení při přidávání nebo úpravách nastavení pomocí rozhraní REST API nebo šablon ARM. Pokud je to možné, použijte Azure CLI nebo Azure PowerShell k programové práci s nastavením aplikace. Další informace naleznete v tématu Práce s nastavením aplikace.
APPINSIGHTS_INSTRUMENTATIONKEY
Instrumentační klíč pro Application Insights. Nepoužívejte obojí APPINSIGHTS_INSTRUMENTATIONKEY
ani APPLICATIONINSIGHTS_CONNECTION_STRING
. Pokud je to možné, použijte APPLICATIONINSIGHTS_CONNECTION_STRING
. Když Application Insights běží v suverénním cloudu, musíte použít APPLICATIONINSIGHTS_CONNECTION_STRING
. Další informace najdete v tématu Konfigurace monitorování pro Azure Functions.
Klíč | Ukázková hodnota |
---|---|
APPINSIGHTS_INSTRUMENTATIONKEY | 55555555-af77-484b-9032-64f83bb83bb |
Nepoužívejte obojí APPINSIGHTS_INSTRUMENTATIONKEY
ani APPLICATIONINSIGHTS_CONNECTION_STRING
. Doporučuje se použít.APPLICATIONINSIGHTS_CONNECTION_STRING
APPLICATIONINSIGHTS_AUTHENTICATION_STRING
Umožňuje přístup k Application Insights pomocí ověřování Microsoft Entra. Toto nastavení použijte, když se musíte připojit k pracovnímu prostoru Application Insights pomocí ověřování Microsoft Entra. Další informace naleznete v tématu Ověřování Microsoft Entra pro Application Insights.
Při použití APPLICATIONINSIGHTS_AUTHENTICATION_STRING
závisí konkrétní hodnota, kterou nastavíte, na typu spravované identity:
Spravovaná identita | Hodnota nastavení |
---|---|
Přiřazeno systémem | Authorization=AAD |
Přiřazeno uživatelem | Authorization=AAD;ClientId=<USER_ASSIGNED_CLIENT_ID> |
Tento požadavek na ověřování se použije pro připojení z hostitele služby Functions, ladicího programu snímků, profileru a agentů specifických pro jazyk. Pokud chcete toto nastavení použít, musí už být spravovaná identita dostupná pro aplikaci funkcí s přiřazenou rolí, která je ekvivalentní vydavateli metrik monitorování.
Poznámka:
Pokud se připojujete APPLICATIONINSIGHTS_AUTHENTICATION_STRING
k Application Insights pomocí ověřování Microsoft Entra, měli byste také zakázat místní ověřování pro Application Insights. Tato konfigurace vyžaduje ověřování Microsoft Entra, aby se telemetrie mohla ingestovat do vašeho pracovního prostoru.
APPLICATIONINSIGHTS_CONNECTION_STRING
Připojovací řetězec pro Application Insights. Nepoužívejte obojí APPINSIGHTS_INSTRUMENTATIONKEY
ani APPLICATIONINSIGHTS_CONNECTION_STRING
. I když se použití APPLICATIONINSIGHTS_CONNECTION_STRING
doporučuje ve všech případech, je vyžadováno v následujících případech:
- Když vaše aplikace funkcí vyžaduje přidání vlastních nastavení podporovaných pomocí připojovací řetězec.
- Když vaše instance Application Insights běží v suverénním cloudu, který vyžaduje vlastní koncový bod.
Další informace naleznete v tématu Připojovací řetězce.
Klíč | Ukázková hodnota |
---|---|
APPLICATIONINSIGHTS_CONNECTION_STRING | InstrumentationKey=... |
Pokud se chcete připojit k Application Insights pomocí ověřování Microsoft Entra, měli byste použít APPLICATIONINSIGHTS_AUTHENTICATION_STRING
.
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL
Důležité
Proxy služby Azure Functions je starší funkce pro verze 1.x až 3.x modulu runtime Azure Functions. Další informace o starší verzi podpory ve verzi 4.x najdete v tématu Proxy služby Functions.
Proxy služby Functions ve výchozím nastavení používají zástupce k odesílání volání rozhraní API z proxy serverů přímo do funkcí ve stejné aplikaci funkcí. Tento zástupce se používá místo vytvoření nového požadavku HTTP. Toto nastavení umožňuje zakázat toto chování zástupce.
Key | Hodnota | Popis |
---|---|---|
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL | true |
Volání s back-endovou adresou URL odkazující na funkci v místní aplikaci funkcí se do funkce neodesílají přímo. Místo toho se požadavky směrují zpět do front-endu HTTP aplikace funkcí. |
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL | false |
Volání s back-endovou adresou URL odkazující na funkci v místní aplikaci funkcí se předávají přímo do funkce. false je výchozí hodnota. |
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES
Důležité
Proxy služby Azure Functions je starší funkce pro verze 1.x až 3.x modulu runtime Azure Functions. Další informace o starší verzi podpory ve verzi 4.x najdete v tématu Proxy služby Functions.
Toto nastavení určuje, jestli jsou znaky %2F
dekódovány jako lomítka v parametrech trasy při jejich vložení do adresy URL back-endu.
Key | Hodnota | Popis |
---|---|---|
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES | true |
Parametry trasy s zakódovanými lomítky jsou dekódovány. |
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES | false |
Všechny parametry trasy se předávají beze změny, což je výchozí chování. |
Představte si například soubor proxies.json aplikace funkcí v myfunction.com
doméně.
{
"$schema": "http://json.schemastore.org/proxies",
"proxies": {
"root": {
"matchCondition": {
"route": "/{*all}"
},
"backendUri": "example.com/{all}"
}
}
}
Pokud AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES
je nastavená hodnota true
, adresa URL example.com/api%2ftest
se přeloží na example.com/api/test
. Ve výchozím nastavení zůstane adresa URL beze změny .example.com/test%2fapi
Další informace najdete v tématu Proxy služby Functions.
AZURE_FUNCTIONS_ENVIRONMENT
Nakonfiguruje hostitelské prostředí runtime aplikace funkcí při spuštění v Azure. Tato hodnota se čte během inicializace a modul runtime respektuje pouze tyto hodnoty:
Toto nastavení použijte místo ASPNETCORE_ENVIRONMENT
toho, když potřebujete změnit prostředí runtime v Azure na něco jiného než Production
. Další informace naleznete v tématu Environment-based Startup třídy a metody.
Toto nastavení není k dispozici ve verzi 1.x modulu runtime služby Functions.
AzureFunctionsJobHost__*
Ve verzi 2.x a novějších verzích modulu runtime Functions můžou nastavení aplikace přepsat nastavení host.json v aktuálním prostředí. Tato přepsání jsou vyjádřena jako nastavení aplikace s názvem AzureFunctionsJobHost__path__to__setting
. Další informace najdete v tématu Přepsání hodnot host.json.
AzureFunctionsWebHost__hostid
Nastaví ID hostitele pro danou aplikaci funkcí, což by mělo být jedinečné ID. Toto nastavení přepíše automaticky vygenerovanou hodnotu ID hostitele pro vaši aplikaci. Toto nastavení použijte jenom v případě, že potřebujete zabránit kolizím ID hostitele mezi aplikacemi funkcí, které sdílejí stejný účet úložiště.
ID hostitele musí splňovat následující požadavky:
- Musí být mezi 1 a 32 znaky.
- obsahují pouze malá písmena, číslice a pomlčky.
- Nezačíná nebo končí pomlčkou
- Neobsahuje po sobě jdoucí pomlčky.
Snadným způsobem, jak vygenerovat ID, je vzít identifikátor GUID, odebrat pomlčky a nastavit ho jako malá písmena, například převedením identifikátoru GUID 1835D7B5-5C98-4790-815D-072CC94C6F71
na hodnotu 1835d7b55c984790815d072cc94c6f71
.
Klíč | Ukázková hodnota |
---|---|
AzureFunctionsWebHost__hostid | myuniquefunctionappname123456789 |
Další informace najdete v tématu Důležité informace o ID hostitele.
AzureWebJobsDashboard
Toto nastavení je zastaralé a podporuje se pouze při spuštění na verzi 1.x modulu runtime Azure Functions.
Volitelný účet úložiště připojovací řetězec pro ukládání protokolů a jejich zobrazení na kartě Monitorování na portálu. Účet úložiště musí být univerzální účet, který podporuje objekty blob, fronty a tabulky. Další informace najdete v tématu Požadavky na účet úložiště.
Klíč | Ukázková hodnota |
---|---|
AzureWebJobsDashboard | DefaultEndpointsProtocol=https;AccountName=... |
Stránka AzureWebJobsDisableHomepage
Hodnota true
zakáže výchozí cílovou stránku, která se zobrazí pro kořenovou adresu URL aplikace funkcí. Výchozí hodnota je false
.
Klíč | Ukázková hodnota |
---|---|
Stránka AzureWebJobsDisableHomepage | true |
Pokud toto nastavení aplikace vynecháte nebo nastavíte false
na , zobrazí se stránka podobná následujícímu příkladu v odpovědi na adresu URL <functionappname>.azurewebsites.net
.
AzureWebJobsDotNetReleaseCompilation
true
znamená použití režimu vydání při kompilaci kódu .NET; false
znamená použít režim ladění. Výchozí hodnota je true
.
Klíč | Ukázková hodnota |
---|---|
AzureWebJobsDotNetReleaseCompilation | true |
AzureWebJobsFeatureFlags
Seznam beta funkcí oddělených čárkami, které chcete povolit. Beta funkce povolené těmito příznaky nejsou připravené pro produkční prostředí, ale před zahájením jejich provozu je možné povolit pro experimentální použití.
Klíč | Ukázková hodnota |
---|---|
AzureWebJobsFeatureFlags | feature1,feature2,EnableProxies |
Přidáním EnableProxies
do tohoto seznamu znovu povolíte proxy servery ve verzi 4.x modulu runtime Functions při plánování migrace do služby Azure API Management. Další informace najdete v tématu Opětovné povolení proxy serverů ve službě Functions v4.x.
AzureWebJobsKubernetesSecretName
Označuje prostředek tajných kódů Kubernetes, který se používá k ukládání klíčů. Podporováno pouze při spuštění v Kubernetes. Toto nastavení vyžaduje, abyste nastavili AzureWebJobsSecretStorageType
hodnotu kubernetes
. Pokud AzureWebJobsKubernetesSecretName
není nastavené, úložiště se považuje za jen pro čtení. V takovém případě musí být hodnoty generovány před nasazením. Nástroje Azure Functions Core Tools tyto hodnoty generují automaticky při nasazování do Kubernetes.
Klíč | Ukázková hodnota |
---|---|
AzureWebJobsKubernetesSecretName | <SECRETS_RESOURCE> |
Další informace najdete v tématu Správa úložiště klíčů.
AzureWebJobsSecretStorageKeyVaultClientId
ID klienta spravované identity přiřazené uživatelem nebo registrace aplikace použité pro přístup k trezoru, ve kterém jsou uložené klíče. Toto nastavení vyžaduje, abyste nastavili AzureWebJobsSecretStorageType
hodnotu keyvault
. Podporováno ve verzi 4.x a novějších verzích modulu runtime Functions.
Klíč | Ukázková hodnota |
---|---|
AzureWebJobsSecretStorageKeyVaultClientId | <CLIENT_ID> |
Další informace najdete v tématu Správa úložiště klíčů.
AzureWebJobsSecretStorageKeyVaultClientSecret
Tajný klíč pro ID klienta spravované identity přiřazené uživatelem nebo registraci aplikace sloužící k přístupu k trezoru, kde jsou uložené klíče. Toto nastavení vyžaduje, abyste nastavili AzureWebJobsSecretStorageType
hodnotu keyvault
. Podporováno ve verzi 4.x a novějších verzích modulu runtime Functions.
Klíč | Ukázková hodnota |
---|---|
AzureWebJobsSecretStorageKeyVaultClientSecret | <CLIENT_SECRET> |
Další informace najdete v tématu Správa úložiště klíčů.
AzureWebJobsSecretStorageKeyVaultName
Toto nastavení je zastaralé a používalo se pouze při spuštění na verzi 3.x modulu runtime Azure Functions.
Název instance trezoru klíčů sloužící k ukládání klíčů. Toto nastavení se používalo pouze ve verzi 3.x modulu runtime služby Functions, který se už nepodporuje. Pro verzi 4.x místo toho použijte AzureWebJobsSecretStorageKeyVaultUri
. Toto nastavení vyžaduje, abyste nastavili AzureWebJobsSecretStorageType
hodnotu keyvault
.
Trezor musí mít zásadu přístupu odpovídající spravované identitě přiřazené systémem hostitelského prostředku. Zásady přístupu by měly identitě udělit následující oprávnění k tajným kódům: Get
,Set
, List
a Delete
.
Při místním spuštění funkcí se použije identita vývojáře a nastavení musí být v souboru local.settings.json.
Klíč | Ukázková hodnota |
---|---|
AzureWebJobsSecretStorageKeyVaultName | <VAULT_NAME> |
Další informace najdete v tématu Správa úložiště klíčů.
AzureWebJobsSecretStorageKeyVaultTenantId
ID tenanta registrace aplikace použité pro přístup k trezoru, ve kterém jsou uložené klíče. Toto nastavení vyžaduje, abyste nastavili AzureWebJobsSecretStorageType
hodnotu keyvault
. Podporováno ve verzi 4.x a novějších verzích modulu runtime Functions. Další informace najdete v tématu Správa úložiště klíčů.
Klíč | Ukázková hodnota |
---|---|
AzureWebJobsSecretStorageKeyVaultTenantId | <TENANT_ID> |
AzureWebJobsSecretStorageKeyVaultUri
Identifikátor URI instance trezoru klíčů sloužící k ukládání klíčů. Podporováno ve verzi 4.x a novějších verzích modulu runtime Functions. Toto je doporučené nastavení pro použití instance trezoru klíčů pro úložiště klíčů. Toto nastavení vyžaduje, abyste nastavili AzureWebJobsSecretStorageType
hodnotu keyvault
.
Hodnota AzureWebJobsSecretStorageKeyVaultUri
by měla být úplná hodnota identifikátoru URI trezoru zobrazeného na kartě Přehled služby Key Vault, včetně https://
.
Trezor musí mít zásadu přístupu odpovídající spravované identitě přiřazené systémem hostitelského prostředku. Zásady přístupu by měly identitě udělit následující oprávnění k tajným kódům: Get
,Set
, List
a Delete
.
Při místním spuštění funkcí se použije identita vývojáře a nastavení musí být v souboru local.settings.json.
Klíč | Ukázková hodnota |
---|---|
AzureWebJobsSecretStorageKeyVaultUri | https://<VAULT_NAME>.vault.azure.net |
Další informace najdete v tématu o použití odkazů na službu Key Vault pro Azure Functions.
AzureWebJobsSecretStorageSas
Adresa URL SAS služby Blob Storage pro druhý účet úložiště, který se používá pro úložiště klíčů. Funkce ve výchozím nastavení používá účet nastavený v AzureWebJobsStorage
. Při použití této možnosti úložiště tajných kódů se ujistěte, že AzureWebJobsSecretStorageType
není explicitně nastavená nebo je nastavena na blob
. Další informace najdete v tématu Správa úložiště klíčů.
Klíč | Ukázková hodnota |
---|---|
AzureWebJobsSecretStorageSas | <BLOB_SAS_URL> |
AzureWebJobsSecretStorageType
Určuje úložiště nebo zprostředkovatele, které se má použít pro úložiště klíčů. Klíče se před uložením vždy šifrují pomocí tajného klíče jedinečného pro vaši aplikaci funkcí.
Key | Hodnota | Popis |
---|---|---|
AzureWebJobsSecretStorageType | blob |
Klíče se ukládají v kontejneru úložiště objektů blob v účtu poskytnutém nastavením AzureWebJobsStorage . Blob Storage je výchozí chování, pokud AzureWebJobsSecretStorageType není nastavené.Pokud chcete zadat jiný účet úložiště, použijte AzureWebJobsSecretStorageSas nastavení k označení adresy URL SAS druhého účtu úložiště. |
AzureWebJobsSecretStorageType | files |
Klíče jsou trvalé v systému souborů. Toto je výchozí chování pro functions v1.x. |
AzureWebJobsSecretStorageType | keyvault |
Klíče jsou uloženy v instanci trezoru klíčů nastavenou pomocí AzureWebJobsSecretStorageKeyVaultName . |
AzureWebJobsSecretStorageType | kubernetes |
Je to podporované jen při spouštění modulu runtime služby Functions v Kubernetes. Pokud AzureWebJobsKubernetesSecretName není nastavené, úložiště se považuje za jen pro čtení. V takovém případě musí být hodnoty generovány před nasazením. Nástroje Azure Functions Core Tools tyto hodnoty generují automaticky při nasazování do Kubernetes. |
Další informace najdete v tématu Správa úložiště klíčů.
AzureWebJobsStorage
Určuje připojovací řetězec pro účet služby Azure Storage, který modul runtime Služby Functions používá pro normální operace. Mezi použití tohoto účtu úložiště službou Functions patří správa klíčů, správa triggerů časovače a kontrolní body služby Event Hubs. Účet úložiště musí být univerzální účet, který podporuje objekty blob, fronty a tabulky. Další informace najdete v tématu Požadavky na účet úložiště.
Klíč | Ukázková hodnota |
---|---|
AzureWebJobsStorage | DefaultEndpointsProtocol=https;AccountName=... |
Místo připojovací řetězec můžete pro tento účet úložiště použít připojení založené na identitě. Další informace najdete v části Připojení k hostitelskému úložišti s využitím identity.
AzureWebJobsStorage__accountName
Při použití připojení úložiště založeného na identitě nastaví název účtu úložiště místo použití připojovací řetězec v AzureWebJobsStorage
. Tato syntaxe je jedinečná AzureWebJobsStorage
pro připojení založená na identitách a nedá se použít pro jiná připojení založená na identitách.
Klíč | Ukázková hodnota |
---|---|
AzureWebJobsStorage__accountName | <STORAGE_ACCOUNT_NAME> |
Pro suverénní cloudy nebo při použití vlastního DNS musíte místo toho použít nastavení specifická pro AzureWebJobsStorage__*ServiceUri
službu.
AzureWebJobsStorage__blobServiceUri
Při použití připojení úložiště založeného na identitě nastaví identifikátor URI roviny dat služby blob účtu úložiště.
Klíč | Ukázková hodnota |
---|---|
AzureWebJobsStorage__blobServiceUri | https://<STORAGE_ACCOUNT_NAME>.blob.core.windows.net |
Toto nastavení použijte místo AzureWebJobsStorage__accountName
v suverénních cloudech nebo při použití vlastního DNS. Další informace najdete v části Připojení k hostitelskému úložišti s využitím identity.
AzureWebJobsStorage__queueServiceUri
Při použití připojení úložiště založeného na identitě nastaví identifikátor URI roviny dat služby fronty účtu úložiště.
Klíč | Ukázková hodnota |
---|---|
AzureWebJobsStorage__queueServiceUri | https://<STORAGE_ACCOUNT_NAME>.queue.core.windows.net |
Toto nastavení použijte místo AzureWebJobsStorage__accountName
v suverénních cloudech nebo při použití vlastního DNS. Další informace najdete v části Připojení k hostitelskému úložišti s využitím identity.
AzureWebJobsStorage__tableServiceUri
Při použití připojení úložiště založeného na identitě nastaví identifikátor URI roviny dat tabulkové služby účtu úložiště.
Klíč | Ukázková hodnota |
---|---|
AzureWebJobsStorage__tableServiceUri | https://<STORAGE_ACCOUNT_NAME>.table.core.windows.net |
Toto nastavení použijte místo AzureWebJobsStorage__accountName
v suverénních cloudech nebo při použití vlastního DNS. Další informace najdete v části Připojení k hostitelskému úložišti s využitím identity.
AzureWebJobs_TypeScriptPath
Cesta ke kompilátoru použitému pro TypeScript Umožňuje přepsat výchozí nastavení, pokud potřebujete.
Klíč | Ukázková hodnota |
---|---|
AzureWebJobs_TypeScriptPath | %HOME%\typescript |
DOCKER_REGISTRY_SERVER_PASSWORD
Označuje heslo použité pro přístup k privátnímu registru kontejneru. Toto nastavení se vyžaduje jenom při nasazování kontejnerizované aplikace funkcí z privátního registru kontejneru. Další informace najdete v tématu Proměnné prostředí a nastavení aplikace ve službě Aplikace Azure Service.
DOCKER_REGISTRY_SERVER_URL
Označuje adresu URL privátního registru kontejneru. Toto nastavení se vyžaduje jenom při nasazování kontejnerizované aplikace funkcí z privátního registru kontejneru. Další informace najdete v tématu Proměnné prostředí a nastavení aplikace ve službě Aplikace Azure Service.
DOCKER_REGISTRY_SERVER_USERNAME
Označuje účet použitý pro přístup k privátnímu registru kontejneru. Toto nastavení se vyžaduje jenom při nasazování kontejnerizované aplikace funkcí z privátního registru kontejneru. Další informace najdete v tématu Proměnné prostředí a nastavení aplikace ve službě Aplikace Azure Service.
DOCKER_SHM_SIZE
Nastaví velikost sdílené paměti (v bajtech), když pracovní proces Pythonu používá sdílenou paměť. Další informace najdete v tématu Sdílená paměť.
Klíč | Ukázková hodnota |
---|---|
DOCKER_SHM_SIZE | 268435456 |
Výše uvedená hodnota nastaví velikost sdílené paměti přibližně 256 MB.
Vyžaduje, FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED
aby byla nastavena hodnota 1
.
ENABLE_ORYX_BUILD
Určuje, jestli se během nasazování používá systém sestavení Oryx. ENABLE_ORYX_BUILD
při nasazení vzdáleného sestavení do Linuxu musí být nastavená na true
hodnotu. Další informace naleznete v tématu Vzdálené sestavení.
Klíč | Ukázková hodnota |
---|---|
ENABLE_ORYX_BUILD | true |
FUNCTION_APP_EDIT_MODE
Určuje, jestli můžete aplikaci funkcí upravit na webu Azure Portal. Platné hodnoty jsou readwrite
a readonly
.
Klíč | Ukázková hodnota |
---|---|
FUNCTION_APP_EDIT_MODE | readonly |
Hodnota je nastavena modulem runtime na základě zásobníku jazyka a stavu nasazení vaší aplikace funkcí. Další informace najdete v tématu Omezení vývoje na webu Azure Portal.
FUNCTIONS_EXTENSION_VERSION
Verze modulu runtime Functions, která hostuje vaši aplikaci funkcí. Tilda (~
) s hlavní verzí znamená použití nejnovější verze této hlavní verze (například ~4
). Pokud jsou k dispozici nové podverze stejné hlavní verze, automaticky se nainstalují do aplikace funkcí.
Klíč | Ukázková hodnota |
---|---|
FUNCTIONS_EXTENSION_VERSION | ~4 |
Podporují se následující hlavní hodnoty verze modulu runtime:
Hodnota | Cíl modulu runtime | Komentář |
---|---|---|
~4 |
4.x | Doporučené |
~1 |
1.x | Podpora končí 14. září 2026 |
Hodnota ~4
znamená, že vaše aplikace běží na verzi 4.x modulu runtime. Hodnota ~1
připnutí aplikace na verzi 1.x modulu runtime. Verze modulu runtime 2.x a 3.x se už nepodporují. Další informace najdete v přehledu verzí modulu runtime Azure Functions.
Pokud vás podpora požádá o připnutí aplikace na konkrétní podverzi, použijte celé číslo verze (například 4.0.12345
). Další informace najdete v tématu s přehledem verzí modulu runtime služby Azure Functions.
FUNCTIONS_INPROC_NET8_ENABLED
Určuje, jestli aplikace může používat .NET 8 v modelu v procesu. Chcete-li v modelu v procesu používat .NET 8, musí být tato hodnota nastavena na 1
hodnotu . Úplné pokyny, včetně dalších požadovaných hodnot konfigurace, najdete v části Aktualizace na cíl .NET 8 .
Klíč | Ukázková hodnota |
---|---|
FUNCTIONS_INPROC_NET8_ENABLED | 1 |
Nastavte na zakázání 0
podpory pro .NET 8 v modelu procesu.
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR
Toto nastavení aplikace představuje dočasný způsob, jak Node.js aplikacím povolit zásadní změnu, která usnadňuje řešení chyb vstupních bodů při řešení potíží s Node.js v18 nebo nižším. Důrazně se doporučuje používat true
, zejména pro programovací aplikace modelu v4, které vždy používají soubory vstupních bodů. Chování bez zásadní změny (false
) ignoruje chyby vstupního bodu a nezapíše je do Application Insights.
Počínaje Node.js v20 nemá nastavení aplikace žádný vliv a chování způsobující změnu je vždy povolené.
Pro Node.js v18 nebo nižší se použije nastavení aplikace a výchozí chování závisí na tom, jestli k chybě dojde před nebo po registraci funkce modelu v4:
- Pokud se chyba vyvolá dříve (například pokud používáte model v3 nebo soubor vstupního bodu neexistuje), výchozí chování odpovídá
false
. - Pokud je chyba vyvolán po (například při pokusu o registraci duplicitních funkcí modelu v4), výchozí chování odpovídá
true
.
Key | Hodnota | Popis |
---|---|---|
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR | true |
Zablokujte chyby vstupního bodu a protokolujte je v Application Insights. |
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR | false |
Chyby vstupního bodu ignorujte a nepřihlašujte je do Application Insights. |
FUNCTIONS_REQUEST_BODY_SIZE_LIMIT
Přepíše výchozí limit velikosti textu požadavků odesílaných do koncových bodů HTTP. Hodnota je uvedena v bajtech s výchozí maximální velikostí požadavku 104857600 bajtů.
Klíč | Ukázková hodnota |
---|---|
FUNCTIONS_REQUEST_BODY_SIZE_LIMIT | 250000000 |
FUNCTIONS_V2_COMPATIBILITY_MODE
Důležité
Toto nastavení se už nepodporuje. Původně bylo poskytnuto povolení krátkodobého alternativního řešení pro aplikace, které cílí na modul runtime v2.x, aby bylo možné místo toho běžet na modulu runtime v3.x, zatímco byla stále podporována. S výjimkou starších aplikací, které běží na verzi 1.x, musí všechny aplikace funkcí běžet ve verzi 4.x modulu runtime Functions: FUNCTIONS_EXTENSION_VERSION=~4
. Další informace najdete v přehledu verzí modulu runtime Azure Functions.
FUNCTIONS_WORKER_PROCESS_COUNT
Určuje maximální počet procesů pracovních procesů jazyka s výchozí hodnotou 1
. Maximální povolená hodnota je 10
. Volání funkcí se rovnoměrně distribuují mezi procesy pracovních procesů jazyka. Procesy pracovních procesů jazyka se vytvoří každých 10 sekund, dokud nedosáhnete počtu nastavených FUNCTIONS_WORKER_PROCESS_COUNT
. Použití více jazykových pracovních procesů není stejné jako škálování. Toto nastavení zvažte, pokud má vaše úloha kombinaci volání vázaného na procesor a vstupně-výstupní operace. Toto nastavení platí pro všechny moduly runtime jazyka, s výjimkou rozhraní .NET spuštěných v procesu (FUNCTIONS_WORKER_RUNTIME=dotnet
).
Klíč | Ukázková hodnota |
---|---|
FUNCTIONS_WORKER_PROCESS_COUNT | 2 |
FUNCTIONS_WORKER_RUNTIME
Jazyk nebo zásobník jazyka modulu runtime pracovního procesu, který se má načíst v aplikaci funkcí. To odpovídá jazyku používanému ve vaší aplikaci (například python
). Počínaje modulem runtime Azure Functions verze 2.x může daná aplikace funkcí podporovat pouze jeden jazyk.
Klíč | Ukázková hodnota |
---|---|
FUNCTIONS_WORKER_RUNTIME | node |
Platné hodnoty:
Hodnota | Zásobník jazyka a jazyka |
---|---|
dotnet |
C# (knihovna tříd) C# (skript) |
dotnet-isolated |
C# (izolovaný pracovní proces) |
java |
Java |
node |
JavaScript TypeScript |
powershell |
PowerShell |
python |
Python |
custom |
Další |
FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED
Toto nastavení umožňuje pracovnímu procesu Pythonu používat sdílenou paměť ke zlepšení propustnosti. Povolte sdílenou paměť, když aplikace funkcí Pythonu narazila na kritické body paměti.
Klíč | Ukázková hodnota |
---|---|
FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED | 1 |
Pokud je toto nastavení povolené, můžete pomocí nastavení DOCKER_SHM_SIZE nastavit velikost sdílené paměti. Další informace najdete v tématu Sdílená paměť.
JAVA_OPTS
Používá se k přizpůsobení virtuálního počítače Java (JVM) používaného ke spouštění funkcí Javy při spuštění v plánu Premium nebo plánu Dedicated. Při spuštění v plánu Consumption místo toho použijte languageWorkers__java__arguments
. Další informace naleznete v tématu Přizpůsobení prostředí JVM.
languageWorkers__java__arguments
Používá se k přizpůsobení virtuálního počítače Java (JVM) používaného ke spouštění funkcí Java při spuštění v plánu Consumption. Toto nastavení zvyšuje dobu studeného spuštění funkcí Java spuštěných v plánu Consumption. Pro plán Premium nebo Dedicated místo toho použijte JAVA_OPTS
. Další informace naleznete v tématu Přizpůsobení prostředí JVM.
MDMaxBackgroundUpgradePeriod
Řídí období aktualizace spravovaných závislostí na pozadí pro aplikace funkcí PowerShellu s výchozí hodnotou 7.00:00:00
(týdně).
Každý pracovní proces PowerShellu zahájí kontrolu upgradů modulů na Galerie prostředí PowerShell při spuštění procesu a po každém MDMaxBackgroundUpgradePeriod
z nich. Pokud je v Galerie prostředí PowerShell k dispozici nová verze modulu, nainstaluje se do systému souborů a zpřístupní se pracovníkům PowerShellu. Snížením této hodnoty umožníte, aby aplikace funkcí získala novější verze modulů dříve, ale také zvyšuje využití prostředků aplikace (vstupně-výstupní operace sítě, procesor, úložiště). Zvýšení této hodnoty snižuje využití prostředků aplikace, ale může také zpozdit doručování nových verzí modulů do vaší aplikace.
Klíč | Ukázková hodnota |
---|---|
MDMaxBackgroundUpgradePeriod | 7.00:00:00 |
Další informace najdete v tématu Správa závislostí.
MDNewSnapshotCheckPeriod
Určuje, jak často každý pracovní proces PowerShellu kontroluje, jestli byly nainstalovány upgrady spravovaných závislostí. Výchozí frekvence je 01:00:00
(hodinová).
Po instalaci nových verzí modulů do systému souborů se musí restartovat každý pracovní proces PowerShellu. Restartování pracovních procesů PowerShellu má vliv na dostupnost vaší aplikace, protože může přerušit aktuální spuštění funkce. Dokud se všechny pracovní procesy PowerShellu nerestartují, můžou vyvolání funkcí používat staré nebo nové verze modulu. Restartování všech pracovních procesů PowerShellu se dokončí v rámci MDNewSnapshotCheckPeriod
.
V rámci každého MDNewSnapshotCheckPeriod
pracovního procesu PowerShellu zkontroluje, jestli byly nainstalovány upgrady spravovaných závislostí nebo ne. Po instalaci upgradů se zahájí restartování. Zvýšení této hodnoty snižuje četnost přerušení kvůli restartováním. Zvýšení však může také zvýšit dobu, během které mohou vyvolání funkcí používat staré nebo nové verze modulu, nedeterministicky.
Klíč | Ukázková hodnota |
---|---|
MDNewSnapshotCheckPeriod | 01:00:00 |
Další informace najdete v tématu Správa závislostí.
MDMinBackgroundUpgradePeriod
Časové období po předchozí kontrole upgradu spravované závislosti před spuštěním jiné kontroly upgradu s výchozím nastavením 1.00:00:00
(denně).
Pokud se chcete vyhnout nadměrným upgradům modulů při častých restartováních pracovního procesu, kontrola upgradů modulů se neprovádí, pokud už některý pracovní proces zahájil kontrolu za poslední MDMinBackgroundUpgradePeriod
.
Klíč | Ukázková hodnota |
---|---|
MDMinBackgroundUpgradePeriod | 1.00:00:00 |
Další informace najdete v tématu Správa závislostí.
PIP_INDEX_URL
Toto nastavení umožňuje přepsat základní adresu URL indexu balíčků Pythonu, což je https://pypi.org/simple
ve výchozím nastavení . Toto nastavení použijte, když potřebujete spustit vzdálené sestavení pomocí vlastních závislostí. Tyto vlastní závislosti můžou být v úložišti indexu balíčků kompatibilním s PEP 503 (jednoduché rozhraní API úložiště) nebo v místním adresáři, který má stejný formát.
Klíč | Ukázková hodnota |
---|---|
PIP_INDEX_URL | http://my.custom.package.repo/simple |
Další informace najdete pip
v dokumentaci k --index-url
použití vlastních závislostí v referenčních informacích pro vývojáře Pythonu.
PIP_EXTRA_INDEX_URL
Hodnota pro toto nastavení označuje extra adresu URL indexu pro vlastní balíčky pro aplikace v Pythonu --index-url
, která se má použít kromě . Toto nastavení použijte, když potřebujete spustit vzdálené sestavení pomocí vlastních závislostí nalezených v extra indexu balíčků. Měla by dodržovat stejná pravidla jako --index-url
.
Klíč | Ukázková hodnota |
---|---|
PIP_EXTRA_INDEX_URL | http://my.custom.package.repo/simple |
Další informace najdete pip
v dokumentaci k --extra-index-url
vlastním závislostem v referenčních informacích pro vývojáře Pythonu.
PROJECT
Nastavení průběžného nasazování , které službě nasazení Kudu říká, že složka v připojeném úložišti má umístění nasaditelného projektu.
Klíč | Ukázková hodnota |
---|---|
PROJECT | WebProject/WebProject.csproj |
PYTHON_ISOLATE_WORKER_DEPENDENCIES
Konfigurace je specifická pro aplikace funkcí Pythonu. Definuje prioritu pořadí načítání modulu. Ve výchozím nastavení je tato hodnota nastavena na 0
.
Key | Hodnota | Popis |
---|---|---|
PYTHON_ISOLATE_WORKER_DEPENDENCIES | 0 |
Určete prioritu načítání knihoven Pythonu z interních závislostí pracovního procesu Pythonu, což je výchozí chování. Knihovny třetích stran definované v requirements.txt můžou být stínované. |
PYTHON_ISOLATE_WORKER_DEPENDENCIES | 1 |
Určete prioritu načítání knihoven Pythonu z balíčku aplikace definovaného v requirements.txt. Tím zabráníte kolidování knihoven s interními knihovnami pracovního procesu Pythonu. |
PYTHON_ENABLE_DEBUG_LOGGING
Umožňuje protokolování na úrovni ladění v aplikaci funkcí Pythonu. Hodnota 1
povolení protokolování na úrovni ladění. Bez tohoto nastavení nebo s hodnotou 0
, pouze informace a protokoly vyšší úrovně se odesílají z pracovního procesu Pythonu do hostitele Functions. Toto nastavení použijte při ladění nebo trasování spuštění funkcí Pythonu.
Při ladění funkcí Pythonu nezapomeňte podle potřeby také nastavit úroveň protokolování ladění nebo trasování v souboru host.json. Další informace najdete v tématu Konfigurace monitorování pro Azure Functions.
PYTHON_ENABLE_WORKER_EXTENSIONS
Konfigurace je specifická pro aplikace funkcí Pythonu. Nastavením této možnosti 1
umožníte pracovnímu procesu načíst v rozšířeních pracovních procesů Pythonu definovaných v requirements.txt. Aplikace funkcí umožňuje přístup k novým funkcím poskytovaným balíčky třetích stran. Může také změnit chování načtení funkce a vyvolání ve vaší aplikaci. Ujistěte se, že zvolené rozšíření je důvěryhodné, protože nesete riziko jeho používání. Azure Functions neposkytuje žádné výslovné záruky pro žádná rozšíření. Informace o tom, jak použít rozšíření, najdete na stránce s příručkou k rozšíření nebo v dokumentu readme. Ve výchozím nastavení se tato hodnota nastaví na 0
.
Key | Hodnota | Popis |
---|---|---|
PYTHON_ENABLE_WORKER_EXTENSIONS | 0 |
Zakažte jakékoli rozšíření pracovního procesu Pythonu. |
PYTHON_ENABLE_WORKER_EXTENSIONS | 1 |
Povolte pracovnímu procesu Pythonu načtení rozšíření z requirements.txt. |
PYTHON_THREADPOOL_THREAD_COUNT
Určuje maximální počet vláken, která by pracovní proces jazyka Python použil ke spouštění vyvolání funkcí, s výchozí hodnotou 1
pro verzi 3.8
Pythonu a níže. Pro verzi 3.9
Pythonu a vyšší je hodnota nastavená na None
. Toto nastavení nezaručuje počet vláken, která by byla nastavena během provádění. Nastavení umožňuje Pythonu rozšířit počet vláken na zadanou hodnotu. Nastavení platí jenom pro aplikace funkcí Pythonu. Kromě toho nastavení platí pro synchronní vyvolání funkcí, nikoli pro korutiny.
Klíč | Ukázková hodnota | Max. hodnota |
---|---|---|
PYTHON_THREADPOOL_THREAD_COUNT | 2 | 32 |
SCALE_CONTROLLER_LOGGING_ENABLED
Toto nastavení je aktuálně ve verzi Preview.
Toto nastavení řídí protokolování z kontroleru škálování služby Azure Functions. Další informace naleznete v tématu Protokoly kontroleru škálování.
Klíč | Ukázková hodnota |
---|---|
SCALE_CONTROLLER_LOGGING_ENABLED | AppInsights:Verbose |
Hodnota pro tento klíč je zadána ve formátu <DESTINATION>:<VERBOSITY>
, který je definován takto:
Vlastnost | Popis |
---|---|
<DESTINATION> |
Cíl, do kterého se protokoly odesílají. Platné hodnoty jsou AppInsights a Blob .Při použití AppInsights se ujistěte, že je ve vaší aplikaci funkcí povolená služba Application Insights.Když nastavíte cíl na Blob , protokoly se vytvoří v kontejneru objektů blob pojmenovaném azure-functions-scale-controller ve výchozím účtu úložiště nastaveném AzureWebJobsStorage v nastavení aplikace. |
<VERBOSITY> |
Určuje úroveň protokolování. Podporované hodnoty jsou None , Warning a Verbose .Při nastavení Verbose zaznamená kontroler škálování důvod každé změny počtu pracovních procesů a informace o aktivačních událostech, které do těchto rozhodnutí započítávají. Podrobné protokoly zahrnují upozornění triggerů a hodnoty hash používané triggery před a po spuštění kontroleru škálování. |
Tip
Mějte na paměti, že když necháte protokolování kontroleru škálování povolené, ovlivňuje potenciální náklady na monitorování aplikace funkcí. Zvažte povolení protokolování, dokud neshromáždíte dostatek dat, abyste pochopili, jak se řadič škálování chová, a pak ho zakazujte.
SCM_DO_BUILD_DURING_DEPLOYMENT
Řídí chování vzdáleného sestavení během nasazování. Pokud SCM_DO_BUILD_DURING_DEPLOYMENT
je nastavená hodnota true
, projekt se během nasazování sestaví vzdáleně.
Klíč | Ukázková hodnota |
---|---|
SCM_DO_BUILD_DURING_DEPLOYMENT | true |
SCM_LOGSTREAM_TIMEOUT
Řídí časový limit v sekundách při připojení k protokolům streamování. Výchozí hodnota je 7200 (2 hodiny).
Klíč | Ukázková hodnota |
---|---|
SCM_LOGSTREAM_TIMEOUT | 1800 |
Výše uvedená ukázková 1800
hodnota nastaví časový limit 30 minut. Další informace najdete v tématu Povolení protokolů spouštění streamování ve službě Azure Functions.
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING
Připojovací řetězec pro účet úložiště, kde se kód a konfigurace aplikace funkcí ukládají v plánech škálování řízených událostmi. Další informace najdete v tématu Nastavení připojení účtu úložiště.
Klíč | Ukázková hodnota |
---|---|
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING | DefaultEndpointsProtocol=https;AccountName=... |
Toto nastavení se vyžaduje pro aplikace plánu Consumption a Elastic Premium spuštěné v systémech Windows i Linux. Nevyžaduje se pro aplikace vyhrazeného plánu, které nejsou dynamicky škálovány funkcemi.
Změna nebo odebrání tohoto nastavení může způsobit, že se vaše aplikace funkcí nespustí. Další informace najdete v tomto článku o řešení potíží.
Služba Azure Files nepodporuje použití spravované identity při přístupu ke sdílené složce. Další informace najdete ve scénářích ověřování podporovaných službou Azure Files.
WEBSITE_CONTENTOVERVNET
Důležité
WEBSITE_CONTENTOVERVNET je starší nastavení aplikace, které bylo nahrazeno vlastností webu vnetContentShareEnabled .
Hodnota, která 1
vaší aplikaci funkcí umožní škálovat, když máte účet úložiště omezený na virtuální síť. Toto nastavení byste měli povolit při omezení účtu úložiště na virtuální síť. Vyžaduje se pouze při použití WEBSITE_CONTENTSHARE
a WEBSITE_CONTENTAZUREFILECONNECTIONSTRING
. Další informace najdete v tématu Omezení účtu úložiště na virtuální síť.
Klíč | Ukázková hodnota |
---|---|
WEBSITE_CONTENTOVERVNET | 1 |
Toto nastavení aplikace se vyžaduje v plánech Elastic Premium a Dedicated (App Service) (Standard a vyšší). Nepodporuje se při spuštění v plánu Consumption.
Poznámka:
Při směrování do sdílené složky obsahu v účtu úložiště sdíleném více aplikacemi funkcí ve stejném plánu musíte věnovat zvláštní pozornost. Další informace najdete v tématu Konzistentní směrování prostřednictvím virtuálních sítí v článku Důležité informace o úložišti.
WEBSITE_CONTENTSHARE
Název sdílené složky, kterou functions používá k ukládání kódu aplikace funkcí a konfiguračních souborů. Tento obsah vyžadují plány škálování řízené událostmi. Používá se s WEBSITE_CONTENTAZUREFILECONNECTIONSTRING
. Výchozí hodnota je jedinečný řetězec vygenerovaný modulem runtime, který začíná názvem aplikace funkcí. Další informace najdete v tématu Nastavení připojení účtu úložiště.
Klíč | Ukázková hodnota |
---|---|
WEBSITE_CONTENTSHARE | functionapp091999e2 |
Toto nastavení se vyžaduje pro aplikace plánu Consumption a Premium ve Windows i Linuxu. Nevyžaduje se pro aplikace vyhrazeného plánu, které nejsou dynamicky škálovány funkcemi.
Sdílená složka se vytvoří při vytvoření aplikace funkcí. Změna nebo odebrání tohoto nastavení může způsobit, že se vaše aplikace funkcí nespustí. Další informace najdete v tomto článku o řešení potíží.
Při použití šablony Azure Resource Manageru (ARM) nebo souboru Bicep k vytvoření aplikace funkcí během nasazování platí následující aspekty:
- Pokud nenastavíte
WEBSITE_CONTENTSHARE
hodnotu pro hlavní aplikaci funkcí ani žádné aplikace v slotech, vygenerují se pro vás jedinečné hodnoty sdílení.WEBSITE_CONTENTSHARE
Nastavení není doporučeným přístupem pro nasazení šablony ARM. - Existují scénáře, kdy je nutné nastavit
WEBSITE_CONTENTSHARE
hodnotu na předdefinovanou hodnotu, například při použití zabezpečeného účtu úložiště ve virtuální síti. V takovém případě musíte nastavit jedinečný název sdílené složky pro hlavní aplikaci funkcí a aplikaci pro každý slot nasazení. V případě účtu úložiště zabezpečeného virtuální sítí musíte také vytvořit sdílenou složku jako součást automatizovaného nasazení. Další informace naleznete v tématu Zabezpečené nasazení. - Nevytvádejte
WEBSITE_CONTENTSHARE
nastavení slotu. - Při zadání
WEBSITE_CONTENTSHARE
musí hodnota postupovat podle těchto pokynů pro názvy sdílených složek.
WEBSITE_DNS_SERVER
Nastaví server DNS používaný aplikací při překladu IP adres. Toto nastavení se často vyžaduje při používání určitých síťových funkcí, jako jsou privátní zóny Azure DNS a privátní koncové body.
Klíč | Ukázková hodnota |
---|---|
WEBSITE_DNS_SERVER | 168.63.129.16 |
WEBSITE_ENABLE_BROTLI_ENCODING
Určuje, zda je kódování Brotli použito pro kompresi místo výchozí komprese gzip. Pokud WEBSITE_ENABLE_BROTLI_ENCODING
je nastavena hodnota 1
, použije se kódování Brotli; jinak se použije kódování gzip.
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED
Zakáže ukládání do mezipaměti při nasazování aplikací funkcí pomocí šablon Azure Resource Manageru (ARM).
Klíč | Ukázková hodnota |
---|---|
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED | 0 |
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT
Maximální početinstancích Výchozí hodnota není nijak omezena.
Důležité
Toto nastavení je ve verzi Preview. Byla přidána vlastnost aplikace pro maximální kapacitu funkce a doporučuje se omezit horizontální navýšení kapacity.
Klíč | Ukázková hodnota |
---|---|
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT | 5 |
WEBSITE_NODE_DEFAULT_VERSION
Jenom Windows.
Nastaví verzi Node.js, která se použije při spuštění aplikace funkcí ve Windows. Pokud chcete, aby modul runtime používal nejnovější dostupnou verzi cílové hlavní verze, měli byste použít vlnovku (~). Pokud je například nastavená ~18
hodnota , použije se nejnovější verze Node.js 18. Pokud je hlavní verze cílem tilda, nemusíte ručně aktualizovat podverzi.
Klíč | Ukázková hodnota |
---|---|
WEBSITE_NODE_DEFAULT_VERSION | ~18 |
WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS
Při provádění prohození slotů v aplikaci funkcí běžící v plánu Premium může prohození selhat, když je vyhrazený účet úložiště používaný aplikací omezený sítí. Příčinou tohoto selhání je starší funkce protokolování aplikace, která je sdílená službami Functions i App Service. Toto nastavení přepíše tuto funkci protokolování starší verze a umožňuje prohození.
Klíč | Ukázková hodnota |
---|---|
WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS | 0 |
Přidejte WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS
hodnotu 0
do všech slotů, abyste měli jistotu, že starší nastavení diagnostiky nezablokuje vaše prohození. Toto nastavení a hodnotu můžete také přidat jenom do produkčního slotu jako nastavení slotu nasazení (sticky).
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS
Ve výchozím nastavení jsou nastavení verzí pro aplikace funkcí specifické pro každý slot. Toto nastavení se používá při upgradu funkcí pomocí slotů nasazení. To brání neočekávanému chování kvůli změně verzí po prohození. Nastavte v 0
produkčním prostředí a v slotu, abyste měli jistotu, že se prohodí také všechna nastavení verze. Další informace najdete v tématu Upgrade pomocí slotů.
Klíč | Ukázková hodnota |
---|---|
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS | 0 |
WEBSITE_RUN_FROM_PACKAGE
Umožňuje aplikaci funkcí spouštět ze souboru balíčku, který je možné místně připojit nebo nasadit na externí adresu URL.
Klíč | Ukázková hodnota |
---|---|
WEBSITE_RUN_FROM_PACKAGE | 1 |
Platné hodnoty jsou buď adresa URL, která se překládá na umístění souboru externího balíčku pro nasazení, nebo 1
. Při nastavení 1
musí být balíček ve d:\home\data\SitePackages
složce. Když použijete nasazení zip s povoleným nasazením WEBSITE_RUN_FROM_PACKAGE
, balíček se automaticky nahraje do tohoto umístění. Ve verzi Preview bylo toto nastavení pojmenováno WEBSITE_RUN_FROM_ZIP
. Další informace najdete v tématu Spuštění funkcí ze souboru balíčku.
Při nasazování z adresy URL externího balíčku musíte také ručně synchronizovat triggery. Další informace najdete v tématu Aktivace synchronizace.
WEBSITE_SKIP_CONTENTSHARE_VALIDATION
Nastavení WEBSITE_CONTENTAZUREFILECONNECTIONSTRING a WEBSITE_CONTENTSHARE mají další kontroly ověření, aby se zajistilo, že je možné aplikaci správně spustit. Vytvoření nastavení aplikace selže, když aplikace funkcí nemůže správně volat podřízený účet úložiště nebo službu Key Vault kvůli omezením sítě nebo jiným omezujícím faktorům. Pokud je WEBSITE_SKIP_CONTENTSHARE_VALIDATION nastavená na 1
, kontrola ověření se přeskočí. Jinak se hodnota nastaví jako výchozí 0
a ověření proběhne.
Klíč | Ukázková hodnota |
---|---|
WEBSITE_SKIP_CONTENTSHARE_VALIDATION | 1 |
Pokud se ověření přeskočí a připojovací řetězec nebo sdílená složka obsahu není platná, aplikace se nebude moct správně spustit. V tomto případě funkce vrací chyby HTTP 500. Další informace najdete v tématu Řešení chyby: Modul runtime Azure Functions je nedostupný.
WEBSITE_SLOT_NAME
Jen pro čtení. Název aktuálního slotu nasazení Název produkčního slotu je Production
.
Klíč | Ukázková hodnota |
---|---|
WEBSITE_SLOT_NAME | Production |
WEBSITE_TIME_ZONE
Umožňuje nastavit časové pásmo pro vaši aplikaci funkcí.
Klíč | Operační systém | Ukázková hodnota |
---|---|---|
WEBSITE_TIME_ZONE | Windows | Eastern Standard Time |
WEBSITE_TIME_ZONE | Linux | America/New_York |
Výchozím časovým pásmem používaným pro výrazy CRON je koordinovaný univerzální čas (UTC). Pokud chcete, aby byl výraz CRON založený na jiném časovém pásmu, vytvořte nastavení aplikace pro aplikaci funkcí s názvem WEBSITE_TIME_ZONE
.
Hodnota tohoto nastavení závisí na operačním systému a plánu, ve kterém příslušná aplikace funkcí běží.
Operační systém | Plánování | Hodnota |
---|---|---|
Windows | Všechny | Nastavte hodnotu na název požadovaného časového pásma podle druhého řádku z každého páru zadaného příkazem Windows. tzutil.exe /L |
Linux | Premium Vyhrazené |
Nastavte hodnotu na název požadovaného časového pásma, jak je znázorněno v databázi tz. |
Poznámka:
WEBSITE_TIME_ZONE
a TZ
nejsou v současné době podporovány při spuštění v Linuxu v plánu Consumption. V takovém případě můžete nastavit WEBSITE_TIME_ZONE
nebo TZ
vytvořit problémy související s PROTOKOLem SSL a způsobit, že metriky přestanou fungovat pro vaši aplikaci.
Například východní čas v USA (reprezentovaný Eastern Standard Time
(Windows) nebo America/New_York
(Linux)) v současné době používá UTC-05:00 ve standardním čase a UTC-04:00 během letního času. Pokud chcete mít aktivaci časovače každý den v 10:00 východního času, vytvořte nastavení aplikace pro aplikaci funkcí s názvem WEBSITE_TIME_ZONE
, nastavte hodnotu na Eastern Standard Time
(Windows) nebo America/New_York
(Linux) a pak použijte následující výraz NCRONTAB:
"0 0 10 * * *"
Když použijete WEBSITE_TIME_ZONE
čas, upraví se pro změny času v konkrétním časovém pásmu, včetně letního času a změn ve standardním čase.
WEBSITE_USE_PLACEHOLDER
Určuje, jestli se má při spuštění plánu Consumption použít konkrétní optimalizace studeného startu. Nastavte na zakázání 0
optimalizace studeného startu v plánu Consumption.
Klíč | Ukázková hodnota |
---|---|
WEBSITE_USE_PLACEHOLDER | 1 |
WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED
Určuje, jestli se má při spouštění funkcí izolovaného pracovního procesu .NET v plánu Consumption použít konkrétní optimalizace studeného spuštění. Nastavte na zakázání 0
optimalizace studeného startu v plánu Consumption.
Klíč | Ukázková hodnota |
---|---|
WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED | 1 |
WEBSITE_VNET_ROUTE_ALL
Důležité
WEBSITE_VNET_ROUTE_ALL je starší nastavení aplikace, které bylo nahrazeno nastavením webu vnetRouteAllEnabled .
Určuje, jestli se veškerý odchozí provoz z aplikace směruje přes virtuální síť. Hodnota 1
nastavení označuje, že veškerý provoz aplikace je směrován přes virtuální síť. Toto nastavení budete potřebovat při konfiguraci integrace místní virtuální sítě v plánech elastického hostování a vyhrazeného hostování. Používá se také v případech, kdy se k definování statické odchozí IP adresy používá brána NAT virtuální sítě.
Klíč | Ukázková hodnota |
---|---|
WEBSITE_VNET_ROUTE_ALL | 1 |
WEBSITES_ENABLE_APP_SERVICE_STORAGE
Určuje, zda /home
je adresář sdílen napříč škálovanými instancemi s výchozí hodnotou true
. Tuto možnost byste měli nastavit false
při nasazování aplikace funkcí do kontejneru.
Nastavení webu služby App Service
Některé konfigurace se musí udržovat na úrovni služby App Service jako nastavení webu, jako jsou jazykové verze. Tato nastavení se spravují na portálu pomocí rozhraní REST API nebo pomocí Azure CLI nebo Azure PowerShellu. V závislosti na jazyce runtime, operačním systému a verzích můžete vyžadovat následující nastavení webu:
alwaysOn
V aplikaci funkcí spuštěné v plánu Dedicated (App Service) se modul runtime Functions po několika minutách nečinnosti nečiní, což ukazuje pouze požadavky na trigger HTTP, který vaši aplikaci funkcí probudí . Abyste měli jistotu, že vaše funkce aktivované mimo PROTOKOL HTTP správně běží, včetně funkcí triggeru časovače, povolte funkci AlwaysOn pro aplikaci funkcí nastavením alwaysOn
nastavení webu na hodnotu true
.
functionsRuntimeAdminIsolationEnabled
Určuje, jestli je možné získat přístup k integrovaným koncovým bodům správce (/admin
) ve vaší aplikaci funkcí. Když je tato možnost nastavená na false
(výchozí), aplikace povolí požadavky na koncové body v /admin
době, kdy tyto požadavky v požadavku představují hlavní klíč . /admin
Pokud true
není možné získat přístup ke koncovým bodům, a to ani s hlavním klíčem.
Tuto vlastnost nelze nastavit pro aplikace spuštěné na skladové posílce Consumption pro Linux a nejde ji nastavit pro aplikace spuštěné ve verzi 1.x služby Azure Functions. Pokud používáte verzi 1.x, musíte nejprve migrovat na verzi 4.x.
linuxFxVersion
U aplikací funkcí spuštěných v Linuxu linuxFxVersion
označuje jazyk a verzi pracovního procesu specifického pro daný jazyk. Tyto informace se používají společně s informacemi FUNCTIONS_EXTENSION_VERSION
o tom, které konkrétní image kontejneru Linuxu se nainstalují ke spuštění vaší aplikace funkcí. Toto nastavení lze nastavit na předdefinovanou hodnotu nebo vlastní identifikátor URI image.
Tato hodnota je pro vás nastavená při vytváření aplikace funkcí pro Linux. Možná ho budete muset nastavit pro nasazení ARM a nasazení Bicep a v určitých scénářích upgradu.
Platné hodnoty linuxFxVersion
K zobrazení tabulky aktuálních linuxFxVersion
hodnot podle podporované verze modulu runtime Functions můžete použít následující příkaz Azure CLI:
az functionapp list-runtimes --os linux --query "[].{stack:join(' ', [runtime, version]), LinuxFxVersion:linux_fx_version, SupportedFunctionsVersions:to_string(supported_functions_versions[])}" --output table
Předchozí příkaz vyžaduje upgrade na verzi 2.40 Azure CLI.
Vlastní image
Při vytváření a údržbě vlastního kontejneru linuxu pro vaši aplikaci linuxFxVersion
funkcí je hodnota místo toho ve formátu DOCKER|<IMAGE_URI>
, jak je znázorněno v následujícím příkladu:
linuxFxVersion = "DOCKER|contoso.com/azurefunctionsimage:v1.0.0"
Označuje zdroj registru nasazeného kontejneru. Další informace najdete v tématu Práce s kontejnery a Azure Functions.
Důležité
Při vytváření vlastních kontejnerů musíte zachovat základní image kontejneru aktualizovanou na nejnovější podporovanou základní image. Podporované základní image pro Azure Functions jsou specifické pro jazyk a nacházejí se v základních imagích Azure Functions.
Tým Functions se zavazuje publikovat měsíční aktualizace těchto základních imagí. Mezi běžné aktualizace patří nejnovější aktualizace podverze a opravy zabezpečení pro modul runtime i jazyky Functions. Kontejner byste měli pravidelně aktualizovat z nejnovější základní image a znovu nasadit aktualizovanou verzi kontejneru.
netFrameworkVersion
Nastaví konkrétní verzi rozhraní .NET pro funkce jazyka C#. Další informace najdete v tématu Aktualizace aplikace funkcí v Azure.
PowerShellVersion
Nastaví konkrétní verzi PowerShellu, na které vaše funkce běží. Další informace najdete v tématu Změna verze PowerShellu.
Při místním spuštění místo toho použijete FUNCTIONS_WORKER_RUNTIME_VERSION
nastavení v souboru local.settings.json.
vnetContentShareEnabled
Aplikace spuštěné v plánu Premium používají sdílenou složku k ukládání obsahu. Název této sdílené složky obsahu je uložen v WEBSITE_CONTENTSHARE
nastavení aplikace a jeho připojovací řetězec je uložen v WEBSITE_CONTENTAZUREFILECONNECTIONSTRING
. Pokud chcete směrovat provoz mezi vaší aplikací funkcí a sdílením obsahu přes virtuální síť, musíte také nastavit vnetContentShareEnabled
.true
Povolení této vlastnosti webu je požadavkem při omezení účtu úložiště na virtuální síť v plánech elastického a vyhrazeného hostování.
Poznámka:
Při směrování do sdílené složky obsahu v účtu úložiště sdíleném více aplikacemi funkcí ve stejném plánu musíte věnovat zvláštní pozornost. Další informace najdete v tématu Konzistentní směrování prostřednictvím virtuálních sítí v článku Důležité informace o úložišti.
Tato vlastnost webu nahrazuje starší WEBSITE_CONTENTOVERVNET
nastavení.
vnetImagePullEnabled
Functions podporuje aplikace funkcí spuštěné v kontejnerech Linuxu. Pokud se chcete připojit a načíst z registru kontejneru uvnitř virtuální sítě, musíte nastavit vnetImagePullEnabled
hodnotu true
. Tato vlastnost webu je podporována v plánech Elastic Premium a Dedicated hosting. Plán Flex Consumption se při konfiguraci sítí nespoléhá na vlastnosti webu ani nastavení aplikace. Další informace najdete v tématu Vyřazení plánu Flex Consumption.
vnetRouteAllEnabled
Určuje, jestli se veškerý odchozí provoz z aplikace směruje přes virtuální síť. Hodnota true
nastavení označuje, že veškerý provoz aplikace je směrován přes virtuální síť. Toto nastavení použijte při konfiguraci integrace místní virtuální sítě v plánech Elastic Premium a Dedicated. Používá se také v případech, kdy se k definování statické odchozí IP adresy používá brána NAT virtuální sítě. Další informace naleznete v tématu Konfigurace směrování aplikace.
Toto nastavení webu nahrazuje starší nastavení WEBSITE_VNET_ROUTE_ALL .
Vyřazení plánu Flex Consumption
V plánu Flex Consumption jsou tyto vlastnosti webu a nastavení aplikace zastaralé a neměly by se používat při vytváření prostředků aplikace funkcí:
Nastavení/vlastnost | Důvod |
---|---|
ENABLE_ORYX_BUILD |
Nahrazení parametrem remoteBuild při nasazování ve flex Consumption |
FUNCTIONS_EXTENSION_VERSION |
Nastavení aplikace je nastaveno back-endem. Hodnotu ~1 je možné ignorovat. |
FUNCTIONS_WORKER_RUNTIME |
Nahrazeno v name properties.functionAppConfig.runtime |
FUNCTIONS_WORKER_RUNTIME_VERSION |
Nahrazeno v version properties.functionAppConfig.runtime |
FUNCTIONS_MAX_HTTP_CONCURRENCY |
Nahrazeno oddílem triggeru škálování a souběžnosti |
FUNCTIONS_WORKER_PROCESS_COUNT |
Nastavení není platné. |
FUNCTIONS_WORKER_DYNAMIC_CONCURRENCY_ENABLED |
Nastavení není platné. |
SCM_DO_BUILD_DURING_DEPLOYMENT |
Nahrazení parametrem remoteBuild při nasazování ve flex Consumption |
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING |
Nahrazeno částí nasazení functionAppConfig |
WEBSITE_CONTENTOVERVNET |
Nepoužívá se pro sítě ve službě Flex Consumption |
WEBSITE_CONTENTSHARE |
Nahrazeno částí nasazení functionAppConfig |
WEBSITE_DNS_SERVER |
DNS se dědí z integrované virtuální sítě ve funkci Flex. |
WEBSITE_NODE_DEFAULT_VERSION |
Nahrazeno v version properties.functionAppConfig.runtime |
WEBSITE_RUN_FROM_PACKAGE |
Nepoužívá se pro nasazení ve službě Flex Consumption |
WEBSITE_SKIP_CONTENTSHARE_VALIDATION |
Sdílená složka obsahu se nepoužívá ve službě Flex Consumption. |
WEBSITE_VNET_ROUTE_ALL |
Nepoužívá se pro sítě ve službě Flex Consumption |
properties.alwaysOn |
Neplatné |
properties.containerSize |
Přejmenováno jako instanceMemoryMB |
properties.ftpsState |
Protokol FTPS není podporován. |
properties.isReserved |
Neplatné |
properties.IsXenon |
Neplatné |
properties.javaVersion |
Nahrazeno v version properties.functionAppConfig.runtime |
properties.LinuxFxVersion |
Nahrazuje properties.functionAppConfig.runtime |
properties.netFrameworkVersion |
Nahrazeno v version properties.functionAppConfig.runtime |
properties.powerShellVersion |
Nahrazeno v version properties.functionAppConfig.runtime |
properties.siteConfig.functionAppScaleLimit |
Přejmenováno jako maximumInstanceCount |
properties.siteConfig.preWarmedInstanceCount |
Přejmenováno jako alwaysReadyInstances |
properties.use32BitWorkerProcess |
32bitový nepodporovaný |
properties.vnetBackupRestoreEnabled |
Nepoužívá se pro sítě ve službě Flex Consumption |
properties.vnetContentShareEnabled |
Nepoužívá se pro sítě ve službě Flex Consumption |
properties.vnetImagePullEnabled |
Nepoužívá se pro sítě ve službě Flex Consumption |
properties.vnetRouteAllEnabled |
Nepoužívá se pro sítě ve službě Flex Consumption |
properties.windowsFxVersion |
Neplatné |
Další kroky
Zjistěte, jak aktualizovat nastavení aplikace.
Zobrazení nastavení konfigurace v souboru host.json
Zobrazení dalších nastavení aplikací pro aplikace App Service