Azure İşlevleri için uygulama ayarları başvurusu

Makale
02/19/2024

İşlev uygulamasındaki uygulama ayarları, bu işlev uygulamasının tüm işlevlerini etkileyen yapılandırma seçeneklerini içerir. Bu ayarlara ortam değişkeni olarak erişilir. Bu makalede, işlev uygulamalarında kullanılabilen uygulama ayarları listelenir.

İşlev uygulaması ayarlarını eklemenin, güncelleştirmenin ve silmenin birkaç yolu vardır:

İşlev uygulaması ayarlarında yapılan değişiklikler, işlev uygulamanızın yeniden başlatılmasını gerektirir.

Bu makalede, okunabilirlik için örnek bağlantı dizesi değerleri kesilir.

Uygulama ayarında dikkat edilmesi gerekenler

Uygulama ayarlarını kullanırken aşağıdaki noktalara dikkat etmeniz gerekir:

İşlev uygulaması ayarlarında yapılan değişiklikler, işlev uygulamanızın yeniden başlatılmasını gerektirir.
Adları ayarlarken, çift alt çizgi (__) ve noktalı virgül (:) ayrılmış değerler olarak kabul edilir. Çift alt çizgi, hem Windows hem de Linux'ta hiyerarşik sınırlayıcılar olarak yorumlanır ve iki nokta üst üste aynı şekilde yalnızca Linux'ta yorumlanır. Örneğin, ayar AzureFunctionsWebHost__hostid=somehost_123456 aşağıdaki JSON nesnesi olarak yorumlanır:
```
"AzureFunctionsWebHost": {
    "hostid": "somehost_123456"
}
```
Bu makalede, her iki işletim sisteminde de desteklendiği için yalnızca çift alt çizgi kullanılır. Yönetilen kimlik bağlantılarını destekleyen ayarların çoğu çift alt çizgi kullanır.
İşlevler yerel olarak çalıştırıldığında, uygulama ayarları local.settings.json koleksiyonda Valuesbelirtilir.
host.json dosyasında ve local.settings.json dosyasında başka işlev uygulaması yapılandırma seçenekleri vardır.
host.json dosyasının kendisini değiştirmek zorunda kalmadan host.json ayar değerlerini geçersiz kılmak için uygulama ayarlarını kullanabilirsiniz. Bu, belirli bir ortam için belirli host.json ayarlarını yapılandırmanız veya değiştirmeniz gereken senaryolar için yararlıdır. Bu, projenizi yeniden yayımlamak zorunda kalmadan host.json ayarlarını değiştirmenize de olanak tanır. Daha fazla bilgi edinmek için host.json başvuru makalesine bakın.
Bu makalede, işlev uygulamalarınızla en ilgili ayarlar belgelenir. Azure İşlevleri App Service üzerinde çalıştığından, diğer uygulama ayarları da desteklenir. Daha fazla bilgi için bkz. Azure Uygulaması Hizmeti'nde ortam değişkenleri ve uygulama ayarları.
Bazı senaryolar, App Service site ayarlarında belgelenen ayarlarla çalışmanızı da gerektirir.
Salt okunurApp Service uygulama ayarlarını değiştirmek, işlev uygulamanızı yanıt vermemeye başlayabilir.
ARM şablonları da dahil olmak üzere REST API'lerini kullanarak uygulama ayarlarını güncelleştirirken dikkatli olun. Bu API'ler mevcut uygulama ayarlarını değiştirdiğinden, REST API'lerini veya ARM şablonlarını kullanarak ayarları eklerken veya değiştirirken mevcut tüm ayarları eklemeniz gerekir. Mümkün olduğunda uygulama ayarlarıyla program aracılığıyla çalışmak için Azure CLI veya Azure PowerShell kullanın. Daha fazla bilgi için bkz . Uygulama ayarlarıyla çalışma.

APPINSIGHTS_INSTRUMENTATIONKEY

Uygulama Analizler için izleme anahtarı. hem APPLICATIONINSIGHTS_CONNECTION_STRINGhem de APPINSIGHTS_INSTRUMENTATIONKEY kullanmayın. Mümkün olduğunda kullanın APPLICATIONINSIGHTS_CONNECTION_STRING. Application Analizler bağımsız bir bulutta çalıştığında kullanmanız APPLICATIONINSIGHTS_CONNECTION_STRINGgerekir. Daha fazla bilgi için bkz. Azure İşlevleri için izlemeyi yapılandırma.

Anahtar	Örnek değer
APPINSIGHTS_INSTRUMENTATIONKEY	`55555555-af77-484b-9032-64f83bb83bb`

hem APPLICATIONINSIGHTS_CONNECTION_STRINGhem de APPINSIGHTS_INSTRUMENTATIONKEY kullanmayın. APPLICATIONINSIGHTS_CONNECTION_STRING kullanılması önerilir.

Not

31 Mart 2025’te izleme anahtarı alımı desteği sona erecektir. İzleme anahtarı alımı çalışmaya devam edecek, ancak artık özellik için güncelleştirme veya destek sağlamayacağız. Yeni özelliklerden yararlanmak için bağlantı dizesi geçiş.

APPLICATIONINSIGHTS_CONNECTION_STRING

Uygulama Analizler için bağlantı dizesi. hem APPLICATIONINSIGHTS_CONNECTION_STRINGhem de APPINSIGHTS_INSTRUMENTATIONKEY kullanmayın. kullanımı APPLICATIONINSIGHTS_CONNECTION_STRING her durumda önerilir ancak aşağıdaki durumlarda gereklidir:

İşlev uygulamanız bağlantı dizesi kullanılarak desteklenen ek özelleştirmeleri gerektirdiğinde.
Application Analizler örneğiniz özel uç nokta gerektiren bağımsız bir bulutta çalıştığında.

Daha fazla bilgi için bkz. Bağlan ion dizeleri.

Anahtar	Örnek değer
APPLICATIONINSIGHTS_CONNECTION_STRING	`InstrumentationKey=...`

AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL

Önemli

Azure İşlevleri proxy'ler, Azure İşlevleri çalışma zamanının 1.x ile 3.x sürümleri için eski bir özelliktir. 4.x sürümündeki eski destek hakkında daha fazla bilgi için bkz . İşlev proxy'leri.

İşlev proxy'leri varsayılan olarak, proxy'lerden api çağrılarını doğrudan aynı işlev uygulamasındaki işlevlere göndermek için bir kısayol kullanır. Bu kısayol, yeni bir HTTP isteği oluşturmak yerine kullanılır. Bu ayar, bu kısayol davranışını devre dışı bırakmanızı sağlar.

Anahtar	Value	Açıklama
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL	`true`	Yerel işlev uygulamasındaki bir işleve işaret eden arka uç URL'si olan çağrılar doğrudan işleve gönderilmez. Bunun yerine, istekler işlev uygulamasının HTTP ön ucuna yönlendirilir.
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL	`false`	Yerel işlev uygulamasındaki bir işleve işaret eden arka uç URL'si olan çağrılar doğrudan işleve iletilir. `false` varsayılan değerdir.

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES

Önemli

Bu ayar, karakterlerin %2F arka uç URL'sine eklendiğinde yol parametrelerinde eğik çizgi olarak kodlanıp çözülmeyeceğini denetler.

Anahtar	Value	Açıklama
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES	`true`	Kodlanmış eğik çizgili yol parametrelerinin kodu çözülmektedir.
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES	`false`	Tüm yol parametreleri değiştirilmeden geçirilir ve bu varsayılan davranıştır.

Örneğin, etki alanındaki bir işlev uygulamasının myfunction.com proxies.json dosyasını göz önünde bulundurun.

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

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES olarak ayarlandığında trueURL example.com/api%2ftest olarak çözümleniyorexample.com/api/test. Varsayılan olarak, URL olarak değişmeden example.com/test%2fapikalır. Daha fazla bilgi için bkz . İşlev proxy'leri.

AZURE_FUNCTIONS_ENVIRONMENT

Azure'da çalışırken işlev uygulamasının çalışma zamanı barındırma ortamını yapılandırılır. Bu değer başlatma sırasında okunur ve yalnızca bu değerler çalışma zamanı tarafından kabul edilir:

