Sdílet prostřednictvím


Referenční materiály k nastavení aplikací pro Azure Functions

Nastavení aplikace v aplikaci funkcí obsahují možnosti konfigurace, které ovlivňují všechny funkce pro danou aplikaci funkcí. K těmto nastavením se přistupuje jako k proměnným prostředí. Tento článek obsahuje seznam nastavení aplikace, která jsou k dispozici v aplikacích funkcí.

Nastavení aplikace funkcí můžete přidat, aktualizovat a odstranit několika způsoby:

Změny nastavení aplikace funkcí vyžadují restartování aplikace funkcí.

V tomto článku jsou hodnoty připojovacího řetězce zkráceny kvůli lepší čitelnosti.

Azure Functions používá k hostování platformu Azure App Service. Některá nastavení relevantní pro hostování aplikace funkcí můžete najít v proměnných prostředí a nastavení aplikace ve službě Azure App Service.

Důležité informace o nastavení aplikace

Při používání nastavení aplikace byste měli vědět o následujících aspektech:

  • Změna nastavení aplikace způsobí, že se vaše funkční aplikace ve výchozím nastavení restartuje napříč všemi plány hostování. Pro nasazení s nulovým výpadkem při změně nastavení použijte plán Flex Consumption s kumulativními aktualizacemi jako strategii aktualizace lokality. Další plány hostování najdete v tématu Optimalizace nasazení s pokyny k minimalizaci výpadků .

  • Dvojité podtržítko (__) a dvojtečka (:) se považují za rezervované hodnoty v názvech nastavení. Dvojitá podtržítka se interpretují jako hierarchické oddělovače v systémech Windows i Linux. Dvojtečky se interpretují stejným způsobem pouze v systému Windows. Nastavení AzureFunctionsWebHost__hostid=somehost_123456 by se například interpretovalo jako následující objekt JSON:

    "AzureFunctionsWebHost": {
        "hostid": "somehost_123456"
    }
    

    V tomto článku se používají pouze dvojitá podtržítka, protože jsou podporovány v obou operačních systémech. Většina nastavení, která podporují připojení spravovaných identit, používají dvojité podtržítka.

  • Při místním spuštění funkcí se nastavení aplikace zadává v Values kolekci v local.settings.json.

  • V souboru host.json a v souboru local.settings.json existují další možnosti 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. Tento přístup je užitečný pro scénáře, ve kterých potřebujete nakonfigurovat nebo upravit konkrétní nastavení host.json pro konkrétní prostředí. Tento přístup také umožňuje změnit nastavení host.json, aniž byste museli 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

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.

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

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

APPLICATIONINSIGHTS_AUTHENTICATION_STRING

Umožňuje 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
System-assigned Authorization=AAD
User-assigned Authorization=AAD;ClientId=<USER_ASSIGNED_CLIENT_ID>

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

Note

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

APPLICATIONINSIGHTS_CONNECTION_STRING

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

  • Když vaše aplikace funkcí vyžaduje 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.

Key Ukázková hodnota
APPLICATIONINSIGHTS_CONNECTION_STRING InstrumentationKey=...

Pokud se chcete připojit k Application Insights pomocí ověřování Microsoft Entra, měli byste použít APPLICATIONINSIGHTS_AUTHENTICATION_STRING.

AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL

Important

Proxy služby Azure Functions byly funkce verzí 1.x až 3.x modulu runtime Azure Functions. Další informace naleznete v tématu funkce proxy.

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES

Important

Proxy služby Azure Functions byly funkce verzí 1.x až 3.x modulu runtime Azure Functions. Další informace naleznete v tématu funkce proxy.

AZURE_FUNCTIONS_ENVIRONMENT

Nakonfiguruje hostitelské prostředí runtime aplikace funkcí, když běží v Azure. Tato hodnota se čte během inicializace. Modul runtime přijímá pouze tyto hodnoty:

Value Description
Production Představuje produkční prostředí se sníženou úrovní protokolování a úplnou optimalizací výkonu. Tato hodnota je výchozí, pokud AZURE_FUNCTIONS_ENVIRONMENT není nastavená nebo je nastavená na nepodporovanou hodnotu.
Staging Představuje přípravné prostředí, například při spuštění v přípravném slotu.
Development Vývojové prostředí podporuje podrobnější protokolování a další optimalizace s nižším výkonem. 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í jenom malá písmena, číslice a pomlčky.
  • Nesmí začínat ani končit pomlčkou
  • Nesmí obsahovat po sobě jdoucí pomlčky.

