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 hodnoty připojovacího řetězce zkráceny kvůli lepší čitelnosti.

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

• Dvojité podtržítko (__) a dvojtečka (:) se považují za rezervované hodnoty v názvech nastavení. 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 funkční aplikace nejrelevantnější. 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 (Klíč instrumentace Aplikace Insights)

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 (Klíč instrumentace Aplikace Insights)	55555555-af77-484b-9032-64f83bb83bb

Nepoužívejte obojí APPINSIGHTS_INSTRUMENTATIONKEY ani APPLICATIONINSIGHTS_CONNECTION_STRING. Doporučuje se použití 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	Nastavení hodnoty
Automaticky přiřazeno systémem	Authorization=AAD
Přiřazeno uživatelem	Authorization=AAD;ClientId=<USER_ASSIGNED_CLIENT_ID>

Tento požadavek na ověřování se použije pro připojení z hostitele služby Functions, ladicího programu snímků, profileru a agentů specifických pro jazyk. Pokud chcete toto nastavení použít, musí už být spravovaná identita dostupná pro aplikaci funkcí s přiřazenou rolí, která je ekvivalentní vydavateli metrik monitorování.

Poznámka:

Pokud se připojujete APPLICATIONINSIGHTS_AUTHENTICATION_STRING k Application Insights pomocí ověřování Microsoft Entra, měli byste také zakázat místní ověřování pro Application Insights. Tato konfigurace vyžaduje ověřování Microsoft Entra, aby se telemetrie mohla ingestovat do vašeho pracovního prostoru.

Řetězec připojení pro Application Insights

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 další přizpůsobení podporovaná pomocí připojovacího řetězce
• 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
Řetězec připojení pro Application Insights	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 (zakázat místní volání)

Důležité

Proxy služby Azure Functions je starší funkce pro verze 1.x až 3.x modulu runtime Azure Functions. Další informace o podpoře starších verzí ve verzi 4.x najdete v části Proxy funkce.

Ve výchozím nastavení proxy služby Functions používají zkratku k odesílání volání z API proxy přímo do funkcí ve stejné funkční aplikaci. Místo vytvoření nového požadavku HTTP se používá tento zástupce. Toto nastavení umožňuje zakázat funkčnost této klávesové zkratky.

Klíč	Hodnota	Popis
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL (zakázat místní volání)	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 (zakázat místní volání)	false	Volání s URL adresou, která ukazuje na funkci v místní funkční aplikaci, jsou předávána přímo funkci. false je výchozí hodnota.

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES (jedná se o konfigurační parametr v systému Azure pro dekódování lomítek v URL)

Důležité

Proxy služby Azure Functions je starší funkce pro verze 1.x až 3.x modulu runtime Azure Functions. Další informace o podpoře starších verzí ve verzi 4.x najdete v části Proxy funkce.

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.

Klíč	Hodnota	Popis
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES (jedná se o konfigurační parametr v systému Azure pro dekódování lomítek v URL)	true	Parametry trasy s zakódovanými lomítky jsou dekódovány.
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES (jedná se o konfigurační parametr v systému Azure pro dekódování lomítek v URL)	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 pro funkční aplikaci ve specifické myfunction.com doméně.

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

Když je AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES nastaveno na true, adresa URL example.com/api%2ftest směřuje na example.com/api/test. Ve výchozím nastavení zůstane adresa URL beze změny .example.com/test%2fapi Další informace naleznete v tématu funkce proxy.

Prostředí Azure Functions (AZURE_FUNCTIONS_ENVIRONMENT)

Nakonfiguruje hostitelské prostředí runtime aplikace funkcí, když běží 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í se sníženou úrovní protokolování 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ývojové prostředí podporuje podrobnější protokolování a další optimalizace s nižším výkonem. Azure Functions Core Tools nastaví AZURE_FUNCTIONS_ENVIRONMENT na Development při spuštění na vašem 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 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 ú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.
• 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.

Klíč	Ukázková hodnota
AzureFunctionsWebHost__hostid	myuniquefunctionappname123456789

Další informace najdete v tématu Důležité informace o ID hostitele.

Azure WebJobs Dashboard

Toto nastavení je zastaralé a podporuje se pouze při spuštění na verzi 1.x modulu runtime Azure Functions.

Volitelný připojovací řetězec účtu úložiště pro ukládání protokolů a jejich zobrazení v záložce Monitor v portálu. Účet úložiště musí být všeobecný účet, který podporuje bloby, fronty a tabulky. Další informace viz Požadavky na účet úložiště.

