Referenční informace o nastavení aplikace 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 connection string hodnoty zkráceny pro čitelnost.

Azure Functions k hostování používá platformu Azure App Service. Některá nastavení relevantní pro hostování aplikace funkcí můžete najít v Nastavení proměnných a nastavení aplikace v Azure App 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ěna nastavení aplikace způsobí, že se vaše funkční aplikace ve výchozím nastavení restartuje napříč všemi plány hostování. Pro nasazení s nulovým výpadkem při změně nastavení použijte plán Flex Consumption s kumulativními aktualizacemi jako strategii aktualizace lokality. Další plány hostování najdete v tématu Optimalizace nasazení s pokyny k minimalizaci výpadků .
Dvojité podtržítko (__) a dvojtečka (:) se považují za rezervované hodnoty v názvech nastavení. Dvojitá podtržítka se interpretují jako hierarchické oddělovače v Windows i v Linuxu. Dvojtečky se interpretují stejným způsobem pouze na Windows. 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.
Při místním spuštění funkcí se nastavení aplikace zadává v Values kolekci v local.settings.json.
V souboru host.json a v souboru local.settings.json existují další možnosti app configuration funkce.
Nastavení aplikace můžete použít k přepsání hodnot nastavení host.json bez nutnosti měnit host.json samotný soubor. Tento přístup 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í. Tento přístup také umožňuje změnit nastavení host.json, aniž byste museli project znovu publikovat. Další informace najdete v referenčním článku host.json.
Tento článek popisuje nastavení, která jsou pro vaše funkční aplikace nejrelevantnější. Vzhledem k tomu, že Azure Functions běží na App Service, podporují se také další nastavení aplikace. Další informace najdete v tématu Nastavení proměnných a nastavení aplikace v Azure App Service.
Některé scénáře také vyžadují práci s nastavením zdokumentovanými v nastavení webu App Service.
Změna nastavení aplikace jen pro čteníApp Service nastavení aplikace může aplikaci funkcí převést 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 pro programovou práci s nastavením aplikace. Další informace najdete v tématu Work with application settings.

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 Pokud konfigurace monitorování pro Azure Functions.

Key	Ukázková hodnota
APPINSIGHTS_INSTRUMENTATIONKEY	`55555555-af77-484b-9032-64f83bb83bb`

Nepoužívejte obojí APPINSIGHTS_INSTRUMENTATIONKEY ani APPLICATIONINSIGHTS_CONNECTION_STRING. Doporučujeme používat APPLICATIONINSIGHTS_CONNECTION_STRING.

APPLICATIONINSIGHTS_AUTHENTICATION_STRING

Umožňuje access do 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 najdete v tématu Ověřování Entra microsoftu pro Application Insights.

Při použití APPLICATIONINSIGHTS_AUTHENTICATION_STRINGzávisí konkrétní hodnota, kterou nastavíte, na typu spravované identity:

Spravovaná identita	Nastavení hodnoty
System-assigned	`Authorization=AAD`
User-assigned	`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í ekvivalentní Monitoring Metrics Publisher.

Note

Při použití APPLICATIONINSIGHTS_AUTHENTICATION_STRING pro připojení k Application Insights pomocí ověřování Microsoft Entra byste také měli Potřebitelné místní ověřování pro Application Insights. Tato konfigurace vyžaduje Microsoft Entra ověřování, aby se telemetrie mohla ingestovat do vašeho pracovního prostoru.

APPLICATIONINSIGHTS_CONNECTION_STRING

Connection string pro Application Insights. Nepoužívejte obojí APPINSIGHTS_INSTRUMENTATIONKEY ani APPLICATIONINSIGHTS_CONNECTION_STRING. Doporučujeme používat APPLICATIONINSIGHTS_CONNECTION_STRING ve všech případech. Je to požadavek v následujících případech:

Když vaše aplikace funkcí vyžaduje přidání vlastních nastavení podporovaných pomocí connection string
Když vaše instance Application Insights běží v suverénním cloudu, který vyžaduje vlastní koncový bod

Další informace najdete v tématu Připojení řetězců.

Key	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

Important

Azure Functions proxy servery byly funkcí versions 1.x až 3.x modulu runtime Azure Functions. Další informace naleznete v tématu funkce proxy.

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES

Important

Azure Functions proxy servery byly funkcí versions 1.x až 3.x modulu runtime Azure Functions. Další informace naleznete v tématu funkce proxy.

AZURE_FUNCTIONS_ENVIRONMENT

Nakonfiguruje prostředí runtime hosting aplikace funkcí při spuštění v Azure. Tato hodnota se čte během inicializace. Modul runtime přijímá pouze tyto hodnoty:

Value	Description
`Production`	Představuje produkční prostředí se sníženou úrovní protokolování a úplnou optimalizací výkonu. Tato hodnota je výchozí, pokud `AZURE_FUNCTIONS_ENVIRONMENT` není nastavená nebo je nastavená na nepodporovanou hodnotu.
`Staging`	Představuje přípravné prostředí, například při spuštění v přípravném slotu.
`Development`	Vývojové prostředí podporuje podrobnější protokolování a další optimalizace s nižším výkonem. Nástroje Azure Functions Core Tools při spuštění na místním počítači nastaví `AZURE_FUNCTIONS_ENVIRONMENT` na `Development`. Toto nastavení nelze přepsat v souboru local.settings.json.

Toto nastavení použijte místo ASPNETCORE_ENVIRONMENT, když potřebujete změnit prostředí runtime v Azure na něco jiného než Production. Další informace naleznete v tématu třída a metody spuštění založené na prostředí.

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 prostředí Functions mohou nastavení aplikace přepsat nastavení v souboru host.json v aktuálním prostředí. Tato přetížení jsou vyjádřena jako nastavení aplikace nazvaná AzureFunctionsJobHost__path__to__setting. Další informace najdete v tématu Předefinování hodnot host.json.

AzureFunctionsWebHost__hostid

Nastaví ID hostitele pro konkrétní aplikaci funkcí, které by mělo být jedinečné. 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 storage.

ID hostitele musí splňovat následující požadavky:

Musí být mezi 1 a 32 znaky.
Obsahují jenom malá písmena, číslice a pomlčky.
Nesmí začínat ani končit pomlčkou
Nesmí obsahovat 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.

Key	Ukázková hodnota
AzureFunctionsWebHost__hostid	`myuniquefunctionappname123456789`

Další informace najdete v tématu Aspekty ID hostitele.

AzureWebJobsDashboard

Stava Je zastaralá a podporuje se pouze při spuštění na verzi 1.x modulu runtime.

Volitelný storage účet connection string pro ukládání protokolů a jejich zobrazení na kartě Monitor v Azure portal. Účet storage musí být účet pro obecné účely, který podporuje objekty blob, fronty a tabulky. Další informace najdete v tématu Storage požadavky na účet.

Key	Ukázková hodnota
AzureWebJobsDashboard	`DefaultEndpointsProtocol=https;AccountName=...`

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.

Key	Ukázková hodnota
AzureWebJobsDisableHomepage	`true`

Pokud toto nastavení aplikace vynecháte nebo nastavíte na false, zobrazí se stránka podobná následujícímu příkladu v odpovědi na adresu URL <functionappname>.azurewebsites.net.

Snímek obrazovky znázorňující cílovou stránku aplikace funkcí

AzureWebJobsDotNetReleaseCompilation

true znamená použití režimu Release při kompilaci kódu .NET. false znamená použít režim ladění. Výchozí hodnota je true.

Key	Ukázková hodnota
AzureWebJobsDotNetReleaseCompilation	`true`

AzureWebJobsFeatureFlags

Seznam beta funkcí oddělených čárkami, které chcete povolit. Beta funkce povolené těmito přepínači nejsou připravené pro produkční prostředí, ale lze je povolit pro experimentální použití před zahájením jejich provozu.

Key	Ukázková hodnota
AzureWebJobsFeatureFlags	`feature1,feature2,EnableProxies`

Pokud má vaše aplikace aktuálně toto nastavení, přidejte na konec seznamu odděleného čárkami nové příznaky.

Aktuálně podporované přepínače funkcí:

Hodnota příznaku	Description
`EnableProxies`	Opětovné povolení proxy serverů ve verzi 4.x modulu runtime Functions při plánování migrace na Azure API Management. Další informace najdete v tématu Opětovné povolení proxy serverů ve službě Functions v4.x.
`EnableAzureMonitorTimeIsoFormat`	Povolí formát času `ISO 8601` v protokolech Azure Monitorování pro linuxové aplikace spuštěné v plánu Dedicated (App Service).

AzureWebJobsKubernetesSecretName

Označuje prostředek Kubernetes Secrets použitý pro ukládání klíčů. Podporováno pouze při spuštění v Kubernetes.

Key	Ukázková hodnota
AzureWebJobsKubernetesSecretName	`<SECRETS_RESOURCE>`

Úvahy při používání prostředku Kubernetes Secret:

Musíte také nastavit AzureWebJobsSecretStorageType na 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 automaticky vygenerují hodnoty při nasazování do Kubernetes.
Neměnné tajné kódy nejsou podporované a jejich použití vede k chybám za běhu.

Další informace najdete v tématu Spravovací klíč storage.

AzureWebJobsSecretStorageKeyVaultClientId

ID klienta spravované identity přiřazené uživatelem nebo registrace aplikace použité k access 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.

Key	Ukázková hodnota
AzureWebJobsSecretStorageKeyVaultClientId	`<CLIENT_ID>`

Další informace najdete v tématu Spravovací klíč storage.

AzureWebJobsSecretStorageKeyVaultClientSecret

Tajný klíč pro ID klienta spravované identity přiřazené uživatelem nebo registraci aplikace použité k access 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.

Key	Ukázková hodnota
AzureWebJobsSecretStorageKeyVaultClientSecret	`<CLIENT_SECRET>`

Další informace najdete v tématu Spravovací klíč storage.

AzureWebJobsSecretStorageKeyVaultName

nastavení This je zastaralé a používalo se pouze při spuštění na verzi 3.x modulu runtime.

Název instance key vault 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.

Při místním spuštění funkcí se použije identita vývojáře. Nastavení musí být v souborulocal.settings.json.

Key	Ukázková hodnota
AzureWebJobsSecretStorageKeyVaultName	`<VAULT_NAME>`

Další informace najdete v tématu Spravovací klíč storage.

AzureWebJobsSecretStorageKeyVaultTenantId

ID tenanta registrace aplikace použité k access 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 Spravovací klíč storage.

Key	Ukázková hodnota
AzureWebJobsSecretStorageKeyVaultTenantId	`<TENANT_ID>`

AzureWebJobsSecretStorageKeyVaultUri

Identifikátor URI instance key vault sloužící k ukládání klíčů. Podporováno ve verzi 4.x a novějších verzích modulu runtime Functions. Toto nastavení doporučujeme pro použití instance key vault pro klíč storage. Toto nastavení vyžaduje, abyste nastavili AzureWebJobsSecretStorageType hodnotu keyvault.

Hodnota AzureWebJobsSecretStorageKeyVaultUri by měla být úplná hodnota identifikátoru URI Vault URI zobrazená na kartě Key Vault, včetně https://.

Trezor musí mít zásadu access odpovídající spravované identitě přiřazené systémem hostitelského prostředku. Zásady access by měly identitě udělit následující oprávnění tajných kódů: 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.

Key	Ukázková hodnota
AzureWebJobsSecretStorageKeyVaultUri	`https://<VAULT_NAME>.vault.azure.net`

Important

Tajnosti nejsou omezeny na jednotlivé funkční aplikace prostřednictvím nastavení AzureWebJobsSecretStorageKeyVaultUri. Pokud je několik aplikací funkcí nakonfigurovaných tak, aby používalo stejnou Key Vault sdílejí stejné tajné kódy, což může vést ke kolizím klíčů nebo přepsání. Pokud se chcete vyhnout neúmyslnému chování, doporučujeme pro každou aplikaci funkcí použít samostatnou instanci Key Vault.

Další informace najdete v tématu Manage Key Storage.

AzureWebJobsSecretStorageSas

Adresa URL SAS Blob Storage pro druhý účet storage použitý pro storage klíče. Funkce ve výchozím nastavení používá účet nastavený v AzureWebJobsStorage. Pokud používáte tuto možnost storage tajných kódů, ujistěte se, že AzureWebJobsSecretStorageType není explicitně nastavená nebo je nastavená na blob. Další informace najdete v tématu Spravovací klíč storage.

Key	Ukázková hodnota
AzureWebJobsSecretStorageSas	`<BLOB_SAS_URL>`

AzureWebJobsSecretStorageType