Snadným způsobem, jak vygenerovat ID, je vzít identifikátor GUID, odebrat pomlčky a nastavit ho jako malá písmena, například převedením identifikátoru GUID 1835D7B5-5C98-4790-815D-072CC94C6F71 na hodnotu 1835d7b55c984790815d072cc94c6f71.

Key Ukázková hodnota
AzureFunctionsWebHost__hostid myuniquefunctionappname123456789

Další informace najdete v tématu 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ý připojovací řetězec účtu úložiště pro ukládání protokolů a jejich zobrazení na kartě Monitorování na webu Azure Portal. Úč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ě.

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

AzureWebJobsDisableHomepage

Hodnota true zakáže výchozí cílovou stránku, která se zobrazí pro kořenovou adresu URL aplikace funkcí. Výchozí hodnota je false.

Key Ukázková hodnota
AzureWebJobsDisableHomepage true

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

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

AzureWebJobsDotNetReleaseCompilation

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

Key Ukázková hodnota
AzureWebJobsDotNetReleaseCompilation true

AzureWebJobsFeatureFlags

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

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

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

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

Hodnota příznaku Description
EnableProxies Opětovné povolení proxy serverů ve verzi 4.x modulu runtime Functions při plánování migrace 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.

Key Ukázková hodnota
AzureWebJobsKubernetesSecretName <SECRETS_RESOURCE>

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

  • Musíte také nastavit AzureWebJobsSecretStorageType na kubernetes. Pokud AzureWebJobsKubernetesSecretName není nastavené, úložiště se považuje za jen pro čtení. V takovém případě musí být hodnoty generovány před nasazením.
  • Nástroje Azure Functions Core Tools 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.

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

Key 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. Nastavení musí být v souborulocal.settings.json.

Key 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íčů.

Key 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 nastavení doporučujeme 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.

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

Important

Tajnosti nejsou omezeny na jednotlivé funkční aplikace prostřednictvím nastavení AzureWebJobsSecretStorageKeyVaultUri. Pokud je 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 nezamýšleným chováním, 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íčů.

Key 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 Value Description
AzureWebJobsSecretStorageType 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ě.
AzureWebJobsSecretStorageType files Klíče jsou trvalé v systému souborů. Toto chování je výchozí 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ž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ě.

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

Key Ukázková hodnota
AzureWebJobsStorage__accountName <STORAGE_ACCOUNT_NAME>

Pro suverénní cloudy nebo při použití vlastního DNS musíte místo toho použít nastavení specifická pro AzureWebJobsStorage__*ServiceUri službu.

AzureWebJobsStorage__blobServiceUri

Při použití připojení k úložišti založeného na identitě nastaví URI datové roviny služby blob účtu úložiště.

Key Ukázková hodnota
AzureWebJobsStorage__blobServiceUri https://<STORAGE_ACCOUNT_NAME>.blob.core.windows.net

Toto nastavení použijte místo AzureWebJobsStorage__accountName v suverénních cloudech nebo při použití vlastního DNS. Další informace najdete v části Připojení k hostitelskému úložišti s využitím identity.

AzureWebJobsStorage__clientId

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

AzureWebJobsStorage__credential

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

AzureWebJobsStorage__managedIdentityResourceId

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

AzureWebJobsStorage__queueServiceUri

Při použití úložišťového připojení založeného na identitě nastaví URI datové roviny služby fronty úložišťového účtu.

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

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

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

Key Ukázková hodnota
DOCKER_SHM_SIZE 268435456

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

Vyžaduje, aby FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED byla nastavena na 1.

ENABLE_ORYX_BUILD

Určuje, 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í.

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

Key Ukázková hodnota
FUNCTION_APP_EDIT_MODE readonly

Modul runtime nastaví hodnotu na základě zásobníku jazyka a stavu nasazení vaší aplikace funkcí. Další informace najdete v tématu Omezení vývoje na webu Azure Portal.

FUNCTIONS_EXTENSION_VERSION

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

Key Ukázková hodnota
FUNCTIONS_EXTENSION_VERSION ~4

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

Value Cíl běhového prostředí Comment
~4 4.x Recommended
~1 1.x Podpora končí 14. září 2026