Klíč	Ukázková hodnota
Azure WebJobs Dashboard	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.

AzureWebJobsDotNetReleaseKompilace

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

Klíč	Ukázková hodnota
AzureWebJobsDotNetReleaseKompilace	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.

Klíč	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é parametry funkcí

Hodnota příznaku	Popis
EnableProxies	Opětovné povolení proxy serverů 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.
EnableAzureMonitorTimeIsoFormat	ISO 8601 Umožňuje formát času v protokolech služby Azure Monitor 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.

Klíč	Ukázková hodnota
AzureWebJobsKubernetesSecretName	<SECRETS_RESOURCE>

Důležité informace o použití prostředku tajných kódů Kubernetes:

• 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 tyto hodnoty generují automaticky 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 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 klientské ID uživatelsky přiřazené spravované identity nebo registraci aplikace, která se používá k přístupu k trezoru, ve kterém jsou klíče uložené. 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í systémem přiřazené spravované identitě hostitelského zdroje. 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 k registraci 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 Key Vault zobrazeného na kartě Přehled služby Key Vault, včetně https://.

Trezor musí mít zásadu přístupu odpovídající systémem přiřazené spravované identitě hostitelského zdroje. 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

Důležité

Tajnosti nejsou omezeny na jednotlivé funkční aplikace prostřednictvím nastavení AzureWebJobsSecretStorageKeyVaultUri. Pokud je pro použití stejné služby Key Vault nakonfigurovaných více aplikací funkcí, které sdílejí stejné tajné kódy, může to 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 služby Key Vault.

Další informace najdete v tématu Správa úložiště klíčů.

AzureWebJobsSecretStorageSas

Adresa URL SAS služby Blob Storage pro druhý úložný účet používaný pro ukládání 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>

AzureWebJobs Tajný Typ Úložiště

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

Klíč	Hodnota	Popis
AzureWebJobs Tajný Typ Úložiště	blob	Klíče se ukládají v kontejneru úložiště typu Blob v účtu poskytnutém konfigurací s 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ě.
AzureWebJobs Tajný Typ Úložiště	files	Klíče jsou trvalé v systému souborů. Toto je výchozí chování pro functions v1.x.
AzureWebJobs Tajný Typ Úložiště	keyvault	Klíče jsou uloženy v instanci trezoru klíčů nastavenou pomocí AzureWebJobsSecretStorageKeyVaultName.
AzureWebJobs Tajný Typ Úložiště	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žbami Functions patří správa klíčů, správa časovačů a kontrolní body služby Event Hubs. Účet úložiště musí být všeobecný účet, který podporuje bloby, 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ího řetězce 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ího řetězce v AzureWebJobsStorage. Tato syntaxe je jedinečná pro AzureWebJobsStorage a nelze ji 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í k úložišti založeného na identitě nastaví URI datové roviny 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í úložišťového připojení založeného na identitě nastaví URI datové roviny služby fronty úložišťového účtu.

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í URI datové vrstvy 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, aby FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED bylo nastaveno na 1.

ENABLE_ORYX_BUILD

Určuje, zda je během nasazování používán buildovací systém 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í.

Klíč	Ukázková hodnota
ENABLE_ORYX_BUILD	true

REŽIM ÚPRAV FUNKCE APLIKACE

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

Klíč	Ukázková hodnota
REŽIM ÚPRAV FUNKCE APLIKACE	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.

FUNKCE_VERZE_ROZŠÍŘENÍ

Verze modulu runtime Functions, která hostuje vaši funkční aplikaci. 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
FUNKCE_VERZE_ROZŠÍŘENÍ	~4

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

Hodnota	Cíl modulu během běhu	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ř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 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 Jak cílit na verze modulu runtime v Azure Functions.

Funkce_v_procesu_NET8_povoleno

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
Funkce_v_procesu_NET8_povoleno	1

Nastavte 0 pro zakázání podpory pro .NET 8 v modelu v rámci procesu.

FUNKCE_UZEL_BLOK_NA_ERROR_VSTUPNÍ_BOD

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 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 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ána po (například pokud se pokusíte zaregistrovat opakující se funkce modelu v4), výchozí chování odpovídá true.