Value	Açıklama
`Production`	Azaltılmış günlük kaydı ve tam performans iyileştirmeleri ile bir üretim ortamını temsil eder. Bu, ayarlanmamışsa veya desteklenmeyen bir değere ayarlandığında varsayılan `AZURE_FUNCTIONS_ENVIRONMENT` değerdir.
`Staging`	Hazırlama yuvasında çalışırken olduğu gibi bir hazırlama ortamını temsil eder.
`Development`	Geliştirme Çevre desteği daha ayrıntılı günlüğe kaydetme ve diğer düşük performans iyileştirmeleri. Azure İşlevleri Core Tools, yerel bilgisayarınızda çalışırken olarak `Development` ayarlanır`AZURE_FUNCTIONS_ENVIRONMENT`. Bu ayar local.settings.json dosyasında geçersiz kılınamaz.

Azure'daki ASPNETCORE_ENVIRONMENT çalışma zamanı ortamını dışında Productionbir şeyle değiştirmeniz gerektiğinde yerine bu ayarı kullanın. Daha fazla bilgi için bkz . Ortam tabanlı Başlangıç sınıfı ve yöntemleri.

Bu ayar İşlevler çalışma zamanının 1.x sürümünde kullanılamaz.

AzureFunctionsJobHost__*

İşlevler çalışma zamanının 2.x ve sonraki sürümlerinde, uygulama ayarları geçerli ortamdaki host.json ayarlarını geçersiz kılabilir. Bu geçersiz kılmalar adlı AzureFunctionsJobHost__path__to__settinguygulama ayarları olarak ifade edilir. Daha fazla bilgi için bkz. host.json değerlerini geçersiz kılma.

AzureFunctionsWebHost__hostid

Belirli bir işlev uygulaması için benzersiz bir kimlik olması gereken konak kimliğini ayarlar. Bu ayar, uygulamanız için otomatik olarak oluşturulan konak kimliği değerini geçersiz kılar. Bu ayarı yalnızca aynı depolama hesabını paylaşan işlev uygulamaları arasında konak kimliği çakışmalarını önlemeniz gerektiğinde kullanın.

Konak kimliği aşağıdaki gereksinimleri karşılamalıdır:

1 ile 32 karakter arasında olmalıdır
yalnızca küçük harfler, sayılar ve tireler içerir
Tire ile başlama veya bitiş değil
Ardışık tireler içermez

Kimlik oluşturmanın kolay bir yolu GUID almak, tireleri kaldırmak ve guid 1835D7B5-5C98-4790-815D-072CC94C6F71 değerini değerine 1835d7b55c984790815d072cc94c6f71dönüştürmek gibi küçük harfe dönüştürmektir.

Anahtar	Örnek değer
AzureFunctionsWebHost__hostid	`myuniquefunctionappname123456789`

Daha fazla bilgi için bkz . Konak Kimliği ile ilgili dikkat edilmesi gerekenler.

AzureWebJobsDashboard

Bu ayar kullanım dışıdır ve yalnızca Azure İşlevleri çalışma zamanının 1.x sürümünde çalışırken desteklenir.

günlükleri depolamak ve portaldaki İzleyici sekmesinde görüntülemek için isteğe bağlı depolama hesabı bağlantı dizesi. Depolama hesabı blobları, kuyrukları ve tabloları destekleyen genel amaçlı bir hesap olmalıdır. Daha fazla bilgi edinmek için bkz. hesap gereksinimleri Depolama.

Anahtar	Örnek değer
AzureWebJobsDashboard	`DefaultEndpointsProtocol=https;AccountName=...`

AzureWebJobsDisableHomepage

değeri true , bir işlev uygulamasının kök URL'si için gösterilen varsayılan giriş sayfasını devre dışı bırakır. Varsayılan değer şudur: false.

Anahtar	Örnek değer
AzureWebJobsDisableHomepage	`true`

Bu uygulama ayarı atlandığında veya olarak ayarlandığında false, URL'ye <functionappname>.azurewebsites.netyanıt olarak aşağıdaki örneğe benzer bir sayfa görüntülenir.

İşlev uygulaması giriş sayfası

AzureWebJobsDotNetReleaseCompilation

true .NET kodunu derlerken Yayın modunu kullanma anlamına gelir; false hata ayıklama modunu kullanma anlamına gelir. Varsayılan true değeridir.

Anahtar	Örnek değer
AzureWebJobsDotNetReleaseCompilation	`true`

AzureWebJobsFeatureFlags

Etkinleştirilen beta özelliklerinin virgülle ayrılmış listesi. Bu bayrakların etkinleştirdiği beta özellikleri üretime hazır değildir, ancak canlı yayına geçmeden önce deneysel kullanım için etkinleştirilebilir.

Anahtar	Örnek değer
AzureWebJobsFeatureFlags	`feature1,feature2,EnableProxies`

Azure API Management'a geçişinizi planlarken İşlevler çalışma zamanının 4.x sürümünde proxy'leri yeniden etkinleştirmek için bu listeye ekleyin EnableProxies . Daha fazla bilgi için bkz . İşlevler v4.x'te proxy'leri yeniden etkinleştirme.

AzureWebJobsKubernetesSecretName

Anahtarları depolamak için kullanılan Kubernetes Gizli Dizileri kaynağını gösterir. Yalnızca Kubernetes'te çalışırken desteklenir. Bu ayar için olarak ayarlamanız AzureWebJobsSecretStorageTypekubernetesgerekir. AzureWebJobsKubernetesSecretName Ayarlı olmadığında, depo salt okunur olarak kabul edilir. Bu durumda, değerlerin dağıtımdan önce oluşturulması gerekir. Azure Functions Core Tools, Kubernetes'e dağıtılırken, değerleri otomatik olarak oluşturur.

Anahtar	Örnek değer
AzureWebJobsKubernetesSecretName	`<SECRETS_RESOURCE>`

Daha fazla bilgi edinmek için bkz . Gizli dizi depoları.

AzureWebJobsSecret Depolama KeyVaultClientId

Kullanıcı tarafından atanan yönetilen kimliğin istemci kimliği veya anahtarların depolandığı kasaya erişmek için kullanılan uygulama kaydı. Bu ayar için olarak ayarlamanız AzureWebJobsSecretStorageTypekeyvaultgerekir. İşlevler çalışma zamanının 4.x ve sonraki sürümlerinde desteklenir.

Anahtar	Örnek değer
AzureWebJobsSecret Depolama KeyVaultClientId	`<CLIENT_ID>`

Daha fazla bilgi edinmek için bkz . Gizli dizi depoları.

AzureWebJobsSecret Depolama KeyVaultClientSecret

Kullanıcı tarafından atanan yönetilen kimliğin istemci kimliğinin gizli dizisi veya anahtarların depolandığı kasaya erişmek için kullanılan uygulama kaydı. Bu ayar için olarak ayarlamanız AzureWebJobsSecretStorageTypekeyvaultgerekir. İşlevler çalışma zamanının 4.x ve sonraki sürümlerinde desteklenir.

Anahtar	Örnek değer
AzureWebJobsSecret Depolama KeyVaultClientSecret	`<CLIENT_SECRET>`

Daha fazla bilgi edinmek için bkz . Gizli dizi depoları.

AzureWebJobsSecret Depolama KeyVaultName

Anahtarları depolamak için kullanılan bir anahtar kasası örneğinin adı. Bu ayar yalnızca İşlevler çalışma zamanının 3.x sürümü için desteklenir. Sürüm 4.x için bunun yerine kullanın AzureWebJobsSecretStorageKeyVaultUri. Bu ayar için olarak ayarlamanız AzureWebJobsSecretStorageTypekeyvaultgerekir.

Kasa, barındırma kaynağının sistem tarafından atanan yönetilen kimliğine karşılık gelen bir erişim ilkesine sahip olmalıdır. Erişim ilkesi kimliğe şu gizli dizi izinlerini vermelidir: Get,Set, Listve Delete.
İşlevleriniz yerel olarak çalıştırıldığında geliştirici kimliği kullanılır ve ayarlar local.settings.json dosyasında olmalıdır.

Anahtar	Örnek değer
AzureWebJobsSecret Depolama KeyVaultName	`<VAULT_NAME>`

Daha fazla bilgi edinmek için bkz . Gizli dizi depoları.