Hodnota ~4 znamená, že vaše aplikace běží na verzi 4.x modulu runtime. Hodnota ~1 připne vaši aplikaci na verzi 1.x běhového prostředí. Verze modulu runtime 2.x a 3.x se už nepodporují. Další informace najdete v přehledu verzí modulu runtime Azure Functions.

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

Key Ukázková hodnota
FUNCTIONS_INPROC_NET8_ENABLED 1

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

FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR

Toto nastavení aplikace představuje dočasný způsob, jak Node.js aplikacím povolit zásadní změnu, která usnadňuje řešení chyb vstupních bodů při řešení potíží s Node.js v18 nebo nižším. Důrazně doporučujeme používat true, zejména pro programovací aplikace modelu v4, které vždy používají soubory vstupních bodů. Chování bez zásadní změny (false) ignoruje chyby na vstupním bodu a nezaznamenává je v Application Insights.

Počínaje Node.js v20 nemá nastavení aplikace žádný vliv a chování způsobující změnu je vždy povolené.

Pro Node.js v18 nebo nižší se použije nastavení aplikace a výchozí chování závisí na tom, jestli k chybě dojde před nebo po registraci funkce modelu v4:

  • Pokud je chyba vyvolána předtím, výchozí chování odpovídá false. Pokud například používáte model v3 nebo soubor vstupního bodu neexistuje.
  • Pokud je chyba vyvolána poté, výchozí chování odpovídá true. Pokud se například pokusíte zaregistrovat duplicitní funkce modelu v4.
Key Value Description
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR true Zablokujte chyby vstupního bodu a protokolujte je v Application Insights.
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR false Chyby vstupního bodu ignorujte a nepřihlašujte je do Application Insights.

FUNCTIONS_REQUEST_BODY_SIZE_LIMIT

Přepíše výchozí limit velikosti textu požadavků odesílaných do koncových bodů HTTP. Hodnota je uvedena v bajtech s výchozí maximální velikostí požadavku 104 857 600 bajtů.

Key Ukázková hodnota
FUNCTIONS_REQUEST_BODY_SIZE_LIMIT 250000000

FUNCTIONS_V2_COMPATIBILITY_MODE

Important

Toto nastavení se už nepodporuje. Původně byla poskytována pro umožnění krátkodobého alternativního řešení pro aplikace, které cílí na běhové prostředí v2.x. Místo toho by mohli běžet v modulu runtime v3.x, i když byl stále podporovaný. S výjimkou starších aplikací, které běží na verzi 1.x, musí všechny aplikace funkcí běžet ve verzi 4.x modulu runtime Functions: FUNCTIONS_EXTENSION_VERSION=~4. Další informace najdete v přehledu verzí modulu runtime Azure Functions.

FUNCTIONS_WORKER_PROCESS_COUNT

Určuje maximální počet jazykových pracovních procesů s výchozí hodnotou 1. Maximální povolená hodnota je 10. Volání funkcí se rovnoměrně rozdělují mezi procesy jazykových pracovníků. Procesy jazykového pracovního se vytvoří každých 10 sekund, dokud není dosažen počet určený FUNCTIONS_WORKER_PROCESS_COUNT. Použití více jazykových pracovních procesů není stejné jako škálování. Toto nastavení zvažte, pokud má vaše úloha kombinaci volání vázaného na procesor a vstupně-výstupní operace. Toto nastavení platí pro všechny jazykové moduly runtime, s výjimkou rozhraní .NET spuštěného v procesu (FUNCTIONS_WORKER_RUNTIME=dotnet).

Key Ukázková hodnota
FUNCTIONS_WORKER_PROCESS_COUNT 2

FUNCTIONS_WORKER_RUNTIME

Jazyk nebo zásobník jazyka modulu runtime pracovního procesu, který se má načíst v aplikaci funkcí. Tato hodnota odpovídá jazyku používanému v aplikaci, pythonnapříklad . Počínaje modulem runtime Azure Functions verze 2.x může daná aplikace funkcí podporovat pouze jeden jazyk.

Key Ukázková hodnota
FUNCTIONS_WORKER_RUNTIME node

Platné hodnoty:

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

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

Key Ukázková hodnota
FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED 1

Pokud je toto nastavení povolené, můžete pomocí nastavení DOCKER_SHM_SIZE nastavit velikost sdílené paměti. Další informace najdete v tématu Sdílená paměť.