Určuje úložiště nebo zprostředkovatele, které se má použít pro klíč storage. Klíče se always encrypted před uložením pomocí tajného klíče jedinečného pro vaši aplikaci funkcí.

Key	Value	Description
AzureWebJobsSecretStorageType	`blob`	Klíče se ukládají do kontejneru Blob storage v účtu poskytnutém nastavením `AzureWebJobsStorage`. Blob storage je výchozím chováním, pokud není nastavena hodnota `AzureWebJobsSecretStorageType`. Pokud chcete zadat jiný účet storage, použijte nastavení `AzureWebJobsSecretStorageSas` k označení adresy URL SAS druhého účtu storage.
AzureWebJobsSecretStorageType	`files`	Klíče jsou trvalé v systému souborů. Toto chování je výchozí pro functions v1.x.
AzureWebJobsSecretStorageType	`keyvault`	Klíče se ukládají do instance key vault nastavené 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 automaticky vygenerují hodnoty při nasazování do Kubernetes.

Další informace najdete v tématu Spravovací klíč storage.

AzureWebJobsStorage

Určuje connection string pro účet Azure Storage, který modul runtime Functions používá pro normální operace. Mezi použití tohoto účtu storage službou Functions patří správa klíčů, správa triggerů časovače a kontrolní body služby Event Hubs. Účet storage musí být účet pro obecné účely, který podporuje objekty blob, fronty a tabulky. Další informace najdete v tématu Storage požadavky na účet.

Key	Ukázková hodnota
AzureWebJobsStorage	`DefaultEndpointsProtocol=https;AccountName=...`

Místo connection string můžete pro tento účet storage použít připojení založené na identitě. Další informace najdete v tématu Pojení k hostování storage s identitou.

AzureWebJobsStorage__accountName

Při použití připojení storage založeného na identitě nastaví název účtu storage místo použití connection string v AzureWebJobsStorage. Tato syntaxe je jedinečná pro AzureWebJobsStorage a nelze ji použít pro jiná připojení založená na identitách.

Key	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í založeného na identitě storage nastaví identifikátor URI roviny dat služby blob služby storage účtu.

Key	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 tématu Pojení k hostování storage s identitou.

AzureWebJobsStorage__clientId

Nastaví ID klienta konkrétní identity přiřazené uživatelem sloužící k získání tokenu access pro ověřování spravované identity. Vyžaduje, aby AzureWebJobsStorage__credential bylo nastaveno na managedidentity. Hodnota je ID klienta, které odpovídá identitě přiřazené k aplikaci. Nemůžete nastavit obojí AzureWebJobsStorage__managedIdentityResourceId ani AzureWebJobsStorage__clientId. Pokud není nastavená, použije se identita přiřazená systémem.

AzureWebJobsStorage__credential

Definuje způsob získání tokenu access pro připojení. Používá se managedidentity pro ověřování spravovaných identit. Při použití managedidentitymusí být spravovaná identita dostupná v hostitelském prostředí. Nenastavujte AzureWebJobsStorage__credential v místních scénářích vývoje.

AzureWebJobsStorage__managedIdentityResourceId

Nastaví identifikátor prostředku identity přiřazené uživatelem sloužící k získání tokenu access pro ověřování spravované identity. Vyžaduje, aby AzureWebJobsStorage__credential bylo nastaveno na managedidentity. Hodnota je ID prostředku identity přiřazené k aplikaci používané pro ověřování spravovaných identit. Nemůžete nastavit obojí AzureWebJobsStorage__managedIdentityResourceId ani AzureWebJobsStorage__clientId. Pokud není nastavená, použije se identita přiřazená systémem.

AzureWebJobsStorage__queueServiceUri

Při použití připojení založeného na identitě storage nastaví identifikátor URI roviny dat služby fronty účtu storage.

Key	Ukázková hodnota
AzureWebJobsStorage__queueServiceUri	`https://<STORAGE_ACCOUNT_NAME>.queue.core.windows.net`

AzureWebJobsStorage__tableServiceUri

Při použití storage připojení založeného na identitě nastaví identifikátor URI roviny dat služby storage účtu tabulky.

Key	Ukázková hodnota
AzureWebJobsStorage__tableServiceUri	`https://<STORAGE_ACCOUNT_NAME>.table.core.windows.net`

AzureWebJobs_TypeScriptPath

Cesta ke kompilátoru použitému pro TypeScript Umožňuje přepsat výchozí nastavení, pokud potřebujete.

Key	Ukázková hodnota
AzureWebJobs_TypeScriptPath	`%HOME%\typescript`

DOCKER_REGISTRY_SERVER_PASSWORD

Označuje heslo použité k access 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 Nastavení proměnných a nastavení aplikace v Azure App 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 Nastavení proměnných a nastavení aplikace v Azure App Service.

DOCKER_REGISTRY_SERVER_USERNAME

Označuje účet použitý k access 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 Nastavení proměnných a nastavení aplikace v Azure App Service.

DOCKER_SHM_SIZE

Nastaví velikost sdílené paměti (v bajtech), když pracovní proces Python používá sdílenou paměť. Další informace najdete v tématu Sdílené paměti.

Key	Ukázková hodnota
DOCKER_SHM_SIZE	`268435456`

Předchozí hodnota nastaví velikost sdílené paměti ~256 MB.

Vyžaduje, aby FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED byla nastavena na 1.

ENABLE_ORYX_BUILD

Určuje, jestli se během nasazování používá systém sestavení Oryx. ENABLE_ORYX_BUILD musí být nastaveno na true při nasazení vzdáleného sestavení do Linuxu. Další informace naleznete v tématu Vzdálené sestavení.

Key	Ukázková hodnota
ENABLE_ORYX_BUILD	`true`

FUNCTION_APP_EDIT_MODE

Určuje, jestli můžete aplikaci funkcí upravit v Azure portal. Platné hodnoty jsou readwrite a readonly.

Key	Ukázková hodnota
FUNCTION_APP_EDIT_MODE	`readonly`

Modul runtime nastaví hodnotu na základě zásobníku jazyka a stavu nasazení vaší aplikace funkcí. Další informace najdete v tématu Vývojová omezení v Azure portal.

FUNCTIONS_EXTENSION_VERSION

Verze modulu runtime Functions, která hostuje vaši funkční aplikaci. Tilda (~) s hlavní verzí znamená, že používá nejnovější verzi této hlavní verze, ~4například . Pokud jsou k dispozici nové podverze stejné hlavní verze, automaticky se nainstalují do aplikace funkcí.