AzureWebJobsSecret Depolama KeyVaultTenantId

Anahtarların depolandığı kasaya erişmek için kullanılan uygulama kaydının kiracı kimliği. Bu ayar için olarak ayarlamanız AzureWebJobsSecretStorageTypekeyvaultgerekir. İşlevler çalışma zamanının 4.x ve sonraki sürümlerinde desteklenir. Daha fazla bilgi edinmek için bkz . Gizli dizi depoları.

Anahtar	Örnek değer
AzureWebJobsSecret Depolama KeyVaultTenantId	`<TENANT_ID>`

AzureWebJobsSecret Depolama KeyVaultUri

Anahtarları depolamak için kullanılan bir anahtar kasası örneğinin URI'si. İşlevler çalışma zamanının 4.x ve sonraki sürümlerinde desteklenir. Bu, anahtar depolama için bir anahtar kasası örneği kullanmak için önerilen ayardır. Bu ayar için olarak ayarlamanız AzureWebJobsSecretStorageTypekeyvaultgerekir.

Değer, AzureWebJobsSecretStorageKeyVaultUri Key Vault genel bakış sekmesinde görüntülenen Kasa URI'sinin tam değeri olmalıdır( dahil).https://

Anahtar	Örnek değer
AzureWebJobsSecret Depolama KeyVaultUri	`https://<VAULT_NAME>.vault.azure.net`

Daha fazla bilgi edinmek için, bkz. Azure İşlevleri için Key Vault başvurularını kullanma.

AzureWebJobsSecret Depolama Sas

Anahtar depolama için kullanılan ikinci bir depolama hesabının Blob Depolama SAS URL'si. İşlevler varsayılan olarak içinde AzureWebJobsStorageayarlanan hesabı kullanır. Bu gizli depolama seçeneğini kullanırken, bunun açıkça ayarlanmadığından AzureWebJobsSecretStorageType veya olarak ayarlanmadığından blobemin olun. Daha fazla bilgi edinmek için bkz . Gizli dizi depoları.

Anahtar	Örnek değer
AzureWebJobsSecret Depolama Sas	`<BLOB_SAS_URL>`

AzureWebJobsSecret Depolama Type

Anahtar depolama için kullanılacak depoyu veya sağlayıcıyı belirtir. Anahtarlar, işlev uygulamanıza özgü bir gizli dizi kullanılarak depolanmadan önce her zaman şifrelenir.

Anahtar	Value	Açıklama
AzureWebJobsSecret Depolama Type	`blob`	Anahtarlar, ayar tarafından sağlanan hesaptaki bir Blob depolama kapsayıcısında `AzureWebJobsStorage` depolanır. Blob depolama ayarlanmadığında `AzureWebJobsSecretStorageType` varsayılan davranıştır. Farklı bir depolama hesabı belirtmek için, ikinci bir depolama hesabının SAS URL'sini belirtmek için ayarını kullanın `AzureWebJobsSecretStorageSas` .
AzureWebJobsSecret Depolama Type	`files`	Anahtarlar dosya sisteminde kalıcıdır. Bu, İşlevler v1.x için varsayılan davranıştır.
AzureWebJobsSecret Depolama Type	`keyvault`	Anahtarlar tarafından `AzureWebJobsSecretStorageKeyVaultName`ayarlanan bir anahtar kasası örneğinde depolanır.
AzureWebJobsSecret Depolama Type	`kubernetes`	Yalnızca, Kubernetes'te İşlevler çalışma zamanı çalıştırılırken desteklenir. `AzureWebJobsKubernetesSecretName` Ayarlı olmadığında, depo salt okunur olarak kabul edilir. Bu durumda, değerlerin dağıtımdan önce oluşturulması gerekir. Azure Functions Core Tools, Kubernetes'e dağıtılırken, değerleri otomatik olarak oluşturur.

Daha fazla bilgi edinmek için bkz . Gizli dizi depoları.

AzureWebJobsStorage

İşlevler çalışma zamanının normal işlemler için kullandığı bir Azure Depolama hesabının bağlantı dizesi belirtir. İşlevler tarafından kullanılan bu depolama hesabının bazı kullanımları arasında anahtar yönetimi, zamanlayıcı tetikleyici yönetimi ve Event Hubs denetim noktaları yer alır. Depolama hesabı blobları, kuyrukları ve tabloları destekleyen genel amaçlı bir hesap olmalıdır. Daha fazla bilgi için bkz. hesap gereksinimleri Depolama.

Anahtar	Örnek değer
AzureWebJobsStorage	`DefaultEndpointsProtocol=https;AccountName=...`

bağlantı dizesi yerine, bu depolama hesabı için kimlik tabanlı bir bağlantı kullanabilirsiniz. Daha fazla bilgi için Bir kimlikle konak depolama alanına bağlanma makalesine bakın.

AzureWebJobs Depolama__accountName

Kimlik tabanlı depolama bağlantısı kullanırken, içindeki bağlantı dizesi AzureWebJobsStoragekullanmak yerine depolama hesabının hesap adını ayarlar. Bu söz dizimi benzersizdir AzureWebJobsStorage ve diğer kimlik tabanlı bağlantılar için kullanılamaz.

Anahtar	Örnek değer
AzureWebJobs Depolama__accountName	`<STORAGE_ACCOUNT_NAME>`

Bağımsız bulutlar için veya özel DNS kullanırken bunun yerine hizmete özgü AzureWebJobsStorage__*ServiceUri ayarları kullanmanız gerekir.

AzureWebJobsStorage__blobServiceUri

Kimlik tabanlı depolama bağlantısı kullanırken, depolama hesabının blob hizmetinin veri düzlemi URI'sini ayarlar.

Anahtar	Örnek değer
AzureWebJobsStorage__blobServiceUri	`https://<STORAGE_ACCOUNT_NAME>.blob.core.windows.net`

Bağımsız bulutlar yerine AzureWebJobsStorage__accountName veya özel DNS kullanırken bu ayarı kullanın. Daha fazla bilgi için Bir kimlikle konak depolama alanına bağlanma makalesine bakın.

AzureWebJobsStorage__queueServiceUri

Kimlik tabanlı depolama bağlantısı kullanırken, depolama hesabının kuyruk hizmetinin veri düzlemi URI'sini ayarlar.

Anahtar	Örnek değer
AzureWebJobsStorage__queueServiceUri	`https://<STORAGE_ACCOUNT_NAME>.queue.core.windows.net`

AzureWebJobsStorage__tableServiceUri

Kimlik tabanlı depolama bağlantısı kullanırken, depolama hesabının tablo hizmetinin veri düzlemi URI'sini ayarlar.

Anahtar	Örnek değer
AzureWebJobsStorage__tableServiceUri	`https://<STORAGE_ACCOUNT_NAME>.table.core.windows.net`

AzureWebJobs_TypeScriptPath

TypeScript için kullanılan derleyicinin yolu. Gerekirse varsayılanı geçersiz kılmanıza olanak tanır.

Anahtar	Örnek değer
AzureWebJobs_TypeScriptPath	`%HOME%\typescript`

DOCKER_REGISTRY_SERVER_PASSWORD

Özel kapsayıcı kayıt defterine erişmek için kullanılan parolayı gösterir. Bu ayar yalnızca kapsayıcılı işlev uygulamanızı özel bir kapsayıcı kayıt defterinden dağıtırken gereklidir. Daha fazla bilgi için bkz. Azure Uygulaması Hizmeti'nde ortam değişkenleri ve uygulama ayarları.

DOCKER_REGISTRY_SERVER_URL

Özel kapsayıcı kayıt defterinin URL'sini gösterir. Bu ayar yalnızca kapsayıcılı işlev uygulamanızı özel bir kapsayıcı kayıt defterinden dağıtırken gereklidir. Daha fazla bilgi için bkz. Azure Uygulaması Hizmeti'nde ortam değişkenleri ve uygulama ayarları.

DOCKER_REGISTRY_SERVER_USERNAME

Özel kapsayıcı kayıt defterine erişmek için kullanılan hesabı gösterir. Bu ayar yalnızca kapsayıcılı işlev uygulamanızı özel bir kapsayıcı kayıt defterinden dağıtırken gereklidir. Daha fazla bilgi için bkz. Azure Uygulaması Hizmeti'nde ortam değişkenleri ve uygulama ayarları.