JAVA_APPLICATIONINSIGHTS_ENABLE_TELEMETRY

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

JAVA_ENABLE_SDK_TYPES

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

Note

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

Key Ukázková hodnota
JAVA_ENABLE_SDK_TYPES true

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

JAVA_OPTS

Používá se k přizpůsobení virtuálního počítače Java (JVM) používaného ke spouštění funkcí Javy při spuštění v plánu Premium nebo plánu Dedicated. Při spuštění v plánu spotřeby místo toho použijte languageWorkers__java__arguments. Další informace naleznete v tématu Přizpůsobení prostředí JVM.

languageWorkers__java__arguments

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

Ří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 Gallery při spuštění procesu a poté každých MDMaxBackgroundUpgradePeriod. 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, včetně vstupně-výstupních operací sítě, procesoru a ú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.

Key Ukázková hodnota
MDMaxBackgroundUpgradePeriod 7.00:00:00

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

MDNewSnapshotCheckPeriod

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

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

V rámci každého MDNewSnapshotCheckPeriod pracovní proces PowerShell zkontroluje, zda jsou upgrady spravovaných závislostí nainstalovány. Po instalaci upgradů se zahájí restartování. Zvýšení této hodnoty snižuje četnost přerušení kvůli restartováním. Zvýšení však může také zvýšit dobu, během které mohou vyvolání funkcí používat staré nebo nové verze modulu, nedeterministicky.

Key Ukázková hodnota
MDNewSnapshotCheckPeriod 01:00:00

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

MDMinBackgroundUpgradePeriod

Časové období po předchozí kontrole upgradu spravované závislosti před spuštěním jiné kontroly upgradu s výchozím nastavením 1.00:00:00 (denně).

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

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

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

OTEL_EXPORTER_OTLP_ENDPOINT

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

OTEL_EXPORTER_OTLP_HEADERS

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

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.

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

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

PROJECT

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.

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

PYTHON_APPLICATIONINSIGHTS_ENABLE_TELEMETRY

Určuje, jestli má pracovní proces Pythonu výstupní telemetrii ve formátu Open Telemetry do koncového bodu Application Insights. Nastavením tohoto příznaku True dejte hostiteli functions pokyn, aby pracovní proces Pythonu exportuje data OpenTelemetry do koncového bodu Application Insights. Další informace naleznete v tématu Konfigurace nastavení aplikace.

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 Value Description
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, které nejsou 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. Tato hodnota brání tomu, aby vaše knihovny kolidovaly s interními knihovnami Pythonovského pracovníka.

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_OPENTELEMETRY

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

PYTHON_ENABLE_WORKER_EXTENSIONS

Konfigurace je specifická pro aplikace funkcí Pythonu. Nastavením této hodnoty umožníte 1 pracovníkovi načíst Python worker extensions definované v requirements.txt. Umožňuje vaší aplikaci funkcí přístup k novým funkcím poskytovaným partnerskými balíčky. Může také změnit chování načítání a vyvolání funkcí ve vaší aplikaci. Ujistěte se, že zvolené rozšíření je důvěryhodné, protože nesete riziko jeho používání. Azure Functions neposkytuje žádné výslovné záruky 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 Value Description
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 spuštění vyvolání funkcí, s výchozí hodnotou 1 pro verzi 3.8 Pythonu a níže. Pro verzi 3.9 Pythonu a vyšší je hodnota nastavená na None. Toto nastavení nezaručuje počet vláken, která by byla nastavena během provádění. Nastavení umožňuje 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.

Key Ukázková hodnota Maximální hodnota
PYTHON_THREADPOOL_THREAD_COUNT 2 32

SCALE_CONTROLLER_LOGGING_ENABLED

Toto nastavení je aktuálně ve verzi Preview.

Toto nastavení řídí protokolování z kontroleru škálování služby Azure Functions. Další informace naleznete v tématu Protokoly kontroleru škálování.

Key Ukázková hodnota
SCALE_CONTROLLER_LOGGING_ENABLED AppInsights:Verbose

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

Property Description
<DESTINATION> Cíl, do kterého se protokoly odesílají. Platné hodnoty jsou AppInsights a Blob.
Při použití AppInsights se ujistěte, že ve vaší funkční aplikaci je povolena služba Application Insights.
Když nastavíte cíl na Blob, protokoly se vytvoří v kontejneru 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í.