Klíč	Hodnota	Popis
FUNKCE_UZEL_BLOK_NA_ERROR_VSTUPNÍ_BOD	true	Zablokujte chyby vstupního bodu a protokolujte je v Application Insights.
FUNKCE_UZEL_BLOK_NA_ERROR_VSTUPNÍ_BOD	false	Chyby vstupního bodu ignorujte a nepřihlašujte je do Application Insights.

LIMIT_VELIKOSTI_TĚLA_POŽADAVKU_FUNKCÍ

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
LIMIT_VELIKOSTI_TĚLA_POŽADAVKU_FUNKCÍ	250000000

FUNCTIONS_V2_COMPATIBILITY_MODE

Důležité

Toto nastavení se už nepodporuje. Původně mělo umožnit krátkodobé alternativní řešení pro aplikace, které cílí na runtime v2.x, aby bylo možné je místo toho spustit na runtime v3.x, dokud byla stále podporována. S výjimkou starších aplikací, které běží na verzi 1.x, musí všechny aplikace funkcí běžet ve verzi 4.x modulu runtime Functions: FUNCTIONS_EXTENSION_VERSION=~4. Další informace najdete v přehledu verzí modulu runtime Azure Functions.

Počet procesů pracovníka funkcí

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 jazykové moduly runtime, s výjimkou rozhraní .NET spuštěného v procesu (FUNCTIONS_WORKER_RUNTIME=dotnet).

Klíč	Ukázková hodnota
Počet procesů pracovníka funkcí	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	Jazykový zásobník
dotnet	C# (knihovna tříd) C# (skript)
dotnet-isolated	C# (izolovaný pracovní proces)
java	Java
node	JavaScript Strojopis
powershell	Prostředí PowerShell
python	Krajta
custom	Jiné

FUNKCE_PRACOVNÍK_SDÍLENÁ_PAMĚŤ_PŘENOS_DAT_POVOLEN

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 narazí na paměťové úzké místo.

Klíč	Ukázková hodnota
FUNKCE_PRACOVNÍK_SDÍLENÁ_PAMĚŤ_PŘENOS_DAT_POVOLEN	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 spotřeby místo toho použijte languageWorkers__java__arguments. Další informace naleznete v tématu Přizpůsobení prostředí JVM.

jazykovíPracovníci__java__argumenty

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 časy studeného startu funkcí Java spuštěných v plánu spotřeby. 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 (kept unchanged if it is a technical term without a Czech equivalent)

Ří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 zahajuje kontrolu upgradů modulů na PowerShell Galerie při spuštění procesu a po každé MDMaxBackgroundUpgradePeriod poté. 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 (kept unchanged if it is a technical term without a Czech equivalent)	7.00:00:00

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

MDNewSnapshotCheckPeriod

Určuje, jak často každý pracovní proces PowerShellu kontroluje, jestli byly nainstalovány upgrady spravovaných závislostí. Výchozí frekvence je 01:00:00 (hodinová).

Po instalaci nových verzí modulů do systému souborů se musí restartovat každý pracovní proces PowerShellu. Restartování pracovních procesů PowerShellu má vliv na dostupnost vaší aplikace, protože může přerušit aktuální spuštění funkce. Dokud se všechny pracovní procesy PowerShellu nerestartují, můžou vyvolání funkcí používat staré nebo nové verze modulu. Restartování všech pracovních procesů PowerShellu se dokončí v rámci MDNewSnapshotCheckPeriod.

V rámci každého MDNewSnapshotCheckPeriod proces PowerShellu zkontroluje, jestli byly nainstalovány upgrady spravovaných závislostí či nikoliv. 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í.

MDMinMinimálníDobaAktualizaceNaPozadí

Č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 restartech pracovníků, kontrola upgradů modulů neprobíhá, pokud už některý pracovník zahájil tuto kontrolu v posledním MDMinBackgroundUpgradePeriod.

Klíč	Ukázková hodnota
MDMinMinimálníDobaAktualizaceNaPozadí	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--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, 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ů. 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--extra-index-urlvlastním závislostem v referenčních informacích pro vývojáře Pythonu.

Projekt

Nastavení průběžného nasazování, které službě nasazení Kudu říká, ve které složce v připojeném úložišti se nachází nasaditelný projekt.

Klíč	Ukázková hodnota
Projekt	WebProject/WebProject.csproj

Python_Oddělit_Pracovní_Závislosti

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.