DOCKER_SHM_SIZE

Python çalışanı paylaşılan bellek kullanırken paylaşılan bellek boyutunu (bayt cinsinden) ayarlar. Daha fazla bilgi edinmek için bkz . Paylaşılan bellek.

Anahtar	Örnek değer
DOCKER_SHM_SIZE	`268435456`

Yukarıdaki değer paylaşılan bellek boyutunu yaklaşık 256 MB olarak ayarlar.

bunun FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED olarak ayarlanmasını 1gerektirir.

ENABLE_ORYX_BUILD

Oryx derleme sisteminin dağıtım sırasında kullanılıp kullanılmadığını gösterir. ENABLE_ORYX_BUILD Linux'a true uzaktan derleme dağıtımları yapılırken olarak ayarlanmalıdır. Daha fazla bilgi için bkz . Uzak derleme.

Anahtar	Örnek değer
ENABLE_ORYX_BUILD	`true`

FUNCTION_APP_EDIT_MODE

İşlev uygulamanızı Azure portalında düzenleyip düzenleyemeyeceğinizi gösterir. Geçerli değerler: readwrite ve readonly.

Anahtar	Örnek değer
FUNCTION_APP_EDIT_MODE	`readonly`

Değer, işlev uygulamanızın dil yığınına ve dağıtım durumuna göre çalışma zamanı tarafından ayarlanır. Daha fazla bilgi için bkz . Azure portalında geliştirme sınırlamaları.

FUNCTIONS_EXTENSION_VERSION

İşlev uygulamanızı barındıran İşlevler çalışma zamanının sürümü. Ana sürüme sahip bir tilde (~), bu ana sürümün en son sürümünü (örneğin, ~3) kullanmak anlamına gelir. Aynı ana sürüm için yeni sürümler kullanılabilir olduğunda, bunlar işlev uygulamasına otomatik olarak yüklenir. Uygulamayı belirli bir sürüme sabitlemek için tam sürüm numarasını (örneğin, 3.0.12345) kullanın. Varsayılan ~3 değeridir. Değeri uygulamanızı çalışma zamanının ~1 1.x sürümüne sabitler. Daha fazla bilgi için bkz. Azure İşlevleri çalışma zamanı sürümlerine genel bakış. değeri ~4 , uygulamanızın çalışma zamanının 4.x sürümünde çalıştığı anlamına gelir.

Anahtar	Örnek değer
FUNCTIONS_EXTENSION_VERSION	`~4`

Aşağıdaki ana çalışma zamanı sürüm değerleri desteklenir:

Değer	Çalışma zamanı hedefi	Yorum
`~4`	4.x	Önerilir
`~3`	3.x	Artık desteklenmiyor
`~2`	2.x	Artık desteklenmiyor
`~1`	1.x	Destek 14 Eylül 2026'da sona eriyor

FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR

Bu uygulama ayarı, Node.js uygulamaların giriş noktası hatalarını Node.js v18 veya daha düşük bir sürümde gidermeyi kolaylaştıran hataya neden olan bir değişikliği etkinleştirmenin geçici bir yoludur. Özellikle her zaman giriş noktası dosyalarını kullanan trueprogramlama modeli v4 uygulamaları için kullanılması kesinlikle önerilir. Hataya neden olan değişiklik (false) olmadan davranış giriş noktası hatalarını yoksayar ve bunları Application Analizler'da günlüğe kaydetmez.

Node.js v20'den başlayarak uygulama ayarının hiçbir etkisi yoktur ve hataya neden olan değişiklik davranışı her zaman etkindir.

v18 veya daha düşük Node.js için uygulama ayarı kullanılabilir ve varsayılan davranış, hatanın bir model v4 işlevi kaydedilmeden önce mi yoksa sonra mı olduğuna bağlıdır:

Hata daha önce oluşturulduysa (örneğin, model v3 kullanıyorsanız veya giriş noktası dosyanız yoksa), varsayılan davranış ile eşleşir false.
Hata sonrasında oluşursa (örneğin, yinelenen model v4 işlevlerini kaydetmeye çalışırsanız), varsayılan davranış ile eşleşir true.

Anahtar	Value	Açıklama
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR	`true`	Giriş noktası hatalarını engelleyin ve bunları Uygulama Analizler'da günlüğe kaydedin.
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR	`false`	Giriş noktası hatalarını yoksayın ve Bunları Application Analizler'da günlüğe kaydetmeyin.

FUNCTIONS_V2_COMPATIBILITY_MODE

Önemli

Bu ayar artık desteklenmiyor. Başlangıçta, v2.x çalışma zamanını hedefleyen uygulamaların hala desteklendiği sırada v3.x çalışma zamanında çalışabilmesi için kısa vadeli bir geçici çözüm sağlamak için sağlanmıştır. 1.x sürümünde çalışan eski uygulamalar dışında, tüm işlev uygulamaları İşlevler çalışma zamanının 4.x sürümünde çalıştırılmalıdır: FUNCTIONS_EXTENSION_VERSION=~4. Daha fazla bilgi için bkz. Azure İşlevleri çalışma zamanı sürümlerine genel bakış.

FUNCTIONS_REQUEST_BODY_SIZE_LIMIT

HTTP uç noktalarına gönderilen isteklerin gövde boyutu üzerinde varsayılan sınırı geçersiz kılar. Değer bayt cinsinden verilir ve varsayılan en fazla istek boyutu 104857600 bayttır.

Anahtar	Örnek değer
FUNCTIONS_REQUEST_BODY_SIZE_LIMIT	`250000000`

FUNCTIONS_WORKER_PROCESS_COUNT

Varsayılan değeri 1olan en fazla dil çalışanı işlemi sayısını belirtir. İzin verilen en büyük değer: 10. İşlev çağrıları, dil çalışanı işlemleri arasında eşit olarak dağıtılır. Dil çalışanı işlemleri, tarafından FUNCTIONS_WORKER_PROCESS_COUNT ayarlanan sayıya ulaşılana kadar her 10 saniyede bir oluşturulur. Birden çok dil çalışanı işlemi kullanmak ölçeklendirmeyle aynı değildir. İş yükünüz CPU'ya bağlı ve G/Ç'ye bağlı çağrıların bir karışımına sahip olduğunda bu ayarı kullanmayı göz önünde bulundurun. Bu ayar, işlemdeFUNCTIONS_WORKER_RUNTIME=dotnet () çalışan .NET dışında tüm dil çalışma zamanları için geçerlidir.

Anahtar	Örnek değer
FUNCTIONS_WORKER_PROCESS_COUNT	`2`

FUNCTIONS_WORKER_RUNTIME

İşlev uygulamasına yüklenecek çalışan çalışma zamanının dil veya dil yığını. Bu, uygulamanızda kullanılan dile karşılık gelir (örneğin, python). Azure İşlevleri çalışma zamanının 2.x sürümünden başlayarak, belirli bir işlev uygulaması yalnızca tek bir dili destekleyebilir.

Anahtar	Örnek değer
FUNCTIONS_WORKER_RUNTIME	`node`

Geçerli değerler:

Değer	Dil/dil yığını
`dotnet`	C# (sınıf kitaplığı) C# (betik)
`dotnet-isolated`	C# (yalıtılmış çalışan işlemi)
`java`	Java
`node`	JavaScript TypeScript
`powershell`	PowerShell
`python`	Python
`custom`	Diğer

FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED

Bu ayar, Python çalışanının aktarım hızını geliştirmek için paylaşılan belleği kullanmasına olanak tanır. Python işlev uygulamanız bellek performans sorunlarına neden olduğunda paylaşılan belleği etkinleştirin.

Anahtar	Örnek değer
FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED	`1`

Bu ayar etkinleştirildiğinde, paylaşılan bellek boyutunu ayarlamak için DOCKER_SHM_SIZE ayarını kullanabilirsiniz. Daha fazla bilgi edinmek için bkz . Paylaşılan bellek.

JAVA_OPTS

Premium planda veya Ayrılmış planda çalışırken Java işlevlerinizi çalıştırmak için kullanılan Java sanal makinesini (JVM) özelleştirmek için kullanılır. Tüketim planında çalışırken bunun yerine kullanın languageWorkers__java__arguments. Daha fazla bilgi için bkz . JVM'yi özelleştirme.