Tip

Mějte na paměti, že když necháte protokolování řadiče škálování povolené, ovlivňuje to potenciální náklady na monitorování funkční aplikace. Zvažte povolení protokolování, dokud neshromáždíte dostatek dat, abyste pochopili, jak se řadič škálování chová, a pak ho zakazujte.

SCM_DO_BUILD_DURING_DEPLOYMENT

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

Key Ukázková hodnota
SCM_DO_BUILD_DURING_DEPLOYMENT true

SCM_LOGSTREAM_TIMEOUT

Řídí časový limit v sekundách při připojení k protokolům streamování. Výchozí hodnota je 7200 (2 hodiny).

Key Ukázková hodnota
SCM_LOGSTREAM_TIMEOUT 1800

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

WEBSITE_CONTENTAZUREFILECONNECTIONSTRING

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

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

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

Plán Flex Consumption je teď doporučeným plánem hostování bez serveru pro Azure Functions. Nabízí rychlejší škálování, snížení studeného startu, privátní sítě a větší kontrolu nad výkonem a náklady. Další informace najdete v tématu Plán Flex Consumption.

Změna nebo odebrání tohoto nastavení může způsobit, že se vaše aplikace funkcí nespustí. Další informace najdete v 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

Important

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

Hodnota 1 umožňuje vaší aplikaci funkcí škálovat napříč instancemi, když je váš účet úložiště připojený k virtuální síti. 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íť.

Key Ukázková hodnota
WEBSITE_CONTENTOVERVNET 1

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

Note

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

WEBSITE_CONTENTSHARE

Název sdílené složky, kterou functions používá k ukládání kódu aplikace funkcí a konfiguračních souborů. Tento obsah vyžadují plány škálování řízené událostmi. Používá se s WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. Výchozí hodnota je ř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ě.

Key Ukázková hodnota
WEBSITE_CONTENTSHARE functionapp091999e2

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

Plán Flex Consumption je teď doporučeným plánem hostování bez serveru pro Azure Functions. Nabízí rychlejší škálování, snížení studeného startu, privátní sítě a větší kontrolu nad výkonem a náklady. Další informace najdete v tématu Plán Flex Consumption.

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í. Pro účet úložiště zabezpečený 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.

Key Ukázková hodnota
WEBSITE_DNS_SERVER 168.63.129.16

WEBSITE_ENABLE_BROTLI_ENCODING

Určuje, zda je kódování Brotli použito pro kompresi místo výchozí komprese gzip. Pokud WEBSITE_ENABLE_BROTLI_ENCODING je nastavena na 1, Použije se kódování Brotli. V opačném případě se použije kódování gzip.

WEBSITE_FUNCTIONS_ARMCACHE_ENABLED

Zakáže ukládání do mezipaměti při nasazování aplikací funkcí pomocí šablon Azure Resource Manageru (ARM).

Key Ukázková hodnota
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED 0

WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT

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

Important

Toto nastavení je ve verzi Preview. Vlastnost aplikace pro maximální kapacitu funkce teď existuje. Doporučujeme tuto vlastnost pro omezení horizontálního škálování.

Key Ukázková hodnota
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT 5

WEBSITE_NODE_DEFAULT_VERSION

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.

Key Ukázková hodnota
WEBSITE_NODE_DEFAULT_VERSION ~18

WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS

Když provedete prohození slotů pro aplikaci funkcí spuštěnou v plánu Premium, může prohození selhat, když má vyhrazený účet úložiště používaný aplikací omezený přístup k síti. Příčinou tohoto selhání je starší funkce protokolování aplikace, která sdílí služby Functions i App Service. Toto nastavení přepíše funkci staršího protokolování a umožňuje výměnu.

Key Ukázková hodnota
WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS 0

Přidejte WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS s hodnotou 0 do všech slotů, abyste měli jistotu, že starší nastavení diagnostiky nezablokuje vaše výměny. Toto nastavení a hodnotu můžete také přidat pouze do produkčního slotu jako nastavení pro nasazovací slot (sticky).

WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS

Ve výchozím nastavení jsou nastavení verzí pro aplikace funkcí specifické pro každý slot. Toto nastavení se používá při upgradu funkcí pomocí nasazení slotů. Tento přístup zabrání neočekávanému chování způsobenému změnami verzí po výměně. Nastavte hodnotu na 0 v provozním prostředí a ve slotu, abyste se ujistili, že se prohodí také všechna nastavení verzí. Další informace najdete v tématu Upgrade pomocí slotů.