Klíč	Hodnota	Popis
Python_Oddělit_Pracovní_Závislosti	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_Oddělit_Pracovní_Závislosti	1	Určete prioritu načítání knihoven Pythonu z balíčku aplikace definovaného v requirements.txt. Tím zabráníte kolizi vašich knihoven s interními knihovnami pracovníka Pythonu.

PYTHON_ENABLE_DEBUG_LOGGING

Umožňuje protokolování na úrovni ladění v Pythonové funkční aplikaci. 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 sledování spuštění funkcí v Pythonu.

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

PYTHON_ENABLE_ROZŠÍŘENÍ_PRACOVNÍKA

Konfigurace je specifická pro aplikace funkcí Pythonu. Nastavením této možnosti 1 umožníte pracovníkovi načíst rozšíření pracovníků Pythonu definovaná v requirements.txt. Vaší funkční aplikaci umožňuje přístup k novým funkcím poskytovaným balíčky od třetích stran. 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 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.

Klíč	Hodnota	Popis
PYTHON_ENABLE_ROZŠÍŘENÍ_PRACOVNÍKA	0	Zakažte jakékoli rozšíření pracovního procesu Pythonu.
PYTHON_ENABLE_ROZŠÍŘENÍ_PRACOVNÍKA	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. Navíc toto nastavení se vztahuje na synchronní volání funkcí, nikoli na korutiny.

Klíč	Ukázková hodnota	Max. hodnota
PYTHON_THREADPOOL_THREAD_COUNT	2	32

SCALE_CONTROLLER_PROTOKOLOVÁNÍ_POVOLENO

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_PROTOKOLOVÁNÍ_POVOLENO	AppInsights:Verbose

Hodnota pro tento klíč je zadána ve formátu <DESTINATION>:<VERBOSITY>, který je definován takto:

Vlastnost	Popis
<DESTINATION>	Cíl, do kterého se protokoly odesílají. Platné hodnoty jsou AppInsights a Blob. Při použití AppInsights se ujistěte, že ve vaší funkční aplikaci je povolena služba Application Insights. Když nastavíte cíl na Blob, protokoly se vytvoří v kontejneru typu blob nazvaném azure-functions-scale-controller v nastaveném výchozím účtu úložiště v rámci 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í.

Návod

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_PROVÉST_BUILD_PŘI_DEPLOYMENTU

Řídí chování vzdáleného sestavení během nasazování. Když je nastaveno SCM_DO_BUILD_DURING_DEPLOYMENT na true, projekt se během nasazování sestaví vzdáleně.

Klíč	Ukázková hodnota
SCM_PROVÉST_BUILD_PŘI_DEPLOYMENTU	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í streamování a protokolů spouštění ve službě Azure Functions.

WEBSITE_CONTENTAZUREFILECONNECTIONSTRING (Připojovací řetězec k souboru Azure pro obsah webu)

Připojovací řetězec pro účet úložiště, kde jsou kód a konfigurace funkční aplikace ukládány v plánech škálování založených na událostech. Další informace najdete v tématu Nastavení připojení účtu úložiště.

Klíč	Ukázková hodnota
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING (Připojovací řetězec k souboru Azure pro obsah webu)	DefaultEndpointsProtocol=https;AccountName=...

Toto nastavení se vyžaduje pro aplikace plánu Consumption a Elastic Premium spuštěné v systémech Windows i Linux. Nevyžaduje se pro aplikace vyhrazeného plánu, které nejsou dynamicky škálovány funkcemi.

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

Služba Azure Files nepodporuje použití spravované identity při přístupu ke sdílené složce. Další informace najdete ve scénářích ověřování podporovaných službou Azure Files.

WEBSITE_CONTENTOVERVNET

Důležité

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

Hodnota 1 umožňuje, aby se vaše aplikace funkcí škálovala, 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šší). Nepodporováno při spuštění na Consumption plánu.

Poznámka:

Při směrování do sdílené složky obsahu v účtu úložiště sdíleném více aplikacemi funkcí ve stejném plánu musíte věnovat zvláštní pozornost. Další informace najdete v tématu Konzistentní směrování prostřednictvím virtuálních sítí v článku Důležité informace o úložišti.

SdíleníObsahuNaWebu

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 Nastavení připojení účtu úložiště.

Klíč	Ukázková hodnota
SdíleníObsahuNaWebu	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í 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 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í 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 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 pro sdílení pro hlavní funkční aplikaci 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í.
• 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í, jako například privátní zóny Azure DNS a privátní koncové body.