languageWorkersjavaarguments

Tüketim planında çalışırken Java işlevlerinizi çalıştırmak için kullanılan Java sanal makinesini (JVM) özelleştirmek için kullanılır. Bu ayar, Tüketim planında çalışan Java işlevlerinin soğuk başlangıç sürelerini artırır. Premium veya Ayrılmış plan için bunun yerine kullanın JAVA_OPTS. Daha fazla bilgi için bkz . JVM'yi özelleştirme.

MDMaxBackgroundUpgradePeriod

Varsayılan değeri 7.00:00:00 (haftalık) olan PowerShell işlev uygulamaları için yönetilen bağımlılıklar arka plan güncelleştirme süresini denetler.

Her PowerShell çalışan işlemi, işlem başlangıcında ve MDMaxBackgroundUpgradePeriod sonrasında PowerShell Galerisi modül yükseltmelerini denetlemeyi başlatır. PowerShell Galerisi yeni bir modül sürümü kullanılabilir olduğunda, dosya sistemine yüklenir ve PowerShell çalışanlarının kullanımına sunulur. Bu değerin azaltılması işlev uygulamanızın daha yeni modül sürümlerini daha erken almasına olanak tanır, ancak uygulama kaynak kullanımını da artırır (ağ G/Ç, CPU, depolama). Bu değerin artırılması uygulamanın kaynak kullanımını azaltır, ancak uygulamanıza yeni modül sürümlerinin gönderilmesini de geciktirebilir.

Anahtar	Örnek değer
MDMaxBackgroundUpgradePeriod	`7.00:00:00`

Daha fazla bilgi için bkz . Bağımlılık yönetimi.

MDNewSnapshotCheckPeriod

Her PowerShell çalışanının yönetilen bağımlılık yükseltmelerinin yüklenip yüklenmediğini ne sıklıkta denetlediğini belirtir. Varsayılan sıklık ( 01:00:00 saatlik).

Dosya sistemine yeni modül sürümleri yüklendikten sonra, her PowerShell çalışan işleminin yeniden başlatılması gerekir. PowerShell çalışanlarının yeniden başlatılması, uygulamanızın kullanılabilirliğini etkiler, bu da geçerli işlev yürütmeyi kesintiye uğratabilir. Tüm PowerShell çalışan işlemleri yeniden başlatılana kadar işlev çağrıları eski veya yeni modül sürümlerini kullanabilir. Tüm PowerShell çalışanlarının yeniden başlatılması içinde MDNewSnapshotCheckPeriodtamamlar.

Her MDNewSnapshotCheckPeriodiçinde, PowerShell çalışanı yönetilen bağımlılık yükseltmelerinin yüklenip yüklenmediğini denetler. Yükseltmeler yüklendiğinde yeniden başlatma başlatılır. Bu değerin artırılması, yeniden başlatmalar nedeniyle kesintilerin sıklığını azaltır. Ancak, artış işlev çağrılarının belirsiz bir şekilde eski veya yeni modül sürümlerini kullanabildiği süreyi de artırabilir.

Anahtar	Örnek değer
MDNewSnapshotCheckPeriod	`01:00:00`

Daha fazla bilgi için bkz . Bağımlılık yönetimi.

MDMinBackgroundUpgradePeriod

Başka bir yükseltme denetimi başlatılmadan önceki yönetilen bağımlılık yükseltme denetiminden sonraki ve varsayılan 1.00:00:00 (günlük) süre.

Sık çalışan yeniden başlatmalarında aşırı modül yükseltmelerini önlemek için, herhangi bir çalışan son MDMinBackgroundUpgradePeriodiadeyi başlattığında modül yükseltmeleri denetlenmiyor.

Anahtar	Örnek değer
MDMinBackgroundUpgradePeriod	`1.00:00:00`

Daha fazla bilgi için bkz . Bağımlılık yönetimi.

PIP_INDEX_URL

Bu ayar, varsayılan olarak https://pypi.org/simpleolan Python Paket Dizini'nin temel URL'sini geçersiz kılmanızı sağlar. Özel bağımlılıkları kullanarak uzak derleme çalıştırmanız gerektiğinde bu ayarı kullanın. Bu özel bağımlılıklar, PEP 503 (basit depo API'si) ile uyumlu bir paket dizini deposunda veya aynı biçimi izleyen yerel bir dizinde olabilir.

Anahtar	Örnek değer
PIP_INDEX_URL	`http://my.custom.package.repo/simple`

Daha fazla bilgi edinmek için --index-urlPython geliştirici başvurusunda Özel bağımlılıklar ve kullanma belgelerine bakınpip.

PIP_EXTRA_INDEX_URL

Bu ayarın değeri, Python uygulamalarına yönelik özel paketler için ek bir dizin URL'si olduğunu ve buna ek olarak --index-urlkullanılacağını gösterir. Ek paket dizininde bulunan özel bağımlılıkları kullanarak uzak derleme çalıştırmanız gerektiğinde bu ayarı kullanın. ile aynı kurallara uymalıdır --index-url.

Anahtar	Örnek değer
PIP_EXTRA_INDEX_URL	`http://my.custom.package.repo/simple`

Daha fazla bilgi edinmek için Python geliştirici başvurusunda ve Özel bağımlılıklar belgelerine bakınpip.--extra-index-url

PROJE

Kudu dağıtım hizmetine, dağıtılabilir projeyi konumlandırması için bağlı bir depodaki klasörü bildiren sürekli dağıtım ayarı.

Anahtar	Örnek değer
PROJE	`WebProject/WebProject.csproj`

PYTHON_ISOLATE_WORKER_DEPENDENCIES

Yapılandırma Python işlev uygulamalarına özgüdür. Modül yükleme sırasının öncelik belirlemesini tanımlar. Varsayılan olarak, bu değer olarak 0ayarlanır.

Anahtar	Value	Açıklama
PYTHON_ISOLATE_WORKER_DEPENDENCIES	`0`	Python kitaplıklarını iç Python çalışanının bağımlılıklarından yüklemenin önceliğini belirleyin. Bu, varsayılan davranıştır. requirements.txt tanımlanan üçüncü taraf kitaplıkları gölgeli olabilir.
PYTHON_ISOLATE_WORKER_DEPENDENCIES	`1`	Requirements.txt'de tanımlanan uygulamanın paketinden Python kitaplıklarını yüklemenin önceliğini belirleyin. Bu, kitaplıklarınızın iç Python çalışanlarının kitaplıklarıyla çakışmasını önler.

PYTHON_ENABLE_DEBUG_LOGGING

Python işlev uygulamasında hata ayıklama düzeyinde günlüğe kaydetmeyi etkinleştirir. değeri 1 hata ayıklama düzeyinde günlüğe kaydetmeyi etkinleştirir. Bu ayar olmadan veya değeri 0ile yalnızca bilgiler ve daha üst düzey günlükler Python çalışanından İşlevler konağına gönderilir. Python işlevi yürütmelerinizde hata ayıklama veya izleme yaparken bu ayarı kullanın.

Python işlevlerinde hata ayıklama yaparken, gerektiğinde host.json dosyasında hata ayıklama veya izleme günlüğü düzeyi ayarladığınızdan emin olun. Daha fazla bilgi edinmek için bkz. Azure İşlevleri için izlemeyi yapılandırma.

PYTHON_ENABLE_WORKER_EXTENSIONS

Yapılandırma Python işlev uygulamalarına özgüdür. Bunu olarak ayarlamak 1 , çalışanın requirements.txt'de tanımlanan Python çalışan uzantılarında yüklenmesine olanak tanır. İşlev uygulamanızın üçüncü taraf paketler tarafından sağlanan yeni özelliklere erişmesini sağlar. Ayrıca uygulamanızdaki işlev yükünün ve çağrının davranışını da değiştirebilir. Kullandığınız uzantıyı kullanma riski taşırken seçtiğiniz uzantının güvenilir olduğundan emin olun. Azure İşlevleri hiçbir uzantı için açık garanti vermemektedir. Uzantıyı kullanma hakkında bilgi için uzantının el ile sayfasını veya benioku belgesini ziyaret edin. Varsayılan olarak, bu değer olarak ayarlır 0.