Key	Ukázková hodnota
FUNCTIONS_EXTENSION_VERSION	`~4`

Podporují se následující hlavní hodnoty verze modulu runtime:

Value	Cíl běhového prostředí	Comment
`~4`	4.x	Recommended
`~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řipne vaši aplikaci na verzi 1.x běhového prostředí. Verze modulu runtime 2.x a 3.x se už nepodporují. Další informace najdete v tématu Azure Functions přehled verzí modulu runtime.

Pokud vás podpora požádá, abyste aplikaci připnuli ke konkrétní menší verzi, použijte celé číslo verze, například 4.0.12345. Další informace najdete v tématu Jak cílit na Azure Functions verze modulu runtime.

FUNCTIONS_INPROC_NET8_ENABLED

Určuje, jestli aplikace může používat .NET 8 v modelu procesu. Pokud chcete v modelu v procesu použít .NET 8, musí být tato hodnota nastavená na 1. Úplné pokyny, včetně dalších požadovaných hodnot konfigurace, najdete v tématu >Upddating to target .NET 8.

Key	Ukázková hodnota
FUNCTIONS_INPROC_NET8_ENABLED	`1`

Nastavte na 0 zakázat podporu .NET 8 v modelu v 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ě doporučujeme 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 na vstupním bodu a nezaznamenává je v 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 je chyba vyvolána předtím, výchozí chování odpovídá false. Pokud například používáte model v3 nebo soubor vstupního bodu neexistuje.
Pokud je chyba vyvolána poté, výchozí chování odpovídá true. Pokud se například pokusíte zaregistrovat duplicitní funkce modelu v4.

Key	Value	Description
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 104 857 600 bajtů.

Key	Ukázková hodnota
FUNCTIONS_REQUEST_BODY_SIZE_LIMIT	`250000000`

FUNCTIONS_V2_COMPATIBILITY_MODE

Important

Toto nastavení se už nepodporuje. Původně byla poskytována pro umožnění krátkodobého alternativního řešení pro aplikace, které cílí na běhové prostředí v2.x. Místo toho by mohli běžet v modulu runtime v3.x, i když byl stále podporovaný. 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 tématu Azure Functions přehled verzí modulu runtime.

FUNCTIONS_WORKER_PROCESS_COUNT

Určuje maximální počet jazykových pracovních procesů s výchozí hodnotou 1. Maximální povolená hodnota je 10. Volání funkcí se rovnoměrně rozdělují mezi procesy jazykových pracovníků. Procesy jazykového pracovního se vytvoří každých 10 sekund, dokud není dosažen počet určený 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 .NET spuštěných v procesu (FUNCTIONS_WORKER_RUNTIME=dotnet).

Key	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í. Tato hodnota odpovídá jazyku používanému v aplikaci, pythonnapříklad . Počínaje verzí 2.x modulu runtime Azure Functions může daná aplikace funkcí podporovat pouze jeden jazyk.

Key	Ukázková hodnota
FUNCTIONS_WORKER_RUNTIME	`node`

Platné hodnoty:

Value	Jazykový zásobník
`dotnet`	C# (knihovna tříd) C# (skript)
`dotnet-isolated`	C# (izolovaný pracovní proces)
`java`	Java
`node`	JavaScript TypeScript
`powershell`	PowerShell
`python`	Python
`custom`	Ostatní

FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED

Toto nastavení umožňuje pracovnímu procesu Python použít sdílenou paměť ke zlepšení propustnosti. Povolte sdílenou paměť, když Python aplikace funkcí dosáhne kritických bodů paměti.

Key	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ěti.

JAVA_APPLICATIONINSIGHTS_ENABLE_TELEMETRY

Určuje, jestli má pracovní proces Java výstupem telemetrie ve formátu Open Telemetry do koncového bodu Application Insights. Nastavením tohoto příznaku na True sdělí hostiteli functions, aby Java pracovní proces streamovat protokoly OpenTelemetry přímo, což brání duplicitním položkám na úrovni hostitele. Další informace naleznete v tématu Konfigurace nastavení aplikace.

JAVA_ENABLE_SDK_TYPES

Umožňuje aplikaci funkcí používat nativní typy Azure SDK ve vazbách.

Note

Podpora vazby na typy sad SDK je aktuálně ve verzi Preview a je omezená na Azure Blob Storage SDK. Další informace najdete v tématu Typy sad SDK v referenčním článku jazyka Java.

Key	Ukázková hodnota
JAVA_ENABLE_SDK_TYPES	`true`

Další informace najdete v tématu Typy sad SDK v referenčním článku jazyka Java.

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 spotřeby místo toho použijte languageWorkers__java__arguments. Další informace naleznete v tématu Přizpůsobení prostředí JVM.

languageWorkersjavaarguments

Používá se k přizpůsobení virtuálního počítače Java (JVM), který se používá ke spuštění vašich funkcí Java v rámci Consumption plánu. Toto nastavení zvyšuje dobu studeného spuštění Java funkcí 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 PowerShell Gallery při spuštění procesu a každé MDMaxBackgroundUpgradePeriod po spuštění. Pokud je v PowerShell Gallery 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, včetně vstupně-výstupních operací sítě, procesoru a storage. 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.

Key	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 jsou nainstalované 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 provádění aktuální 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í proces PowerShell zkontroluje, zda jsou upgrady spravovaných závislostí nainstalovány. 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.

Key	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ě).

Aby se zabránilo nadměrným upgradům modulů při častých restartech Worker, kontrola upgradů modulů se neprovádí, pokud již některý Worker tuto kontrolu zahájil v posledním MDMinBackgroundUpgradePeriod.

Key	Ukázková hodnota
MDMinBackgroundUpgradePeriod	`1.00:00:00`

Další informace najdete v tématu Správa závislostí.

OTEL_EXPORTER_OTLP_ENDPOINT

Určuje adresu URL, do které se exportují data ve formátu OpenTelemetry pro příjem dat. Další informace najdete v tématu Use OpenTelemetry with Azure Functions.

OTEL_EXPORTER_OTLP_HEADERS

Nastaví volitelný seznam hlaviček, které se použijí pro všechna odchozí data exportovaná do koncového bodu OpenTelemetry. Toto nastavení byste měli použít, když koncový bod OpenTelemetry vyžaduje zadání klíče rozhraní API. Další informace najdete v tématu Use OpenTelemetry with Azure Functions.

PIP_INDEX_URL

Přepíše výchozí základní adresu URL indexu balíčků Pythonu (https://pypi.org/simple) při spuštění vzdáleného sestavení. Vzhledem k tomu, že toto nastavení nahrazuje index balíčku, může se při obnovení zobrazit neočekávané chování. Toto nastavení použijte jenom v případě, že potřebujete použít úplnou sadu vlastních závislostí. Pokud je to možné, měli byste místo toho použít PIP_EXTRA_URL, což vám umožní odkazovat na další index balíčku. Další informace najdete v tématu Vlastní závislosti v článku o sestavení Pythonu.

Key	Ukázková hodnota
PIP_INDEX_URL	`http://my.custom.package.repo/simple`

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. Další informace naleznete v pip dokumentaci pro --index-url.