Key Ukázková hodnota
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS 0

WEBSITE_RUN_FROM_PACKAGE

Umožňuje aplikaci funkcí spouštět ze souboru balíčku, který je možné místně připojit nebo nasadit na externí adresu URL.

Key Ukázková hodnota
WEBSITE_RUN_FROM_PACKAGE 1

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

Při použití WEBSITE_RUN_FROM_PACKAGE=<URL>se adresa URL musí přeložit na umístění souboru balíčku v přístupném umístění úložiště, jako je kontejner služby Azure Blob Storage. Kontejner musí být soukromý, aby se zabránilo neoprávněnému přístupu, což vyžaduje použití sdíleného přístupového podpisu (SAS) v adrese URL nebo ověřování Microsoft Entra ID pro povolení přístupu. Doporučuje se používat ID Microsoft Entra se spravovanými identitami.

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

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

Když nasadíte balíček ze služby Azure Blob Storage pomocí spravované identity přiřazené uživatelem, musíte také nastavit WEBSITE_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID ID prostředku spravované identity přiřazené uživatelem. Při nasazování z adresy URL externího balíčku musíte také ručně synchronizovat triggery. Další informace najdete v tématu Aktivace synchronizace.

WEBSITE_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID

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

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

WEBSITE_SKIP_CONTENTSHARE_VALIDATION

Nastavení WEBSITE_CONTENTAZUREFILECONNECTIONSTRING a WEBSITE_CONTENTSHARE mají další kontroly ověření, aby se zajistilo, že je možné aplikaci správně spustit. Vytvoření nastavení aplikace selže, když 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. Při nastavení proměnné WEBSITE_SKIP_CONTENTSHARE_VALIDATION na 1 se kontrola ověření přeskočí. V opačném případě se hodnota nastaví 0 na výchozí hodnotu a provede se ověření.

Key Ukázková hodnota
WEBSITE_SKIP_CONTENTSHARE_VALIDATION 1

Pokud se ověření přeskočí a připojovací řetězec nebo sdílená složka obsahu nejsou platné, aplikace se nemůže 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

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

Key Ukázková hodnota
WEBSITE_SLOT_NAME Production

WEBSITE_TIME_ZONE

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

Key OS Ukázková hodnota
WEBSITE_TIME_ZONE Windows Eastern Standard Time
WEBSITE_TIME_ZONE Linux America/New_York

Výchozím časovým pásmem používaným pro výrazy CRON je koordinovaný univerzální čas (UTC). Pokud chcete, aby byl výraz CRON založený na jiném časovém pásmu, vytvořte nastavení aplikace pro aplikaci funkcí s názvem WEBSITE_TIME_ZONE.

Hodnota tohoto nastavení závisí na operačním systému a plánu, ve kterém příslušná aplikace funkcí běží.

Operační systém Plan Value
Windows All Nastavte hodnotu na název požadovaného časového pásma, jak je uvedeno ve druhém řádku každé dvojice, kterou poskytuje příkaz Windows tzutil.exe /L.
Linux Premium
Dedicated
Nastavte hodnotu na název požadovaného časového pásma, jak je znázorněno v databázi tz.

Note

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

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

"0 0 10 * * *"

Při použití WEBSITE_TIME_ZONEse čas upraví pro změny času v konkrétním časovém pásmu, včetně letního času a změn ve standardním čase.

WEBSITE_USE_PLACEHOLDER

Určuje, zda se má při běhu na Plánu spotřeby použít určitá optimalizace studeného startu. Nastavte na hodnotu 0, abyste zakázali optimalizaci studeného startu v plánu Consumption.

Key Ukázková hodnota
WEBSITE_USE_PLACEHOLDER 1

WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED

Určuje, 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.

Key Ukázková hodnota
WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED 1

WEBSITE_VNET_ROUTE_ALL

Important

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

Určuje, jestli se veškerý odchozí provoz z aplikace směruje přes virtuální síť. Hodnota 1 nastavení označuje, že veškerý provoz aplikace je směrován přes virtuální síť. Toto nastavení potřebujete při konfiguraci integrace místní virtuální sítě v plánech elastického 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ě.

Key Ukázková hodnota
WEBSITE_VNET_ROUTE_ALL 1