Klíč	Ukázková hodnota
WEBSITE_DNS_SERVER	168.63.129.16

WEBOVÁ_STRÁNKA_POVOLIT_BROTLI_KÓDOVÁNÍ

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 (Webové funkce - ARMCACHE povoleno)

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 (Webové funkce - ARMCACHE povoleno)	0

MAX_DYNAMICKÁ_APPLIKACE_ROZŠÍŘENÍ_WEBU

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

Důležité

Toto nastavení je ve verzi Preview. Byla přidána vlastnost aplikace pro maximální rozšíření kapacity funkce a doporučuje se ji použít pro omezení horizontálního navýšení kapacity.

Klíč	Ukázková hodnota
MAX_DYNAMICKÁ_APPLIKACE_ROZŠÍŘENÍ_WEBU	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 označena tildou, nemusíte ručně aktualizovat menší verzi.

Klíč	Ukázková hodnota
WEBSITE_NODE_DEFAULT_VERSION	~18

NASTAVENÍ_ÚPRAVY_ČÁSTEČNÉ_DIAGNOSTIKY_ NA_WEBU

Při provádění prohození slotu ve funkční aplikaci běžící na 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 funkci staršího protokolování a umožňuje výměnu.

Klíč	Ukázková hodnota
NASTAVENÍ_ÚPRAVY_ČÁSTEČNÉ_DIAGNOSTIKY_ NA_WEBU	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).

PŘEPÍNAČ_WEBOVÉ_STRÁNKY_FIXACE_VERZE_ROZŠÍŘENÍ

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ů. Toto zabraňuje neočekávanému chování kvůli změně 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ů.

Klíč	Ukázková hodnota
PŘEPÍNAČ_WEBOVÉ_STRÁNKY_FIXACE_VERZE_ROZŠÍŘENÍ	0

WEBOVÁ_STRÁNKA_SPUSŤ_Z_BALÍČKU

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
WEBOVÁ_STRÁNKA_SPUSŤ_Z_BALÍČKU	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í. 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.

WEBOVÁ_STRÁNKA_PŘESKOČIT_VALIDACI_SDÍLENÍ_OBSAHU

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ž funkční aplikace nemůže správně volat podřízený účet úložiště nebo službu Key Vault kvůli síťovým omezením 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
WEBOVÁ_STRÁNKA_PŘESKOČIT_VALIDACI_SDÍLENÍ_OBSAHU	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ý.

Název slotu webu

Jen pro čtení. Název aktuálního slotu nasazení Název produkčního slotu je Production.

Klíč	Ukázková hodnota
Název slotu webu	Production

ČASOVÁ_ZÓNA_WEBU

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

Klíč	Operační systém	Ukázková hodnota
ČASOVÁ_ZÓNA_WEBU	Windows	Eastern Standard Time
ČASOVÁ_ZÓNA_WEBU	Operační systém 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še	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	Prémiový Vyhrazené	Nastavte hodnotu na název požadovaného časového pásma, jak je znázorněno v databázi tz.

Poznámka:

WEBSITE_TIME_ZONE a TZ nejsou v současné době podporovány při spuštění na Linuxu v plánu Consumption nebo Flex Consumption. V takovém případě můžete nastavit WEBSITE_TIME_ZONE nebo TZ vytvořit problémy související s PROTOKOLem SSL a způsobit, že metriky přestanou fungovat pro vaši aplikaci.

Například východní čas v USA (reprezentovaný Eastern Standard Time (Windows) nebo America/New_York (Linux)) v současné době používá UTC-05:00 ve standardním čase a UTC-04:00 během letního času. Pokud chcete mít aktivaci časovače každý den v 10:00 východního času, vytvořte nastavení aplikace pro aplikaci funkcí s názvem WEBSITE_TIME_ZONE, nastavte hodnotu na Eastern Standard Time (Windows) nebo America/New_York (Linux) a pak použijte následující výraz NCRONTAB:

"0 0 10 * * *"

Když použijete WEBSITE_TIME_ZONE, čas se upraví pro změny v konkrétním časovém pásmu, včetně změn během letního a standardního času.

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.

Klíč	Ukázková hodnota
WEBSITE_USE_PLACEHOLDER	1

WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED

Určuje, zda použít specifickou optimalizaci studeného spuštění při spuštění funkcí izolovaného pracovního procesu .NET v plánu Consumption. Nastavte na hodnotu 0, abyste zakázali optimalizaci studeného startu v plánu Consumption.