PIP_EXTRA_INDEX_URL

Hodnota pro toto nastavení označuje extra adresu URL indexu pro vlastní balíčky pro aplikace v Pythonu, která se má použít kromě adresy --index-url. Toto nastavení použijte, když potřebujete spustit vzdálené sestavení pomocí vlastních závislostí nalezených v extra indexu balíčků. Další informace najdete v tématu Vlastní závislosti v článku o sestavení Pythonu.

Key	Ukázková hodnota
PIP_EXTRA_INDEX_URL	`http://my.custom.package.repo/simple`

Měla by dodržovat stejná pravidla jako --index-url. Další informace naleznete v pip dokumentaci pro --extra-index-url.

PROJECT

Nastavení postupné nasazení které službě nasazení Kudu řekne, že složka v připojeném úložišti má umístění nasaditelného project.

Key	Ukázková hodnota
PROJECT	`WebProject/WebProject.csproj`

PYTHON_APPLICATIONINSIGHTS_ENABLE_TELEMETRY

Určuje, jestli má pracovní proces Python výstupem telemetrie ve formátu Open Telemetry do koncového bodu Application Insights. Nastavením tohoto příznaku na True hostiteli Functions sdělí, že má Python pracovní proces exportovat data OpenTelemetry do koncového bodu Koncový bodApplication Insights. Další informace naleznete v tématu Konfigurace nastavení aplikace.

PYTHON_ISOLATE_WORKER_DEPENDENCIES

Konfigurace je specifická pro Python aplikace funkcí. Definuje prioritu pořadí načítání modulu. Ve výchozím nastavení je tato hodnota nastavena na 0.

Key	Value	Description
PYTHON_ISOLATE_WORKER_DEPENDENCIES	`0`	Určete prioritu načítání knihoven Python z interních závislostí pracovního procesu Python, což je výchozí chování. Knihovny, které nejsou definované v requirements.txt, můžou být stínované.
PYTHON_ISOLATE_WORKER_DEPENDENCIES	`1`	Určete prioritu načítání knihoven Python z balíčku aplikace definovaného v requirements.txt. Tato hodnota zabraňuje kolidování knihoven s interními knihovnami pracovního procesu Python.

PYTHON_ENABLE_DEBUG_LOGGING

Umožňuje protokolování na úrovni ladění v aplikaci funkcí Python. Hodnota 1 umožňuje 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í Python funkce.

Při ladění funkcí Pythonu nezapomeňte podle potřeby také nastavit úroveň protokolování na "debug" nebo "trace" v souboru host.json. Další informace najdete v tématu Pokud konfigurace monitorování pro Azure Functions.

PYTHON_ENABLE_OPENTELEMETRY

Určuje, jestli má pracovní proces Python exportovat telemetrii do koncového bodu Open Telemetry. Nastavením tohoto příznaku na True sdělí hostiteli functions, aby Python pracovní proces exportoval data OpenTelemetry do nakonfigurovaných OTEL_EXPORTER_OTLP_ENDPOINT. Další informace naleznete v tématu Konfigurace nastavení aplikace.

PYTHON_ENABLE_WORKER_EXTENSIONS

Konfigurace je specifická pro Python aplikace funkcí. Nastavením této hodnoty umožníte 1 pracovníkovi načíst Python worker extensions definované v requirements.txt. Umožňuje vaší aplikaci funkcí access nové funkce poskytované partnerskými balíčky. Může také změnit chování načítání a vyvolání funkcí 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 žádnému 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	Value	Description
PYTHON_ENABLE_WORKER_EXTENSIONS	`0`	Zakažte jakékoli rozšíření pracovního procesu Python.
PYTHON_ENABLE_WORKER_EXTENSIONS	`1`	Povolit Python pracovního procesu 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 spuš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 Python rozšířit počet vláken na zadanou hodnotu. Nastavení platí jenom pro aplikace funkcí Python. Navíc toto nastavení se vztahuje na synchronní volání funkcí, nikoli na korutiny.

Key	Ukázková hodnota	Maximální 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í Azure Functions. Další informace naleznete v tématu Protokoly kontroleru škálování.

Key	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:

Property Description

<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 ve vaší funkční aplikaci je povolena služba Application Insights.
Když nastavíte cíl na Blob, protokoly se vytvoří v kontejneru objektů blob s názvem azure-functions-scale-controller ve výchozím storage účtu nastaveném v nastavení aplikace AzureWebJobsStorage.

<VERBOSITY> Určuje úroveň protokolování. Podporované hodnoty jsou None, Warninga Verbose.
Při nastavení Verbose zaznamená kontrolor škálování důvod každé změny počtu pracovníků a informace o aktivačních událostech, které se podílejí na těchto rozhodnutích. Podrobné protokoly zahrnují upozornění na spouště a hashe, které používají triggery před a po spuštění kontroléru škálování.