Anahtar	Value	Açıklama
PYTHON_ENABLE_WORKER_EXTENSIONS	`0`	Herhangi bir Python çalışan uzantısını devre dışı bırakın.
PYTHON_ENABLE_WORKER_EXTENSIONS	`1`	Python çalışanının requirements.txt uzantılarını yüklemesine izin verin.

PYTHON_THREADPOOL_THREAD_COUNT

Python dil çalışanının işlev çağrılarını yürütmek için kullanacağı iş parçacığı sayısı üst sınırını, Python sürümü 3.8 ve altında varsayılan değeriyle 1 belirtir. Python sürümü ve üzeri için 3.9 değeri olarak Noneayarlanır. Bu ayar, yürütmeler sırasında ayarlanacak iş parçacığı sayısını garanti etmez. Bu ayar Python'ın iş parçacığı sayısını belirtilen değere genişletmesine olanak tanır. Bu ayar yalnızca Python işlevleri uygulamaları için geçerlidir. Buna ek olarak, ayar eş yordamlar için değil zaman uyumlu işlevler çağırma için geçerlidir.

Anahtar	Örnek değer	En yüksek değer
PYTHON_THREADPOOL_THREAD_COUNT	2	32

SCALE_CONTROLLER_LOGGING_ENABLED

Bu ayar şu anda önizleme aşamasındadır.

Bu ayar, Azure İşlevleri ölçek denetleyicisinden günlüğe kaydetmeyi denetler. Daha fazla bilgi için bkz . Denetleyici günlüklerini ölçeklendirme.

Anahtar	Örnek değer
SCALE_CONTROLLER_LOGGING_ENABLED	`AppInsights:Verbose`

Bu anahtarın değeri şu şekilde tanımlanan biçiminde <DESTINATION>:<VERBOSITY>sağlanır:

Özellik Açıklama

<DESTINATION> Günlüklerin gönderildiği hedef. Geçerli değerler: AppInsights ve Blob.
kullandığınızdaAppInsights, işlev uygulamanızda Uygulama Analizler'nin etkinleştirildiğinden emin olun.
Hedefi olarak Blobayarladığınızda günlükler, uygulama ayarında ayarlanan varsayılan depolama hesabında adlı azure-functions-scale-controller bir blob kapsayıcısında AzureWebJobsStorage oluşturulur.

<VERBOSITY> Günlük düzeyini belirtir. Desteklenen değerler , Warningve VerbosedeğerleridirNone.
olarak Verboseayarlandığında, ölçek denetleyicisi çalışan sayısındaki her değişikliğin nedenini ve bu kararları dikkate alan tetikleyiciler hakkındaki bilgileri günlüğe kaydeder. Ayrıntılı günlükler tetikleyici uyarılarını ve ölçek denetleyicisi çalıştırıldıktan önce ve çalıştırıldıktan sonra tetikleyiciler tarafından kullanılan karmaları içerir.

Özellik	Açıklama
`<DESTINATION>`	Günlüklerin gönderildiği hedef. Geçerli değerler: `AppInsights` ve `Blob`. kullandığınızda`AppInsights`, işlev uygulamanızda Uygulama Analizler'nin etkinleştirildiğinden emin olun. Hedefi olarak `Blob`ayarladığınızda günlükler, uygulama ayarında ayarlanan varsayılan depolama hesabında adlı `azure-functions-scale-controller` bir blob kapsayıcısında `AzureWebJobsStorage` oluşturulur.
`<VERBOSITY>`	Günlük düzeyini belirtir. Desteklenen değerler , `Warning`ve `Verbose`değerleridir`None`. olarak `Verbose`ayarlandığında, ölçek denetleyicisi çalışan sayısındaki her değişikliğin nedenini ve bu kararları dikkate alan tetikleyiciler hakkındaki bilgileri günlüğe kaydeder. Ayrıntılı günlükler tetikleyici uyarılarını ve ölçek denetleyicisi çalıştırıldıktan önce ve çalıştırıldıktan sonra tetikleyiciler tarafından kullanılan karmaları içerir.

İpucu

Ölçek denetleyicisi günlüğünü etkin bırakırken işlev uygulamanızı izlemenin olası maliyetlerini etkilediğini unutmayın. Ölçek denetleyicisinin nasıl davrandığını anlamak için yeterli veri toplayana kadar günlüğü etkinleştirmeyi ve ardından devre dışı bırakmayı göz önünde bulundurun.

SCM_DO_BUILD_DURING_DEPLOYMENT

Dağıtım sırasında uzaktan derleme davranışını denetler. SCM_DO_BUILD_DURING_DEPLOYMENT olarak ayarlandığındatrue, proje dağıtım sırasında uzaktan oluşturulur.

Anahtar	Örnek değer
SCM_DO_BUILD_DURING_DEPLOYMENT	`true`

SCM_LOGSTREAM_TIMEOUT

Akış günlüklerine bağlanıldığında zaman aşımını saniyeler içinde denetler. Varsayılan değer 7200'dür (2 saat).

Anahtar	Örnek değer
SCM_LOGSTREAM_TIMEOUT	`1800`

Yukarıdaki örnek değeri 1800 30 dakikalık bir zaman aşımı ayarlar. Daha fazla bilgi için bkz. Azure İşlevleri'da akış yürütme günlüklerini etkinleştirme.

WEBSITE_CONTENTAZUREFILECONNECTIONSTRING

İşlev uygulaması kodunun ve yapılandırmasının olay temelli ölçeklendirme planlarında depolandığı depolama hesabı için Bağlan ion dizesi. Daha fazla bilgi için bkz. hesap bağlantısı ayarını Depolama.

Anahtar	Örnek değer
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING	`DefaultEndpointsProtocol=https;AccountName=...`

Bu ayar hem Windows hem de Linux üzerinde çalışan Tüketim ve Elastik Premium planı uygulamaları için gereklidir. İşlevler tarafından dinamik olarak ölçeklendirilmeyen Ayrılmış plan uygulamaları için gerekli değildir.

Bu ayarı değiştirmek veya kaldırmak işlev uygulamanızın başlatılmamasına neden olabilir. Daha fazla bilgi edinmek için bu sorun giderme makalesine bakın.

Azure Dosyalar, dosya paylaşımına erişirken yönetilen kimliğin kullanılmasını desteklemez. Daha fazla bilgi için bkz. desteklenen Azure Dosyalar kimlik doğrulama senaryoları.

WEBSITE_CONTENTOVERVNET

değeri 1 , depolama hesabınız bir sanal ağ ile sınırlı olduğunda işlev uygulamanızın ölçeklendirilmesini sağlar. Depolama hesabınızı bir sanal ağ ile kısıtlarken bu ayarı etkinleştirmeniz gerekir. Yalnızca kullanırken WEBSITE_CONTENTAZUREFILECONNECTIONSTRINGgereklidir. Daha fazla bilgi edinmek için bkz . Depolama hesabınızı bir sanal ağ ile kısıtlama.

Anahtar	Örnek değer
WEBSITE_CONTENTOVERVNET	`1`

Premium ve Ayrılmış (App Service) planlarında (Standart ve üzeri) desteklenir. Tüketim planında çalıştırılırken desteklenmez.

WEBSITE_CONTENTSHARE

İşlevler'in işlev uygulama kodunu ve yapılandırma dosyalarını depolamak için kullandığı dosya paylaşımının adı. Bu içerik olay odaklı ölçeklendirme planları için gereklidir. ile kullanılır WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. Varsayılan, çalışma zamanı tarafından oluşturulan ve işlev uygulaması adıyla başlayan benzersiz bir dizedir. Daha fazla bilgi için bkz. hesap bağlantısı ayarını Depolama.

Anahtar	Örnek değer
WEBSITE_CONTENTSHARE	`functionapp091999e2`

Bu ayar hem Windows hem de Linux'ta Tüketim ve Premium plan uygulamaları için gereklidir. İşlevler tarafından dinamik olarak ölçeklendirilmeyen Ayrılmış plan uygulamaları için gerekli değildir.