WEBSITES_ENABLE_APP_SERVICE_STORAGE

Určuje, zda /home je adresář sdílen napříč škálovanými instancemi s výchozí hodnotou true. Tuto hodnotu byste měli nastavit na false při nasazování funkční aplikace v kontejneru.

Nastavení webu 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 webu Azure Portal 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 true vyžaduje, abyste použili spravovanou identitu. Tento přístup doporučujeme použít u uložených přihlašovacích údajů pro ověřování jako osvědčený postup zabezpečení.

AcrUserManagedIdentityID

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

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

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

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.

functionsRuntimeAdminIsolationEnabled

Určuje, jestli je možné získat přístup k integrovaným koncovým bodům správce (/admin) ve vaší aplikaci funkcí. Když je tato možnost nastavená na false (výchozí), aplikace povolí požadavky na koncové body pod /admin, když tyto požadavky obsahují hlavní klíč. Když true nelze přistoupit ke koncovým bodům /admin, dokonce ani s hlavním klíčem.

Tuto vlastnost nejde nastavit pro aplikace běžící v Linuxu v plánu Consumption. Nedá se 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.

Plán Flex Consumption je teď doporučeným plánem hostování bez serveru pro Azure Functions. Nabízí rychlejší škálování, snížení studeného startu, privátní sítě a větší kontrolu nad výkonem a náklady. Další informace najdete v tématu Plán Flex Consumption.

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

Při vytváření a údržbě vlastního linuxového kontejneru pro vaši linuxFxVersion aplikaci Function je hodnota v tomto případě ve formátu DOCKER|<IMAGE_URI>, jak je znázorněno v následujícím příkladu:

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

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

Important

Když vytváříte vlastní kontejnery, musíte zachovat základní image kontejneru aktualizovanou na nejnovější podporovanou základní image. Podporované základní image pro Azure Functions jsou specifické pro jazyk. Podívejte se na úložiště 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ů.

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ší funkční aplikací a sdílením obsahu přes virtuální síť, musíte také nastavit vnetContentShareEnabled na true. Povolení této vlastnosti stránky je vyžadováno pro škálování napříč datovými centry při omezení účtu úložiště na virtuální síť v elastických a dedikovaných hostingových plánech úrovně Premium. Bez tohoto nastavení může aplikace funkcí škálovat pouze v rámci jednoho razítka (přibližně 1–20 instancí).

Note

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.

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 .

Zrušení podpory plánu Flex Consumption

V plánu Flex Consumption jsou tyto vlastnosti webu a nastavení aplikace zastaralé a neměly by se používat při vytváření prostředků aplikace funkcí:

Setting/property Reason
ENABLE_ORYX_BUILD Nahrazení parametrem remoteBuild při nasazování ve flex Consumption
FUNCTIONS_EXTENSION_VERSION Nastavení aplikace je nastaveno back-endem. Hodnotu ~1 je možné ignorovat.
FUNCTIONS_WORKER_RUNTIME Nahrazeno v nameproperties.functionAppConfig.runtime
FUNCTIONS_WORKER_RUNTIME_VERSION Nahrazeno v versionproperties.functionAppConfig.runtime
FUNCTIONS_MAX_HTTP_CONCURRENCY Nahrazeno sekcí aktivace škálování a souběžnosti
FUNCTIONS_WORKER_PROCESS_COUNT Nastavení není platné.
FUNCTIONS_WORKER_DYNAMIC_CONCURRENCY_ENABLED Nastavení není platné.
SCM_DO_BUILD_DURING_DEPLOYMENT Nahrazení parametrem remoteBuild při nasazování ve flex Consumption
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING Nahrazeno nasazovací sekcí v konfiguraci funkční aplikace functionAppConfig.
WEBSITE_CONTENTOVERVNET Nepoužívá se pro sítě ve službě Flex Consumption
WEBSITE_CONTENTSHARE Nahrazeno nasazovací sekcí v konfiguraci funkční aplikace functionAppConfig.
WEBSITE_DNS_SERVER DNS se dědí z integrované 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í obsahu se nepoužívá ve Flex Consumption
WEBSITE_VNET_ROUTE_ALL Nepoužívá se pro sítě ve službě Flex Consumption
properties.alwaysOn Neplatné
properties.containerSize Přejmenováno jako instanceMemoryMB
properties.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é