Klíč	Ukázková hodnota
WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED	1

WEBSITE_VNET_ROUTE_ALL

Důležité

WEBSITE_VNET_ROUTE_ALL je starší nastavení aplikace, které bylo nahrazeno nastavením webu vnetRouteAllEnabled .

Určuje, jestli se veškerý odchozí provoz z aplikace směruje přes virtuální síť. Hodnota 1 nastavení označuje, že veškerý provoz aplikace je směrován přes virtuální síť. Toto nastavení budete potřebovat při konfiguraci integrace místní virtuální sítě v plánech elastického hostování a vyhrazeného hostování. Používá se také v případech, kdy se k definování statické odchozí IP adresy používá brána NAT virtuální sítě.

Klíč	Ukázková hodnota
WEBSITE_VNET_ROUTE_ALL	1

POVOLIT ÚLOŽIŠTĚ SLUŽBY APP NA WEBOVÝCH STRÁNKÁCH

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:

AcrPoužitSpravovanouIdentituPřihlašovacíchÚdajů

Určuje, jestli se image získá z instance služby Azure Container Registry pomocí ověřování spravované identity. Hodnota true vyžaduje použití spravované identity, což je doporučováno před uloženými přihlašovacími údaji 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í.

Funkce alwaysOn

V aplikaci funkcí spuštěné v plánu Dedicated (App Service) přejde modul runtime Functions po několika minutách nečinnosti do režimu spánku, v tomto bodě pouze požadavky na trigger HTTP probudí vaši aplikaci funkcí. Abyste měli jistotu, že vaše funkce, které nejsou spuštěny prostřednictvím HTTP, včetně funkcí spuštěných časovačem, správně běží, povolte ve funkci aplikace možnost Always On nastavením alwaysOn v nastavení webu na hodnotu true.

funkceRuntimeAdminOdděleníPovoleno

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 nelze nastavit pro aplikace spuštěné na SKU pro spotřebu pro Linux a také ji nelze nastavit pro aplikace spuštěné na verzi 1.x 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 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á budete muset nastavit šablony pro nasazení ARM a Bicep v některý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í obraz

Při vytváření a údržbě vlastního linuxového kontejneru pro vaši funkční aplikaci linuxFxVersion je hodnota místo toho ve formátu DOCKER|<IMAGE_URI>, jak ukazuje následující příklad:

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

Označuje zdroj registru nasazeného kontejneru. Další informace najdete v tématu Práce s kontejnery a Azure Functions.

Důležité

Při vytváření vlastních kontejnerů musíte zachovat základní image kontejneru aktualizovanou na nejnovější podporovanou základní image. Podporované základní image pro Azure Functions jsou specifické pro jazyk a nacházejí se v úložištích základních imagí Azure Functions.

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

verze Net Frameworku

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.

vnetObsahSdíleníPovoleno

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ší funkční aplikací a sdílením obsahu přes virtuální síť, musíte také nastavit vnetContentShareEnabled na true. Povolení této vlastnosti webu je požadavkem při omezení účtu úložiště na virtuální síť v plánech Elastic Premium a dedikovaného hostingu.

Poznámka:

Při směrování do sdílené složky obsahu v účtu úložiště sdíleném více aplikacemi funkcí ve stejném plánu musíte věnovat zvláštní pozornost. Další informace najdete v tématu Konzistentní směrování prostřednictvím virtuálních sítí v článku Důležité informace o úložišti.

Tato vlastnost webu nahrazuje starší WEBSITE_CONTENTOVERVNET nastavení.

vnetImagePullEnabled

Functions podporuje aplikace funkcí spuštěné v kontejnerech Linuxu. Pokud se chcete připojit a načíst z registru kontejneru uvnitř virtuální sítě, musíte nastavit vnetImagePullEnabled hodnotu true. Tato vlastnost webu je podporována v plánech Elastic Premium a Dedicated hosting. Plán Flex Consumption se při konfiguraci sítí nespoléhá na vlastnosti webu ani nastavení aplikace. Další informace najdete v tématu Zastarání plánu Flex Consumption.

vnetRouteAllPovoleno

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 .

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

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 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é virtuální sítě 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á 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ý 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é

Další kroky

Zjistěte, jak aktualizovat nastavení aplikace.

Zobrazení nastavení konfigurace v souboru host.json

Zobrazení dalších nastavení aplikací pro aplikace App Service