Paylaşım, işlev uygulamanız oluşturulduğunda oluşturulur. Bu ayarı değiştirmek veya kaldırmak işlev uygulamanızın başlatılmamasına neden olabilir. Daha fazla bilgi edinmek için bu sorun giderme makalesine bakın.

Dağıtım sırasında işlev uygulaması oluşturmak için Bir Azure Resource Manager (ARM) şablonu veya Bicep dosyası kullanılırken aşağıdaki önemli noktalar geçerlidir:

Ana işlev uygulaması veya yuvalardaki uygulamalar için bir WEBSITE_CONTENTSHARE değer ayarlamadığınızda, benzersiz paylaşım değerleri sizin için oluşturulur. Ayar WEBSITE_CONTENTSHAREdeğil, ARM şablonu dağıtımı için önerilen yaklaşımdır .
Değeri önceden tanımlanmış bir değere ayarlamanız WEBSITE_CONTENTSHARE gereken senaryolar vardır, örneğin sanal ağda güvenli bir depolama hesabı kullandığınızda. Bu durumda, ana işlev uygulaması ve her dağıtım yuvası için uygulama için benzersiz bir paylaşım adı ayarlamanız gerekir. Sanal ağ tarafından güvenliği sağlanan bir depolama hesabı söz konusu olduğunda, otomatik dağıtımınızın bir parçası olarak paylaşımın kendisini de oluşturmanız gerekir. Daha fazla bilgi için bkz . Güvenli dağıtımlar.
Yuva ayarı yapmayın WEBSITE_CONTENTSHARE .
belirttiğinizdeWEBSITE_CONTENTSHARE, değerin paylaşım adları için bu kılavuzu izlemesi gerekir.

WEBSITE_DNS_SERVER

IP adreslerini çözerken uygulama tarafından kullanılan DNS sunucusunu ayarlar. Bu ayar genellikle Azure DNS özel bölgeleri ve özel uç noktalar gibi belirli ağ işlevleri kullanılırken gereklidir.

Anahtar	Örnek değer
WEBSITE_DNS_SERVER	`168.63.129.16`

WEBSITE_ENABLE_BROTLI_ENCODING

Brotli kodlamasının varsayılan gzip sıkıştırması yerine sıkıştırma için kullanılıp kullanılmadığını denetler. WEBSITE_ENABLE_BROTLI_ENCODING olarak ayarlandığında 1Brotli kodlaması kullanılır; aksi takdirde gzip kodlaması kullanılır.

WEBSITE_FUNCTIONS_ARMCACHE_ENABLED

Azure Resource Manager (ARM) şablonlarını kullanarak işlev uygulamalarını dağıtırken önbelleğe almayı devre dışı bırakır.

Anahtar	Örnek değer
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED	0

WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT

Uygulamanın ölçeğini genişletebileceği en fazla örnek sayısı. Varsayılan sınır değildir.

Önemli

Bu ayar önizleme aşamasındadır. Maksimum ölçeği genişletme işlevine yönelik bir uygulama özelliği eklendi ve ölçeği genişletmeyi sınırlamanın önerilen yoludur.

Anahtar	Örnek değer
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT	`5`

WEBSITE_NODE_DEFAULT_VERSION

Yalnızca Windows. İşlev uygulamanızı Windows'da çalıştırırken kullanılacak Node.js sürümünü ayarlar. Çalışma zamanının hedeflenen ana sürümün en son kullanılabilir sürümünü kullanmasını sağlamak için bir tilde (~) kullanmanız gerekir. Örneğin, olarak ~18ayarlandığında, Node.js 18'in en son sürümü kullanılır. Ana sürüm bir tilde ile hedeflendiğinde, ikincil sürümü el ile güncelleştirmeniz gerekmez.

Anahtar	Örnek değer
WEBSITE_NODE_DEFAULT_VERSION	`~18`

WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS

Premium planda çalışan bir işlev uygulamasında yuva değişimi gerçekleştirirken, uygulama tarafından kullanılan ayrılmış depolama hesabı ağ kısıtlandığında değiştirme işlemi başarısız olabilir. Bu hata, hem İşlevler hem de App Service tarafından paylaşılan eski bir uygulama günlüğü özelliğinden kaynaklanır. Bu ayar eski günlüğe kaydetme özelliğini geçersiz kılar ve değiştirme işleminin gerçekleşmesine izin verir.

Anahtar	Örnek değer
WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS	`0`

Eski tanılama ayarlarının 0 değiştirme işlemlerinizi engellemediğinden emin olmak için tüm yuvalara değeriyle ekleyinWEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS. Bu ayarı ve değeri yalnızca üretim yuvasına dağıtım yuvası (yapışkan) ayarı olarak da ekleyebilirsiniz.

WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS

Varsayılan olarak, işlev uygulamalarının sürüm ayarları her yuvaya özgüdür. Bu ayar, dağıtım yuvalarını kullanarak işlevleri yükseltirken kullanılır. Bu, değiştirme işleminden sonra sürümlerin değiştirilmesi nedeniyle tahmin edilmeyen davranışı önler. 0 Tüm sürüm ayarlarının da değiştirildiğinden emin olmak için üretimde ve yuvada olarak ayarlayın. Daha fazla bilgi için bkz . Yuvaları kullanarak yükseltme.

Anahtar	Örnek değer
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS	`0`

WEBSITE_RUN_FROM_PACKAGE

İşlev uygulamanızın yerel olarak bağlanabilen veya bir dış URL'ye dağıtılabilen bir paket dosyasından çalışmasını sağlar.

Anahtar	Örnek değer
WEBSITE_RUN_FROM_PACKAGE	`1`

Geçerli değerler, bir dış dağıtım paketi dosyasının konumuna çözümleyen bir URL'dir veya 1. olarak ayarlandığında 1, paketin d:\home\data\SitePackages klasöründe olması gerekir. Zip dağıtımını etkin olarak WEBSITE_RUN_FROM_PACKAGE kullandığınızda paket otomatik olarak bu konuma yüklenir. Önizlemede bu ayar olarak adlandırılmıştır WEBSITE_RUN_FROM_ZIP. Daha fazla bilgi için bkz . İşlevlerinizi paket dosyasından çalıştırma.

Dış paket URL'sinden dağıttığınızda tetikleyicileri de el ile eşitlemeniz gerekir. Daha fazla bilgi için bkz . Tetikleyici eşitleme.

WEBSITE_SKIP_CONTENTSHARE_VALIDATION

WEBSITE_CONTENTAZUREFILECONNECTIONSTRING ve WEBSITE_CONTENTSHARE ayarları, uygulamanın düzgün şekilde başlatılabilmesini sağlamak için ek doğrulama denetimlerine sahiptir. İşlev uygulaması ağ kısıtlamaları veya diğer sınırlayıcı faktörler nedeniyle aşağı akış Depolama Hesabı veya Key Vault'u düzgün şekilde çağıramadığında uygulama ayarlarının oluşturulması başarısız olur. WEBSITE_SKIP_CONTENTSHARE_VALIDATION olarak ayarlandığında 1doğrulama denetimi atlanır; aksi takdirde değer varsayılan 0 olarak ayarlanır ve doğrulama gerçekleşir.

Anahtar	Örnek değer
WEBSITE_SKIP_CONTENTSHARE_VALIDATION	`1`

Doğrulama atlanırsa ve bağlantı dizesi veya içerik paylaşımı geçerli değilse, uygulama düzgün başlatılamaz. Bu durumda işlevler HTTP 500 hataları döndürür. Daha fazla bilgi için bkz. Sorun giderme hatası: "Azure İşlevleri Çalışma Zamanı ulaşılamıyor"

WEBSITE_SLOT_NAME

Salt okunur. Geçerli dağıtım yuvasının adı. Üretim yuvasının adı şeklindedir Production.

Anahtar	Örnek değer
WEBSITE_SLOT_NAME	`Production`

WEBSITE_TIME_ZONE

İşlev uygulamanız için saat dilimini ayarlamanıza olanak tanır.

Anahtar	OS	Örnek değer
WEBSITE_TIME_ZONE	Windows	`Eastern Standard Time`
WEBSITE_TIME_ZONE	Linux	`America/New_York`

CRON ifadeleriyle kullanılan varsayılan saat dilimi Eşgüdümlü Evrensel Saat'tir (UTC). CRON ifadenizin başka bir saat dilimine dayalı olmasını sağlamak için işlev uygulamanız için adlı WEBSITE_TIME_ZONEbir uygulama ayarı oluşturun.