Property	Description
`<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 ve vaší funkční aplikaci je povolena služba Application Insights. Když nastavíte cíl na `Blob`, protokoly se vytvoří v kontejneru objektů blob s názvem `azure-functions-scale-controller` ve výchozím storage účtu nastaveném v nastavení aplikace `AzureWebJobsStorage`.
`<VERBOSITY>`	Určuje úroveň protokolování. Podporované hodnoty jsou `None`, `Warning`a `Verbose`. Při nastavení `Verbose` zaznamená kontrolor škálování důvod každé změny počtu pracovníků a informace o aktivačních událostech, které se podílejí na těchto rozhodnutích. Podrobné protokoly zahrnují upozornění na spouště a hashe, které používají triggery před a po spuštění kontroléru škálování.

Tip

Mějte na paměti, že když necháte protokolování řadiče škálování povolené, ovlivňuje to potenciální náklady na monitorování funkční aplikace. 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 je SCM_DO_BUILD_DURING_DEPLOYMENT nastavena na true, project se sestaví vzdáleně během nasazování.

Key	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).

Key	Ukázková hodnota
SCM_LOGSTREAM_TIMEOUT	`1800`

Předchozí ukázková hodnota 1800 nastaví časový limit 30 minut. Další informace najdete v tématu Enable protokolů spouštění streamování v Azure Functions.

WEBSITE_CONTENTAZUREFILECONNECTIONSTRING

Connection string pro účet storage, 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 Storage nastavení připojení účtu.

Key	Ukázková hodnota
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING	`DefaultEndpointsProtocol=https;AccountName=...`

Toto nastavení se vyžaduje pro aplikace plánu Consumption i Elastic Premium. Není vyžadováno pro aplikace na vyhrazeném plánu, které funkce nedynamicky škáluje.

Plán Flex Consumption je doporučený plán hostování bez serveru pro Azure Functions. Poskytuje rychlejší škálování, snížení studených startů, privátních sítí a větší kontrolu nad výkonem a náklady v porovnání s plánem Consumption. Pokud aktuálně používáte plán Consumption, doporučujeme migrovat do plánu Flex Consumption. Další informace najdete v tématu Plán Flex Consumption.

Změna nebo odebrání tohoto nastavení může způsobit, že se vaše aplikace funkcí nespustí. Další informace najdete v článku o řešení potíží this.

Azure Files v současné době nepodporuje použití spravované identity při přístupu ke sdílené složce. Další informace najdete v tématu Azure Files podporované scénáře ověřování.

Pro toto nastavení připojení můžete použít referenční informace ke službě KeyVault . K vytvoření a dynamickému škálování aplikace funkcí v plánu Premium nebo Consumption se ale vyžaduje další konfigurace, když se storage connection string udržuje ve službě KeyVault. Další informace najdete v tématu Konsiderations pro připojení Azure Files.

WEBSITE_CONTENTOVERVNET

Important

WEBSITE_CONTENTOVERVNET je starší nastavení aplikace, které bylo nahrazeno vlastností webu vnetContentShareEnabled .

Hodnota 1 umožňuje aplikaci funkcí škálovat mezi kolky, pokud máte účet storage omezený na virtual network. Toto nastavení byste měli povolit při omezení účtu storage na virtual network. Vyžaduje se pouze při použití WEBSITE_CONTENTSHARE a WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. Další informace najdete v tématu Restrict vašeho účtu storage na virtual network.

Key	Ukázková hodnota
WEBSITE_CONTENTOVERVNET	`1`

Toto nastavení aplikace se vyžaduje pro škálování napříč kolky v< plánech Elastic Premium a Dedicated (App Service) (> Standard a vyšší), pokud je účet storage omezený na virtuální síť. Bez tohoto nastavení může aplikace funkcí škálovat pouze v rámci jednoho razítka (přibližně 1–20 instancí). Nepodporováno při spuštění na Consumption plánu.

Note

Při směrování do sdílené složky obsahu ve storage účtu 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 Konsistent směrování prostřednictvím virtuálních sítí v článku Storage důležité informace.

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 řetězec jedinečný vygenerovaný běhovým prostředím, začínající názvem aplikační funkce. Další informace najdete v tématu Storage nastavení připojení účtu.

Key	Ukázková hodnota
WEBSITE_CONTENTSHARE	`functionapp091999e2`

Toto nastavení se vyžaduje jenom pro aplikace plánu Consumption a Premium. Nevyžaduje se pro aplikace vyhrazeného plánu, které nejsou dynamicky škálovány funkcemi.

Sdílení je vytvořeno, když je vytvořena vaše aplikační funkce. Změna nebo odebrání tohoto nastavení může způsobit, že se vaše aplikace funkcí nespustí. Další informace najdete v článku o řešení potíží this.

Při použití šablony Azure Resource Manager (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í funkční aplikaci ani pro žádné aplikace ve slotech, vygenerují se pro vás jedinečné hodnoty sdílení. WEBSITE_CONTENTSHARE Nastavení není doporučeno pro nasazení šablony ARM.
Existují scénáře, kdy je nutné nastavit hodnotu WEBSITE_CONTENTSHARE na předdefinovanou hodnotu, například při použití zabezpečeného účtu storage v virtual network. V takovém případě musíte nastavit jedinečný název pro sdílení pro hlavní funkční aplikaci a aplikaci pro každý slot nasazení. Pro storage účet zabezpečený virtual network musíte také vytvořit samotnou sdílenou složku jako součást automatizovaného nasazení. Další informace naleznete v tématu Zabezpečené nasazení.
Nedělejte WEBSITE_CONTENTSHARE nastavení slotu.
Při zadání WEBSITE_CONTENTSHARE musí hodnota splňovat tyto pokyny pro názvy sdílení.

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í, například Azure DNS privátních zón a koncových bodů private.

Key	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 na 1, Použije se kódování Brotli. V opačném případě 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 Manager (ARM).

Key	Ukázková hodnota
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED	0

WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT

Maximální počet instancí, na které může aplikace scale out. Výchozí hodnota není nijak omezena.

Important

Toto nastavení je ve verzi Preview. Vlastnost app pro funkci max scale out nyní existuje. Doporučujeme tuto vlastnost pro omezení horizontálního škálování.

Key	Ukázková hodnota
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT	`5`

WEBSITE_NODE_DEFAULT_VERSION

pouze Windows. Nastaví verzi Node.js, která se použije při spuštění aplikace funkcí na 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á ~18hodnota , použije se nejnovější verze Node.js 18. Pokud je hlavní verze označena tildou, nemusíte ručně aktualizovat menší verzi.

Key	Ukázková hodnota
WEBSITE_NODE_DEFAULT_VERSION	`~18`

WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS

Když provádíte prohození slotů a v aplikaci funkcí spuštěné v plánu Premium, může prohození selhat, když je vyhrazený účet storage používaný aplikací omezený sítí. Příčinou tohoto selhání je starší funkce protokolování application, která sdílí funkce i App Service. Toto nastavení přepíše funkci staršího protokolování a umožňuje výměnu.

Key	Ukázková hodnota
WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS	`0`

Přidejte WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS s hodnotou 0 do všech slotů, abyste měli jistotu, že starší nastavení diagnostiky nezablokuje vaše výměny. Toto nastavení a hodnotu můžete také přidat pouze do produkčního slotu jako nastavení pro nasazovací slot (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í nasazení slotů. Tento přístup zabrání neočekávanému chování způsobenému změnami verzí po výměně. Nastavte hodnotu na 0 v provozním prostředí a ve slotu, abyste se ujistili, že se prohodí také všechna nastavení verzí. Další informace najdete v tématu Upgrade pomocí slotů.

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

Key	Ukázková hodnota
WEBSITE_RUN_FROM_PACKAGE	`1`

Platné hodnoty jsou buď adresa URL, která vede na umístění souboru externího instalačního balíčku, nebo 1. Při nastavení 1musí být balíček ve d:\home\data\SitePackages složce. Když použijete nasazení zip s povoleným WEBSITE_RUN_FROM_PACKAGE, balíček se automaticky nahraje do tohoto umístění. Další informace najdete v tématu Spuštění funkcí ze souboru balíčku.

Pokud používáte WEBSITE_RUN_FROM_PACKAGE=<URL>, adresa URL se musí přeložit na umístění souboru balíčku v přístupném storage umístění, jako je kontejner Azure Blob Storage. Kontejner musí být soukromý, aby se zabránilo neoprávněnému access, což vyžaduje, abyste k povolení access použili sdílený podpis access (SAS) v adrese URL nebo Microsoft Entra ID ověřování. Doporučuje se používat Microsoft Entra ID se spravovanými identitami.

Toto je příklad nastavení WEBSITE_RUN_FROM_PACKAGE na adresu URL balíčku pro nasazení v kontejneru Azure blogu Storage:
WEBSITE_RUN_FROM_PACKAGE=https://contosostorageaccount.blob.core.windows.net/mycontainer/mypackage.zip

Při použití SAS připojíte token k adrese URL jako parametr dotazu.

Při deploy balíčku z Azure Blob Storage pomocí spravované identity přiřazené uživatelem musíte také nastavit WEBSITE_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID na ID prostředku spravované identity přiřazené uživatelem. 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_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID

Označuje ID prostředku spravované identity přiřazené uživatelem, která se používá při přístupu k balíčku nasazení z externího kontejneru Azure Blob Storage zabezpečeného pomocí Microsoft Entra ID. Toto nastavení vyžaduje, aby WEBSITE_RUN_FROM_PACKAGE byla nastavena adresa URL balíčku pro nasazení v privátním kontejneru.

Nastavení WEBSITE_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID=SystemAssigned je stejné jako vynechání nastavení, v takovém případě se použije spravovaná identita přiřazená systémem pro aplikaci.

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 Storage nebo Key Vault kvůli omezením sítě nebo jiným omezujícím faktorům. Při nastavení proměnné WEBSITE_SKIP_CONTENTSHARE_VALIDATION na 1 se kontrola ověření přeskočí. V opačném případě se hodnota nastaví 0 na výchozí hodnotu a provede se ověření.

Key	Ukázková hodnota
WEBSITE_SKIP_CONTENTSHARE_VALIDATION	`1`

Pokud se ověření přeskočí a connection string nebo sdílená složka obsahu není platná, aplikace se nemůže správně spustit. V tomto případě funkce vrací chyby HTTP 500. Další informace najdete v tématu Troubleshoot error: "Azure Functions Runtime je nedostupný".

WEBSITE_SLOT_NAME

Read-only. Název aktuálního slotu nasazení Název produkčního slotu je Production.

Key	Ukázková hodnota
WEBSITE_SLOT_NAME	`Production`

WEBSITE_TIME_ZONE

Umožňuje nastavit časové pásmo pro vaši aplikaci funkcí.

Key	OS	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	Plan	Value
Windows	All	Nastavte hodnotu na název požadovaného časového pásma, jak je uvedeno ve druhém řádku každé dvojice, kterou poskytuje příkaz Windows `tzutil.exe /L`.
Linux	Premium Dedicated	Nastavte hodnotu na název požadovaného časového pásma, jak je znázorněno v databázi tz.

Note

WEBSITE_TIME_ZONE a TZ nejsou v současné době podporovány při provozu na Linuxu v plánu Flex Consumption nebo Consumption. V takovém případě může nastavení 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 * * *"

Při použití WEBSITE_TIME_ZONEse čas upraví 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, zda se má při běhu na Plánu spotřeby použít určitá optimalizace studeného startu. Nastavte na hodnotu 0, abyste zakázali optimalizaci studeného startu v plánu Consumption.

Key	Ukázková hodnota
WEBSITE_USE_PLACEHOLDER	`1`

WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED

Určuje, jestli se má při spouštění .NET funkcí izolovaného pracovního procesu v plánu 1 použít konkrétní optimalizace sumpd start. Nastavte na hodnotu 0, abyste zakázali optimalizaci studeného startu v plánu Consumption.

Key	Ukázková hodnota
WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED	`1`

WEBSITE_VNET_ROUTE_ALL

Important

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 virtual network. Hodnota nastavení 1 označuje, že veškerý provoz aplikace je směrován přes virtual network. Toto nastavení potřebujete při konfiguraci integrace regionální virtual network v plánech elastického hostování Úrovně Premium a Dedicated. Používá se také v případech, kdy se k definování statické odchozí IP adresy používá virtual network NAT Gateway.

Key	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 hodnotu byste měli nastavit na false při nasazování funkční aplikace v kontejneru.

nastavení webu App Service

Některé konfigurace musí být zachovány na úrovni App Service jako nastavení lokality, jako jsou jazykové verze. Tato nastavení se spravují v Azure portal pomocí rozhraní REST API nebo pomocí Azure CLI nebo Azure PowerShell. V závislosti na jazyce runtime, operačním systému a verzích můžete vyžadovat následující nastavení webu.

AcrUseManagedIdentityCreds

Určuje, zda je image získána z instance Azure Container Registry pomocí ověřování spravované identity. Hodnota true vyžaduje, abyste použili spravovanou identitu. Tento přístup doporučujeme použít u uložených přihlašovacích údajů pro ověřování jako osvědčený postup zabezpečení.

AcrUserManagedIdentityID

Označuje spravovanou identitu, která se má použít při získávání image z instance Azure Container Registry. Vyžaduje, aby AcrUseManagedIdentityCreds byla nastavena hodnota true. Tyto hodnoty jsou platné:

Value	Description
`system`	Používá se spravovaná identita přiřazená systémem aplikace funkcí.
`<USER_IDENTITY_RESOURCE_ID>`	Plně kvalifikované ID prostředku spravované identity přiřazené uživatelem.

Zadaná identita musí být přidána do ACRPull role v registru kontejneru. Další informace najdete v tématu Vytvoření a konfigurace aplikace funkcí na Azure s obrázkem.

alwaysOn

V aplikaci funkcí spuštěné v plánu Dedicated (App Service) modul runtime Služby Functions po několika minutách nečinnosti nečiní, což odkazuje pouze na požadavky na trigger HTTP wakes up vaší aplikaci funkcí. Abyste měli jistotu, že se funkce, které nejsou aktivované protokolem HTTP, správně spouštějí, včetně funkcí triggeru časovače, povolte Always On pro aplikaci funkcí tak, že nastavíte nastavení webu alwaysOn 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 pod /admin, když tyto požadavky obsahují hlavní klíč. Když true nelze přistoupit ke koncovým bodům /admin, dokonce ani s hlavním klíčem.

Tuto vlastnost nejde nastavit pro aplikace běžící v Linuxu v plánu Consumption. Nejde nastavit pro aplikace běžící na Azure Functions verze 1.x. 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 FUNCTIONS_EXTENSION_VERSION k určení, který konkrétní Linuxový kontejnerový obraz se instaluje ke spuštění vaší funkční aplikace. 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 šablonu ARM a Bicep nasazení a v určitých scénářích upgradu.

Platné hodnoty linuxFxVersion

Pomocí následujícího příkazu Azure CLI můžete zobrazit tabulku aktuálních hodnot linuxFxVersion podporovanými verzemi modulu runtime functions:

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í snímky

Při vytváření a údržbě vlastního linuxového kontejneru pro vaši linuxFxVersion aplikaci Function je hodnota v tomto případě 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"

Tento příklad označuje zdroj registru nasazeného kontejneru. Další informace najdete v tématu Pracování s kontejnery a Azure Functions.

Important

Když vytváříte vlastní kontejnery, 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. Viz základní image Azure Functions repos.

Tým Functions se zavazuje publikovat měsíční aktualizace těchto základních imagí. Pravidelné aktualizace zahrnují nejnovější aktualizace menších verzí a opravy zabezpečení jak pro prostředí Functions runtime, tak pro jazyky. Kontejner byste měli pravidelně aktualizovat z nejnovější základní image a znovu nasadit aktualizovanou verzi kontejneru. Pro více informací, viz Údržba vlastních kontejnerů.

netFrameworkVersion

Nastaví konkrétní verzi .NET pro funkce jazyka C#. Další informace najdete v tématu Update 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 nastavení aplikace WEBSITE_CONTENTSHARE a jeho connection string je uložen v WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. Pokud chcete směrovat provoz mezi vaší aplikací funkcí a sdílením obsahu prostřednictvím virtual network, musíte také nastavit vnetContentShareEnabled na true. Při třízení účtu storage na virtual network se vyžaduje povolení této vlastnosti webu při škálování napříč razítky. Bez tohoto nastavení může aplikace funkcí škálovat pouze v rámci jednoho razítka (přibližně 1–20 instancí).

Note

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ř virtual network, musíte nastavit vnetImagePullEnabled na 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 Ukončení podpory plánu Flex Consumption.

vnetRouteAllEnabled

Určuje, jestli se veškerý odchozí provoz z aplikace směruje přes virtual network. Hodnota nastavení true označuje, že veškerý provoz aplikace je směrován přes virtual network. Toto nastavení použijte při konfiguraci integrace Regionální virtual network 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á virtual network NAT Gateway. Další informace naleznete v tématu Konfigurace směrování aplikace.

Toto nastavení webu nahrazuje starší nastavení WEBSITE_VNET_ROUTE_ALL .

Zrušení podpory 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í:

Setting/property	Reason
`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 `nameproperties.functionAppConfig.runtime`
`FUNCTIONS_WORKER_RUNTIME_VERSION`	Nahrazeno v `versionproperties.functionAppConfig.runtime`
`FUNCTIONS_MAX_HTTP_CONCURRENCY`	Nahrazeno sekcí aktivace š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 nasazovací sekcí v konfiguraci funkční aplikace functionAppConfig.
`WEBSITE_CONTENTOVERVNET`	Nepoužívá se pro sítě ve službě Flex Consumption
`WEBSITE_CONTENTSHARE`	Nahrazeno nasazovací sekcí v konfiguraci funkční aplikace functionAppConfig.
`WEBSITE_DNS_SERVER`	DNS se dědí z integrovaného virtual network ve funkci Flex.
`WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT`	Nahrazeno v `maximumInstanceCountproperties.functionAppConfig.scaleAndConcurrency`
`WEBSITE_NODE_DEFAULT_VERSION`	Nahrazeno v `versionproperties.functionAppConfig.runtime`
`WEBSITE_RUN_FROM_PACKAGE`	Nepoužívá se pro nasazení ve službě Flex Consumption
`WEBSITE_SKIP_CONTENTSHARE_VALIDATION`	Sdílení obsahu se nepoužívá ve 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.dnsConfiguration.dnsServers	DNS se dědí z integrovaného virtual network v plánu Flex Consumption.
`properties.ftpsState`	Protokol FTPS není podporován.
`properties.isReserved`	Neplatné
`properties.IsXenon`	Neplatné
`properties.javaVersion`	Nahrazeno v `versionproperties.functionAppConfig.runtime`
`properties.LinuxFxVersion`	Nahrazuje `properties.functionAppConfig.runtime`
`properties.netFrameworkVersion`	Nahrazeno v `versionproperties.functionAppConfig.runtime`
`properties.powerShellVersion`	Nahrazeno v `versionproperties.functionAppConfig.runtime`
`properties.siteConfig.functionAppScaleLimit`	Přejmenováno jako `maximumInstanceCount`
`properties.siteConfig.preWarmedInstanceCount`	Přejmenováno jako `alwaysReadyInstances`
`properties.use32BitWorkerProcess`	32bitový systém není podporován
`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é

Váš názor

Byla tato stránka užitečná?

Last updated on 2026-03-11