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:

• Na webu Azure Portal.
• Pomocí Azure CLI.
• Pomocí Azure PowerShellu.

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 používá platformu Aplikace Azure Service pro hostování, můžete najít některá nastavení relevantní pro hostování vaší aplikace funkcí popsané v proměnných prostředí a nastavení aplikace ve službě 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 jsou interpretována jako hierarchické oddělovače v systémech Windows i Linux a dvojtečky jsou interpretovány stejným způsobem pouze ve 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.

• 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_STRINGzá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í.

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

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

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:

Hodnota	Popis
Production	Představuje produkční prostředí s nižším protokolováním a úplnou optimalizací výkonu. Toto je výchozí nastavení, 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ývoj podpora prostředí více podrobného protokolování a dalších nižších optimalizací výkonu. Nástroje Azure Functions Core Tools se nastaví AZURE_FUNCTIONS_ENVIRONMENT při Development spuštění na místním počítači. Toto nastavení nelze přepsat v souboru local.settings.json.

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 falsena , zobrazí se stránka podobná následujícímu příkladu v odpovědi na adresu URL <functionappname>.azurewebsites.net.

AzureWebJobsDotNetReleaseCompilation

true znamená režim použití Release při kompilaci kódu .NET; false znamená použití režimu 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, Lista 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, Lista 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 1hodnotu . Ú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 104 857 600 bajtů.

Klíč	Ukázková hodnota
FUNCTIONS_REQUEST_BODY_SIZE_LIMIT	250000000

FUNCTIONS_V2_COMPATIBILITY_MODE

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 MDNewSnapshotCheckPeriodpracovní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/simpleve 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-urlpouž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-urlvlastní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í AppInsightsse 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, Warninga Verbose. Při nastavení Verbosezaznamená 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í.

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

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.

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_CONTENTSHAREmusí 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.

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á ~18hodnota , 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í 1musí 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.

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

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:

AcrUseManagedIdentityCreds

Určuje, jestli se image získá z instance služby Azure Container Registry pomocí ověřování spravované identity. Hodnota vyžaduje, aby se použila spravovaná identita, která se doporučuje u uložených true 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 služby Azure Container Registry. Vyžaduje, aby AcrUseManagedIdentityCreds byla nastavena hodnota true. Toto jsou platné hodnoty:

Hodnota	Popis
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í v Azure s imagí.

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 truenení 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_VERSIONo 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.

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

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 nameproperties.functionAppConfig.runtime
FUNCTIONS_WORKER_RUNTIME_VERSION	Nahrazeno v versionproperties.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 versionproperties.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 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ý 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