Bu ayarın değeri, işlev uygulamanızın üzerinde çalıştırıldığı işletim sistemine ve plana bağlıdır.

İşletim sistemi	Planlama	Değer
Windows	Tümü	Değeri, Windows komutu tarafından verilen her çiftten ikinci satır tarafından verilen istenen saat diliminin adına ayarlayın `tzutil.exe /L`
Linux	Premium Ayrılmış	değeri, tz veritabanında gösterildiği gibi istenen saat diliminin adına ayarlayın.

Not

WEBSITE_TIME_ZONE ve TZ şu anda Bir Tüketim planında Linux üzerinde çalışırken desteklenmez. Bu durumda, SSL ile ilgili sorunları ayarlamak WEBSITE_TIME_ZONE veya TZ oluşturmak ve ölçümlerin uygulamanız için çalışmayı durdurmasına neden olabilir.

Örneğin, ABD'de Doğu Saati ((Windows) veya America/New_York (Linux) ile Eastern Standard Time temsil edilir) şu anda standart saat sırasında UTC-05:00 ve yaz saati sırasında UTC-04:00 kullanır. Zamanlayıcı tetikleyicisinin her gün doğu saatiyle 10:00'da tetikleyebilmek için işlev uygulamanız için adlı WEBSITE_TIME_ZONEbir uygulama ayarı oluşturun, değeri Eastern Standard Time (Windows) veya America/New_York (Linux) olarak ayarlayın ve aşağıdaki NCRONTAB ifadesini kullanın:

"0 0 10 * * *"

Kullandığınızda WEBSITE_TIME_ZONE saat, gün ışığından yararlanma saati ve standart saat değişiklikleri de dahil olmak üzere belirli bir saat dilimindeki saat değişiklikleri için ayarlanır.

WEBSITE_USE_PLACEHOLDER

Tüketim planında çalışırken belirli bir soğuk başlangıç iyileştirmesinin kullanılıp kullanılmayacağını gösterir. 0 Tüketim planında soğuk başlangıç iyileştirmesini devre dışı bırakmak için olarak ayarlayın.

Anahtar	Örnek değer
WEBSITE_USE_PLACEHOLDER	`1`

WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED

Tüketim planında .NET yalıtılmış çalışan işlemi işlevlerini çalıştırırken belirli bir soğuk başlangıç iyileştirmesinin kullanılıp kullanılmayacağını gösterir. 0 Tüketim planında soğuk başlangıç iyileştirmesini devre dışı bırakmak için olarak ayarlayın.

Anahtar	Örnek değer
WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED	`1`

WEBSITE_VNET_ROUTE_ALL

Önemli

WEBSITE_VNET_ROUTE_ALL, vnetRouteAllEnabled site ayarıyla değiştirilen eski bir uygulama ayarıdır.

Uygulamadan gelen tüm giden trafiğin sanal ağ üzerinden yönlendirilip yönlendirmediğini gösterir. ayarı değeri 1 , tüm trafiğin sanal ağ üzerinden yönlendirildiğini gösterir. Bölgesel sanal ağ tümleştirme özelliklerini kullanırken bu ayara ihtiyacınız vardır. Statik bir giden IP adresi tanımlamak için bir sanal ağ NAT ağ geçidi kullanıldığında da kullanılır.

Anahtar	Örnek değer
WEBSITE_VNET_ROUTE_ALL	`1`

WEBSITES_ENABLE_APP_SERVICE_STORAGE

Dizinin, varsayılan değeri trueolan ölçeklendirilmiş örnekler arasında paylaşılıp paylaşılmadığını /home gösterir. İşlev uygulamanızı bir kapsayıcıya dağıtırken bunu olarak false ayarlamanız gerekir. d

App Service site ayarları

Bazı yapılandırmalar, dil sürümleri gibi site ayarları olarak App Service düzeyinde tutulmalıdır. Bu ayarlar portalda REST API'leri veya Azure CLI ya da Azure PowerShell kullanılarak yönetilir. Çalışma zamanı dilinize, işletim sisteminize ve sürümlerinize bağlı olarak gerekli olabilecek site ayarları şunlardır:

Alwayson

Ayrılmış (App Service) planında çalışan bir işlev uygulamasında, işlev çalışma zamanı birkaç dakika etkinlik dışı kaldığında boşta olur ve bu noktada yalnızca HTTP istekleri işlevlerinizi uyandırır. HTTP ile tetiklenmeyen işlevlerinizin (Zamanlayıcı tetikleyicisi dahil) düzgün çalıştığından emin olmak için, site ayarını değerine trueayarlayarak alwaysOn işlev uygulaması için Always On'u etkinleştirin.

linuxFxVersion

Linux üzerinde çalışan işlev uygulamaları için dile linuxFxVersion özgü çalışan işleminin dilini ve sürümünü gösterir. Bu bilgiler, işlev uygulamanızı çalıştırmak için hangi Linux kapsayıcı görüntüsünün yüklendiğini belirlemek için ile FUNCTIONS_EXTENSION_VERSIONbirlikte kullanılır. Bu ayar önceden tanımlanmış bir değere veya özel görüntü URI'sine ayarlanabilir.

Bu değer, Linux işlev uygulamanızı oluştururken sizin için ayarlanır. ARM şablonu ve Bicep dağıtımları için ve belirli yükseltme senaryolarında ayarlamanız gerekebilir.

Geçerli linuxFxVersion değerleri

Desteklenen İşlevler çalışma zamanı sürümüne göre geçerli linuxFxVersion değerlerin tablosunu görmek için aşağıdaki Azure CLI komutunu kullanabilirsiniz:

az functionapp list-runtimes --os linux --query "[].{stack:join(' ', [runtime, version]), LinuxFxVersion:linux_fx_version, SupportedFunctionsVersions:to_string(supported_functions_versions[])}" --output table

Önceki komut, Azure CLI'nın 2.40 sürümüne yükseltmenizi gerektirir.

Özel görüntüler

İşlev uygulamanız için kendi özel Linux kapsayıcınızı oluşturduğunuzda ve bakımını yaptığınızda, linuxFxVersion değer aşağıdaki örnekte olduğu gibi biçiminde DOCKER|<IMAGE_URI>olur:

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

Bu, dağıtılan kapsayıcının kayıt defteri kaynağını gösterir. Daha fazla bilgi için bkz. Kapsayıcılarla çalışma ve Azure İşlevleri.

Önemli

Kendi kapsayıcılarınızı oluştururken kapsayıcınızın temel görüntüsünü desteklenen en son temel görüntüye güncel tutmanız gerekir. Azure İşlevleri için desteklenen temel görüntüler dile özgü olup Azure İşlevleri temel görüntü depolarında bulunur.

İşlevler ekibi, bu temel görüntüler için aylık güncelleştirmeleri yayımlamaya kararlıdır. Düzenli güncelleştirmeler, hem İşlevler çalışma zamanı hem de diller için en son ikincil sürüm güncelleştirmelerini ve güvenlik düzeltmelerini içerir. Kapsayıcınızı düzenli olarak en son temel görüntüden güncelleştirmeli ve kapsayıcınızın güncelleştirilmiş sürümünü yeniden dağıtmalısınız.

netFrameworkVersion

C# işlevleri için belirli bir .NET sürümünü ayarlar. Daha fazla bilgi için bkz . Azure'da işlev uygulamanızı güncelleştirme.

powerShellVersion

İşlevlerinizin üzerinde çalıştığı PowerShell'in belirli bir sürümünü ayarlar. Daha fazla bilgi için bkz . PowerShell sürümünü değiştirme.

Yerel olarak çalışırken, bunun yerine local.settings.json dosyasındaki ayarı kullanırsınız FUNCTIONS_WORKER_RUNTIME_VERSION .

vnetrouteallenabled

Bu site ayarı eski WEBSITE_VNET_ROUTE_ALL ayarının yerini alır.

Sonraki adımlar

Uygulama ayarlarını güncelleştirme hakkında bilgi edinin

host.json dosyasında yapılandırma ayarlarına bakın

App Service uygulamaları için diğer uygulama ayarlarına bakın