Aracılığıyla paylaş

Azure İşlevleri için uygulama ayarları başvuru rehberi

İş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.

Azure İşlevleri barındırma için Azure App Service platformunu kullanır. İşlev uygulamanızı Azure App Service'teki Ortam değişkenlerinde ve uygulama ayarlarında barındırmayla ilgili bazı ayarlar bulabilirsiniz.

Uygulama ayarında dikkat edilmesi gerekenler

Uygulama ayarlarını kullanırken aşağıdaki önemli noktaların farkında olmanız gerekir:

  • Uygulama ayarlarının değiştirilmesi, işlev uygulamanızın tüm barındırma planlarına göre varsayılan olarak yeniden başlatılmasına neden olur. Ayarları değiştirirken sıfır kapalı kalma süresi dağıtımları için Esnek Tüketim planını, site güncelleştirme stratejisi olarak sıralı güncelleştirmeler ile birlikte kullanın. Diğer barındırma planları için kesinti süresini en aza indirme rehberi için dağıtımları iyileştirme sayfasına bakın.

  • Adları ayarlarken, çift alt çizgi (__) ve iki nokta (:) ayrılmış değerler olarak görülür. Çift alt çizgi, hem Windows hem de Linux'ta hiyerarşik sınırlayıcılar olarak yorumlanır. İki nokta yalnızca Windows'ta aynı şekilde 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, Values içindeki local.settings.json uygulama ayarları koleksiyonunda belirtilir.

  • 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 yaklaşım, 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 yaklaşım, 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 okunur App Service uygulama ayarlarını değiştirmek, işlev uygulamanızın yanıt vermemesi durumuna neden olabilir.

  • 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

Application Insights için enstrümantasyon anahtarı. hem APPINSIGHTS_INSTRUMENTATIONKEYhem de APPLICATIONINSIGHTS_CONNECTION_STRING kullanmayın. Mümkün olduğunda kullanın APPLICATIONINSIGHTS_CONNECTION_STRING. Application Insights bağımsız bir bulutta çalıştırıldığında kullanmanız APPLICATIONINSIGHTS_CONNECTION_STRINGgerekir. Daha fazla bilgi için bkz. Azure İşlevleri için izlemeyi yapılandırma.

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

hem APPINSIGHTS_INSTRUMENTATIONKEYhem de APPLICATIONINSIGHTS_CONNECTION_STRING kullanmayın. kullanmanızı APPLICATIONINSIGHTS_CONNECTION_STRINGöneririz.

APPLICATIONINSIGHTS_AUTHENTICATION_STRING

Microsoft Entra kimlik doğrulamasını kullanarak Application Insights'a erişimi etkinleştirir. Microsoft Entra kimlik doğrulamasını kullanarak Application Insights çalışma alanınıza bağlanmanız gerektiğinde bu ayarı kullanın. Daha fazla bilgi için bkz . Application Insights için Microsoft Entra kimlik doğrulaması.

kullandığınızda APPLICATIONINSIGHTS_AUTHENTICATION_STRING, ayarladığınız belirli değer yönetilen kimliğin türüne bağlıdır:

İdare edilen kimlik Ayar değeri
System-assigned Authorization=AAD
User-assigned Authorization=AAD;ClientId=<USER_ASSIGNED_CLIENT_ID>

Bu kimlik doğrulama gereksinimi İşlevler ana bilgisayarı, anlık görüntü hata ayıklayıcısı, profil oluşturucu ve dile özgü aracılardan gelen bağlantılara uygulanır. Bu ayarı kullanmak için yönetilen kimliğin, İzleme Ölçümleri Yayımcısı'na eşdeğer atanmış bir rolle işlev uygulaması tarafından zaten kullanılabilir olması gerekir.

Note

APPLICATIONINSIGHTS_AUTHENTICATION_STRING Microsoft Entra kimlik doğrulamasını kullanarak Application Insights'a bağlanırken, Application Insights için yerel kimlik doğrulamasını da devre dışı bırakmanız gerekir. Bu yapılandırma, telemetrinin çalışma alanınıza alınması için Microsoft Entra kimlik doğrulaması gerektirir.

APPLICATIONINSIGHTS_CONNECTION_STRING

Application Insights için bağlantı dizesi. hem APPINSIGHTS_INSTRUMENTATIONKEYhem de APPLICATIONINSIGHTS_CONNECTION_STRING kullanmayın. APPLICATIONINSIGHTS_CONNECTION_STRING'ı her durumda kullanmanızı öneririz. Bu, aşağıdaki durumlarda bir gereksinimdir:

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

Daha fazla bilgi için bkz . Bağlantı dizeleri.

Key Örnek değer
APPLICATIONINSIGHTS_CONNECTION_STRING InstrumentationKey=...

Microsoft Entra kimlik doğrulaması ile Application Insights'a bağlanmak için kullanmanız APPLICATIONINSIGHTS_AUTHENTICATION_STRINGgerekir.

AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL

Important

Azure İşlevleri proxy'leri, Azure İşlevleri çalışma zamanının 1.x ile 3.x sürümleri arasında bir özellikti. Daha fazla bilgi için bkz . İşlev proxy'leri.

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES

Important

Azure İşlevleri proxy'leri, Azure İşlevleri çalışma zamanının 1.x ile 3.x sürümleri arasında bir özellikti. 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ır. Bu değer başlatma sırasında okunur. Çalışma zamanı yalnızca şu değerleri kabul eder:

Value Description
Production Azaltılmış günlük kaydı ve tam performans iyileştirmeleri ile bir üretim ortamını temsil eder. Bu değer, ayarlanmamışsa veya desteklenmeyen bir değere ayarlandığında varsayılan AZURE_FUNCTIONS_ENVIRONMENT değerdir.
Staging Bir hazırlama yuvasında çalışırken olduğu gibi bir hazırlama ortamını temsil eder.
Development Geliştirme ortamları, daha ayrıntılı günlük tutma ve düşük performans optimizasyonlarını destekler. Azure İşlevleri Core Tools, yerel bilgisayarınızda çalışırken AZURE_FUNCTIONS_ENVIRONMENT değerini Development olarak ayarlar. Bu ayar local.settings.json dosyasında geçersiz kılınamaz.

Azure'daki ASPNETCORE_ENVIRONMENT çalışma zamanı ortamını Production haricinde başka bir şeyle değiştirmek istediğinizde, onun yerine bu ayarı kullanın. Daha fazla bilgi için bkz. Ortam Tabanlı Başlangıç Sınıfı ve Metotlar.

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 AzureFunctionsJobHost__path__to__setting adlı uygulama ayarları olarak ifade edilir. Daha fazla bilgi için bkz. host.json değerlerini geçersiz kılma.

AzureFunctionsWebHost__hostid

Verilen 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, bir GUID almak, tireleri kaldırmak ve küçük harfe dönüştürmek, örneğin GUID 1835D7B5-5C98-4790-815D-072CC94C6F71 değerini 1835d7b55c984790815d072cc94c6f71 değerine dönüştürmektir.

Key Ö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 Azure portalındaki İ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 . Depolama hesabı gereksinimleri.

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

Key Örnek değer
AzureWebJobsDisableHomepage true

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

İşlev Uygulaması giriş sayfasını gösteren ekran görüntüsü.

AzureWebJobsDotNetReleaseCompilation

true, .NET kodunu derlerken Release kullanım modunun kullanılması anlamına gelir. false hata ayıklama modunu kullanma anlamına gelir. Varsayılan true değeridir.

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

Key Örnek değer
AzureWebJobsFeatureFlags feature1,feature2,EnableProxies

Uygulamanızda şu anda bu ayar varsa, virgülle ayrılmış listenin sonuna yeni bayraklar ekleyin.

Şu anda desteklenen özellik bayrakları:

Bayrak değeri Description
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ştirir. Daha fazla bilgi için bkz İşlevler v4.x'te proxy'leri yeniden etkinleştir.
EnableAzureMonitorTimeIsoFormat ISO 8601 Ayrılmış (App Service) planında çalışan Linux uygulamaları için Azure İzleyici günlüklerinde zaman biçimini etkinleştirir.

AzureWebJobsKubernetesSecretName

Anahtarları depolamak için kullanılan Kubernetes Secret kaynağını belirtir. Yalnızca Kubernetes'te çalışırken desteklenir.

Key Örnek değer
AzureWebJobsKubernetesSecretName <SECRETS_RESOURCE>

Kubernetes Secrets kaynağını kullanırken dikkate alınması gerekenler:

  • AzureWebJobsSecretStorageType ayrıca kubernetes olarak ayarlamanız gerekir. 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.
  • Değişmez sırlar desteklenmez ve bunları kullanmak çalışma zamanı hatalarına neden olur.

Daha fazla bilgi edinmek için bkz . Anahtar depolamayı yönetme.

AzureWebJobsSecretStorageKeyVaultClientId

Kullanıcı atamalı yönetilen kimliğin istemci kimliği veya anahtarların depolandığı kasaya erişmek için kullanılan uygulama kayıt bilgileri. Bu ayar, AzureWebJobsSecretStorageType öğesini keyvault olarak ayarlamanızı gerektirir. İşlevler çalışma zamanının 4.x ve sonraki sürümlerinde desteklenir.

Key Örnek değer
AzureWebJobsSecretStorageKeyVaultClientId <CLIENT_ID>

Daha fazla bilgi edinmek için bkz . Anahtar depolamayı yönetme.

AzureWebJobsSecretStorageKeyVaultClientSecret

Kullanıcı tarafından atanan yönetilen kimliğin istemci kimliği için gizli bilgi veya anahtarların depolandığı kasaya erişim sağlamak amacıyla kullanılan uygulama kaydı. Bu ayar, AzureWebJobsSecretStorageType öğesini keyvault olarak ayarlamanızı gerektirir. İşlevler çalışma zamanının 4.x ve sonraki sürümlerinde desteklenir.

Key Örnek değer
AzureWebJobsSecretStorageKeyVaultClientSecret <CLIENT_SECRET>

Daha fazla bilgi edinmek için bkz . Anahtar depolamayı yönetme.

AzureWebJobsSecretStorageKeyVaultName

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

Anahtarları depolamak için kullanılan bir anahtar kasası örneğinin adı. Bu ayar yalnızca İşlevler çalışma zamanının artık desteklenmeyen 3.x sürümünde kullanılmıştır. Sürüm 4.x için bunun yerine kullanın AzureWebJobsSecretStorageKeyVaultUri. Bu ayar, AzureWebJobsSecretStorageType öğesini keyvault olarak ayarlamanızı gerektirir.

Kasada, barındırma kaynağına atanmış sistem yönetimli kimliğe karşılık gelen bir erişim politikası olmalıdır. Erişim ilkesi kimliğe şu gizli dizi izinlerini vermelidir: Get, Set, List, ve Delete.

İşlevleriniz yerel olarak çalıştırıldığında geliştirici kimliği kullanılır. Ayarlar local.settings.json dosyasında olmalıdır.

Key Örnek değer
AzureWebJobsSecretStorageKeyVaultName <VAULT_NAME>

Daha fazla bilgi edinmek için bkz . Anahtar depolamayı yönetme.

AzureWebJobsSecretStorageKeyVaultTenantId

Anahtarların depolandığı kasaya erişimde kullanılan uygulama kaydının kiracı kimliği. Bu ayar, AzureWebJobsSecretStorageType öğesini keyvault olarak ayarlamanızı gerektirir. İşlevler çalışma zamanının 4.x ve sonraki sürümlerinde desteklenir. Daha fazla bilgi edinmek için bkz . Anahtar depolamayı yönetme.

Key Örnek değer
AzureWebJobsSecretStorageKeyVaultTenantId <TENANT_ID>

AzureWebJobsSecretStorageKeyVaultUri

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. Anahtar depolama için bir anahtar kasası örneği kullanmak için bu ayarı öneririz. Bu ayar, AzureWebJobsSecretStorageType öğesini keyvault olarak ayarlamanızı gerektirir.

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

Kasada, barındırma kaynağına atanmış sistem yönetimli kimliğe karşılık gelen bir erişim politikası olmalıdır. Erişim ilkesi kimliğe şu gizli dizi izinlerini vermelidir: Get, Set, List, ve 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.

Key Örnek değer
AzureWebJobsSecretStorageKeyVaultUri https://<VAULT_NAME>.vault.azure.net

Important

B secrets'' tr-TR: Gizli bilgiler, AzureWebJobsSecretStorageKeyVaultUri ayarı ile tek tek işlev uygulamalarıyla sınırlı değildir. Birden çok işlev uygulaması aynı Key Vault'u kullanacak şekilde yapılandırılmışsa, bunlar aynı sırları paylaşır, büyük olasılıkla anahtar çakışmalarına veya üzerine yazmalara yol açar. İstenmeyen davranışı önlemek için her işlev uygulaması için ayrı bir Key Vault örneği kullanmanızı öneririz.

Daha fazla bilgi edinmek için bkz . Anahtar Depolamayı Yönetme.

AzureWebJobsSecretStorageSas

Anahtarların depolanması için kullanılan ikinci depolama hesabına ait Blob Depolama SAS URL'si. İşlevler varsayılan olarak içinde AzureWebJobsStorageayarlanan hesabı kullanır. Bu gizli depolama seçeneğini kullanırken, AzureWebJobsSecretStorageType'ın açıkça ayarlanmadığından veya blob olarak ayarlandığından emin olun. Daha fazla bilgi edinmek için bkz . Anahtar depolamayı yönetme.

Key Örnek değer
AzureWebJobsSecretStorageSas <BLOB_SAS_URL>

AzureWebJobsSecretStorageType

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.

Key Value Description
AzureWebJobsSecretStorageType blob Anahtarlar, AzureWebJobsStorage ayarı ile sağlanan hesaptaki bir Blob depolama kapsayıcısında 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 .
AzureWebJobsSecretStorageType files Anahtarlar dosya sisteminde kalıcıdır. Bu davranış, İşlevler v1.x için varsayılandır.
AzureWebJobsSecretStorageType keyvault AzureWebJobsSecretStorageKeyVaultName tarafından ayarlanan bir anahtar kasası örneğinde anahtarlar depolanır.
AzureWebJobsSecretStorageType 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 . Anahtar depolamayı yönetme.

AzureWebJobsStorage

Azure Depolama hesabının, fonksiyonlar çalışma zamanının normal işlemleri için kullandığı bağlantı dizesini 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 . Depolama hesabı gereksinimleri.

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

AzureWebJobsStorage__accountName

Kimlik tabanlı depolama bağlantısı kullanıldığında, AzureWebJobsStorage içindeki bağlantı dizesi 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.

Key Örnek değer
AzureWebJobsStorage__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.

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

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

AzureWebJobsStorage__clientId

Yönetilen kimlik kimlik doğrulaması için erişim belirteci almak için kullanılan belirli bir kullanıcı tarafından atanan kimliğin istemci kimliğini ayarlar. gerektirir ki AzureWebJobsStorage__credential, managedidentity olarak ayarlansın. Değer, uygulamaya atanmış bir kimliğe karşılık gelen bir istemci kimliğidir. hem AzureWebJobsStorage__managedIdentityResourceIdhem de AzureWebJobsStorage__clientId ayarlayamazsınız. Ayarlanmadığında, sistem tarafından atanan kimlik kullanılır.

AzureWebJobsStorage__credential

Bağlantı için erişim belirtecinin nasıl alınlendiğini tanımlar. Yönetilen kimlik kimlik doğrulaması için kullanın managedidentity . managedidentity kullanırken, barındırma ortamında bir yönetilen kimlik mevcut olmalıdır. Lokal geliştirme senaryolarında AzureWebJobsStorage__credential ayarlaması yapmayın.

AzureWebJobsStorage__managedIdentityResourceId

Kullanıcı tarafından atanan kimliğin, yönetilen kimlik kimlik doğrulaması için erişim belirteci almak amacıyla kullanılan kaynak tanımlayıcısını ayarlar. gerektirir ki AzureWebJobsStorage__credential, managedidentity olarak ayarlansın. Değer, yönetilen kimlik kimlik doğrulaması için kullanılan uygulamaya atanmış kimliğin kaynak kimlik numarasıdır. hem AzureWebJobsStorage__managedIdentityResourceIdhem de AzureWebJobsStorage__clientId ayarlayamazsınız. Ayarlanmadığında, sistem tarafından atanan kimlik kullanılır.

AzureWebJobsStorage__queueServiceUri

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

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

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

AzureWebJobsStorage__tableServiceUri

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

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

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

AzureWebJobs_TypeScriptPath

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

Key Örnek değer
AzureWebJobs_TypeScriptPath %HOME%\typescript

DOCKER_REGISTRY_SERVER_PASSWORD

Özel konteyner kayıt deposuna erişim için kullanılan şifreyi 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 bir 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 merkezine 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.

Key Örnek değer
DOCKER_SHM_SIZE 268435456

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

FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED ayarının 1 olarak ayarlanması gerektiğini gerektirir.

ENABLE_ORYX_BUILD

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

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

Key Örnek değer
FUNCTION_APP_EDIT_MODE readonly

Çalışma zamanı değeri işlev uygulamanızın dil yığınına ve dağıtım durumuna göre ayarlar. 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, ~4) kullanmak anlamına gelir. Aynı ana sürümün yeni ikincil sürümleri kullanılabilir olduğunda, bunlar işlev uygulamasına otomatik olarak yüklenir.

Key Örnek değer
FUNCTIONS_EXTENSION_VERSION ~4

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

Value Çalışma zamanı hedefi Comment
~4 4.x Recommended
~1 1.x Destek 14 Eylül 2026'da sona eriyor

değeri ~4 , uygulamanızın çalışma zamanının 4.x sürümünde çalıştığı anlamına gelir. ~1 değeri, uygulamanızı çalışma zamanının 1.x sürümüne sabitler. Çalışma zamanı 2.x ve 3.x sürümleri artık desteklenmiyor. Daha fazla bilgi için bkz. Azure İşlevleri çalışma zamanı sürümlerine genel bakış.

Destek tarafından uygulamanızı belirli bir ikincil sürüme sabitlemek için istenirse, tam sürüm numarasını kullanın, örneğin. 4.0.12345 Daha fazla bilgi için bkz. Azure İşlevleri çalışma zamanı sürümlerinin hedefini belirleme.

FUNCTIONS_INPROC_NET8_ENABLED

Bir uygulamanın işlem içi modelde .NET 8 kullanıp kullanamayacağını gösterir. İşlem içi modelde .NET 8 kullanmak için bu değer olarak 1ayarlanmalıdır. Diğer gerekli yapılandırma değerleri de dahil olmak üzere tüm yönergeler için bkz . Hedef .NET 8'e güncelleştirme.

Key Örnek değer
FUNCTIONS_INPROC_NET8_ENABLED 1

0 İşlem içi modelde .NET 8 desteğini devre dışı bırakmak için olarak ayarlayın.

FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR

Bu uygulama ayarı, Node.js uygulamalarında giriş noktası hatalarını Node.js v18 veya daha düşük bir sürümde gidermeyi kolaylaştıran önemli bir değişikliği etkinleştirmenin geçici bir yoludur. Programlama modeli v4 uygulamaları, özellikle her zaman giriş noktası dosyalarını kullandıkları için, true kullanmanızı şiddetle tavsiye ederiz. Hataya neden olan değişiklik (false) olmadan oluşan davranış, giriş noktası hatalarını yoksayar ve Bunları Application Insights'ta günlüğe kaydetmez.

Node.js v20'den itibaren, uygulama ayarı etkisiz hale gelmiştir ve bozucu değişiklik davranışı her zaman etkinleştirilmiştir.

v18 veya daha düşük Node.js için uygulama ayarı kullanılır 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, varsayılan davranış ile eşleşir false. Örneğin, v3 modelini kullanıyorsanız veya giriş noktası dosyanız yoksa.
  • Hata sonrasında oluşursa, varsayılan davranış ile eşleşir true. Örneğin, yinelenen model v4 işlevlerini kaydetmeye çalışırsanız.
Key Value Description
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR true Giriş noktası hatalarını engelleyin ve bunları Application Insights'ta kaydedin.
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR false Giriş noktalarındaki hataları önemsemeyin ve Application Insights'a kaydetmeyin.

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 istek boyutu üst sınırı 104.857.600 bayttır.

Key Örnek değer
FUNCTIONS_REQUEST_BODY_SIZE_LIMIT 250000000

FUNCTIONS_V2_COMPATIBILITY_MODE

Important

Bu ayar artık desteklenmiyor. Başlangıçta v2.x çalışma zamanını hedefleyen uygulamalar için kısa vadeli bir geçici çözüm sağlamak için sağlanmıştır. Bunun yerine, alternatif olarak, desteklenmeye devam ettiği sürece v3.x çalışma ortamında çalıştırabilirler. 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_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, FUNCTIONS_WORKER_PROCESS_COUNT tarafından 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.

Key Örnek değer
FUNCTIONS_WORKER_PROCESS_COUNT 2

FUNCTIONS_WORKER_RUNTIME

İşlev uygulamasına yüklenmesi gereken çalışan çalışma zamanının dil veya dil yığını. Bu değer, 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.

Key Örnek değer
FUNCTIONS_WORKER_RUNTIME node

Geçerli değerler:

Value 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 Other

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.

Key Ö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_APPLICATIONINSIGHTS_ENABLE_TELEMETRY

Java çalışan işleminin Telemetriyi Application Insights uç noktasına Açık Telemetri biçiminde çıkarıp çıkarmayacağını gösterir. Bu bayrağı, İşlevler ana bilgisayarına True , Java çalışanlarının OpenTelemetry günlüklerini doğrudan akışla aktarmasına izin vermesini bildirir ve bu da yinelenen konak düzeyinde girişleri engeller. Daha fazla bilgi için bkz . Uygulama ayarlarını yapılandırma.

JAVA_ENABLE_SDK_TYPES

İşlev uygulamanızın bağlamalarda yerel Azure SDK türlerini kullanmasını sağlar.

Note

SDK türlerine bağlama desteği şu anda önizleme aşamasındadır ve Azure Blob Depolama SDK'sı ile sınırlıdır. Daha fazla bilgi için Java başvuru makalesindeki SDK türleri bölümüne bakın.

Key Örnek değer
JAVA_ENABLE_SDK_TYPES true

Daha fazla bilgi için Java başvuru makalesindeki SDK türleri bölümüne bakın.

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.

languageWorkers__java__arguments

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 başlangıçtan sonra her MDMaxBackgroundUpgradePeriod seferinde PowerShell Galerisi'nde modül yükseltmelerini denetlemeye başlar. 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 ağ G/Ç, CPU ve depolama gibi uygulama kaynak kullanımını da artırır. 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.

Key Ö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ı, geçerli işlev yürütmeyi kesintiye uğratabileceğinden uygulamanızın kullanılabilirliğini etkiler. 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ı MDNewSnapshotCheckPeriod içinde tamamlanır.

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.

Key Örnek değer
MDNewSnapshotCheckPeriod 01:00:00

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

MDMinBackgroundUpgradePeriod

Önceki bir yönetilen bağımlılık yükseltme denetiminden sonraki, başka bir yükseltme denetimi başlatılmadan önce geçen süre, varsayılan olarak 1.00:00:00 (günlük).

Çalışanların sık sık yeniden başlatılmaları durumunda aşırı modül yükseltmelerini önlemek için, herhangi bir çalışan son MDMinBackgroundUpgradePeriod içinde bu denetlemeyi zaten başlattıysa modül yükseltmelerinin kontrolü gerçekleştirilmez.

Key Örnek değer
MDMinBackgroundUpgradePeriod 1.00:00:00

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

OTEL_EXPORTER_OTLP_ENDPOINT

OpenTelemetry biçimli verilerin alımı için dışarı aktarıldığı URL'yi gösterir. Daha fazla bilgi için Azure İşlevleri ile OpenTelemetry kullanma bölümüne bakın.

OTEL_EXPORTER_OTLP_HEADERS

OpenTelemetry uç noktasına dışarı aktarılan tüm giden verilere uygulanan isteğe bağlı bir üst bilgi listesi ayarlar. OpenTelemetry uç noktasının bir API anahtarı sağlaması gerektiğinde bu ayarı kullanmanız gerekir. Daha fazla bilgi için Azure İşlevleri ile OpenTelemetry kullanma bölümüne bakın.

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.

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

Daha fazla bilgi edinmek için pip belgelerine ve Python geliştirici referansında --index-url bölümüne bakın.

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.

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

Daha fazla bilgi edinmek için pip belgelerine ve Python geliştirici başvurusundaki --extra-index-url kısmına bakın.

PROJECT

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

Key Örnek değer
PROJECT WebProject/WebProject.csproj

PYTHON_APPLICATIONINSIGHTS_ENABLE_TELEMETRY

Python çalışan işleminin Telemetri verilerini Application Insights uç noktasına Açık Telemetri biçiminde çıkarıp çıkarmayacağını gösterir. Bu bayrağı, İşlevler ana bilgisayarına True Python çalışan işleminin OpenTelemetry verilerini Application Insights uç noktasına aktarmasına izin vermesini bildirir. Daha fazla bilgi için bkz . Uygulama ayarlarını yapılandırma.

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.

Key Value Description
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'de tanımlanan Microsoft dışı 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 değer, kitaplıklarınızın iç Python çalışanlarının kitaplıklarıyla çakışmasını engeller.

PYTHON_ENABLE_DEBUG_LOGGING

Python işlev uygulamasında debug düzeyinde günlük kaydı yapmayı etkinleştirir. 1 değeri, hata ayıklama düzeyinde kaydı etkinleştirir. Bu ayar olmadan veya değeri 0 ile yalnızca bilgi ve daha üst düzeydeki günlükler Python çalışanından Functions sunucusuna 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_OPENTELEMETRY

Python çalışan işleminin telemetriyi Açık Telemetri uç noktasına dışarı aktarması gerekip gerekmediğini gösterir. bu bayrağı İşlevler ana bilgisayarına True Python çalışan işleminin OpenTelemetry verilerini yapılandırılmış OTEL_EXPORTER_OTLP_ENDPOINT dışarı aktarmasına izin vermesini bildirir. Daha fazla bilgi için bkz . Uygulama ayarlarını yapılandırma.

PYTHON_ENABLE_WORKER_EXTENSIONS

Yapılandırma Python işlev uygulamalarına özgüdür. Bu değeri 1 olarak ayarlamak, işçinin requirements.txtbölgesinde tanımlanan Python işçi uzantılarını yüklemesine olanak tanır. İşlev uygulamanızın iş ortağı paketleri 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. Seçtiğiniz uzantının güvenilir olduğundan emin olun, çünkü kullanma riski size aittir. Azure İşlevleri hiçbir uzantı için açık garanti vermemektedir. Uzantıyı kullanma hakkında bilgi için uzantının kılavuz sayfasını veya readme belgesini ziyaret edin. Varsayılan olarak, bu değer 0 olarak ayarlanır.

Key Value Description
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 işçisinin işlev çağrılarını yürütmek için kullanacağı maksimum iş parçacığı sayısını, Python sürümü 1 ve altı için varsayılan değer 3.8 ile belirtir. Python sürümü 3.9 ve üzeri için, değer None olarak ayarlanır. Bu ayar, çalıştırmalar sırasında ayarlanacak olan 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.

Key Ö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 Ölçek denetleyici günlükleri.

Key Örnek değer
SCALE_CONTROLLER_LOGGING_ENABLED AppInsights:Verbose

Bu anahtarın değeri <DESTINATION>:<VERBOSITY> biçiminde, şu şekilde tanımlanmıştır:

Property Description
<DESTINATION> Günlüklerin gönderildiği hedef. Geçerli değerler: AppInsights ve Blob.
AppInsights kullandığınızda, fonksiyon uygulamanızda Application Insights'ın etkinleştirildiğinden emin olun.
Hedefi Blob olarak ayarladığınızda, günlükler uygulama ayarında belirtilen varsayılan depolama hesabında azure-functions-scale-controller adlı bir blob kapsayıcısında oluşturulur.
<VERBOSITY> Günlük düzeyini belirtir. Desteklenen değerler , Noneve WarningdeğerleridirVerbose.
olarak Verbose ayarlandığında, ölçek denetleyicisi, çalışan sayısındaki her değişikliğin nedenini ve bu kararlara etki eden tetikleyiciler hakkında 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.

Tip

Ölçek denetleyicisinin günlüğünü etkin bıraktığınızda, bu durum, işlev uygulamanızı izlemenin olası maliyetlerini etkileyebilir. Ö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.

Key Örnek değer
SCM_DO_BUILD_DURING_DEPLOYMENT true

SCM_LOGSTREAM_TIMEOUT

Akış loglarına bağlanıldığında zaman aşımını saniye cinsinden denetler. Varsayılan değer 7200'dür (2 saat).

Key Ö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'nde 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ğlantı dizesi. Daha fazla bilgi için Depolama hesabı bağlantı ayarı sayfasına bakınız.

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

Bu ayar hem Tüketim hem de Elastik Premium planı uygulamaları için gereklidir. Adanmış plan uygulamaları için işlevlerin dinamik olarak ölçeklenmediği durumlarda gerekli değildir.

Esnek Tüketim planı artık Azure İşlevleri için önerilen sunucusuz barındırma planıdır. Daha hızlı ölçeklendirme, azaltılmış soğuk başlangıçlar, özel ağ iletişimi ve performans ve maliyet üzerinde daha fazla denetim sunar. Daha fazla bilgi için bkz . Esnek Tüketim planı.

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 Azure Dosyalar desteklenen kimlik doğrulama senaryoları.

WEBSITE_CONTENTOVERVNET

Important

WEBSITE_CONTENTOVERVNET, vnetContentShareEnabled site özelliğiyle değiştirilen eski bir uygulama ayarıdır.

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

Key Örnek değer
WEBSITE_CONTENTOVERVNET 1

Bu uygulama ayarı, depolama hesabı sanal ağ kısıtlı olduğunda Elastik Premium ve Ayrılmış (App Service) planlarında (Standart ve üzeri) çapraz damga ölçeklendirmesi için gereklidir. Bu ayar olmadan işlev uygulaması yalnızca tek bir damga (yaklaşık 1-20 örnek) içinde ölçeklendirilebilir. Tüketim planında çalıştırılırken desteklenmez.

Note

Aynı planda birden çok işlev uygulaması tarafından paylaşılan bir depolama hesabında içerik paylaşımına yönlendirme yaparken özel bir özen göstermelisiniz. Daha fazla bilgi için Depolama ile ilgili dikkat edilmesi gerekenler makalesindeki Sanal ağlar üzerinden tutarlı yönlendirme makalesine bakın.

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. WEBSITE_CONTENTAZUREFILECONNECTIONSTRING ile kullanılır. 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 Depolama hesabı bağlantı ayarı sayfasına bakınız.

Key Örnek değer
WEBSITE_CONTENTSHARE functionapp091999e2

Bu ayar yalnızca 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.

Esnek Tüketim planı artık Azure İşlevleri için önerilen sunucusuz barındırma planıdır. Daha hızlı ölçeklendirme, azaltılmış soğuk başlangıçlar, özel ağ iletişimi ve performans ve maliyet üzerinde daha fazla denetim sunar. Daha fazla bilgi için bkz . Esnek Tüketim planı.

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 fonksiyon uygulaması veya slotlardaki uygulamalar için bir WEBSITE_CONTENTSHARE değer ayarlamadığınızda, benzersiz paylaşım değerleri sizin için oluşturulur. ARM şablonu dağıtımında WEBSITE_CONTENTSHAREayar yapmamak ö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ı için, 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.
  • "Slot ayarı yapmayın WEBSITE_CONTENTSHARE."
  • Bir değer belirttiğinizde WEBSITE_CONTENTSHARE, 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.

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

Key Ö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 olarak sınır yoktur.

Important

Bu ayar önizleme aşamasındadır. İşlev maksimum ölçeği genişletme için bir uygulama özelliği artık var. Ölçek genişlemesini sınırlamak için bu özelliği öneririz.

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

Key Ö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ştirdiğinizde, uygulama tarafından kullanılan ayrılmış depolama hesabına ağ erişimi kısıtlandığında yuva değişimi başarısız olabilir. Bu hata, hem İşlevler hem de App Service'in paylaştığı 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.

Key Örnek değer
WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS 0

WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS öğesini 0 değeriyle tüm yuvalara ekleyerek eski tanılama ayarlarının değiştirme işlemlerinizi engellemediğinden emin olun. Bu ayarı ve değeri yalnızca üretim ortamı yuvasına bir 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 yaklaşım, değiştirme sonrasında sürümlerin değiştirilmesi nedeniyle tahmin edilmeyen davranışı önler. 0 olarak ayarlayın; böylece tüm sürüm ayarlarının da değiştirildiğinden emin olun, üretim ve yuva ortamlarında. Daha fazla bilgi için Yuvaları kullanarak yükseltme bölümüne bakın.

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

Key Ö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. Daha fazla bilgi için bkz . İşlevlerinizi paket dosyasından çalıştırma.

kullandığınızda WEBSITE_RUN_FROM_PACKAGE=<URL>, URL'nin Azure Blob Depolama kapsayıcısı gibi erişilebilir bir depolama konumundaki paket dosyası konumuna çözümlenmesi gerekir. Yetkisiz erişimi önlemek için kapsayıcının özel olması gerekir. Bu, erişime izin vermek için URL'de paylaşılan erişim imzası (SAS) veya Microsoft Entra Id kimlik doğrulaması kullanmanızı gerektirir. Yönetilen kimliklerle Microsoft Entra ID kullanılması tavsiye edilir.

Bu, Azure Blog Depolama kapsayıcısında bir dağıtım paketinin URL'sini ayarlama WEBSITE_RUN_FROM_PACKAGE örneğidir:
WEBSITE_RUN_FROM_PACKAGE=https://contosostorageaccount.blob.core.windows.net/mycontainer/mypackage.zip

SAS kullanırken, belirteci URL'ye sorgu parametresi olarak eklersiniz.

Kullanıcı tarafından atanan yönetilen kimliği kullanarak Azure Blob Depolama'dan bir paket dağıttığınızda, kullanıcı tarafından atanan yönetilen kimliğin kaynak kimliğine de ayarlamanız WEBSITE_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID gerekir. 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_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID

Microsoft Entra Id kullanılarak güvenliği sağlanan bir dış Azure Blob Depolama kapsayıcısından dağıtım paketine erişirken kullanılan kullanıcı tarafından atanan yönetilen kimliğin kaynak kimliğini gösterir. Bu ayar, özel bir kapsayıcıdaki dağıtım paketinin URL'sine ayarlanmasını gerektirir WEBSITE_RUN_FROM_PACKAGE .

WEBSITE_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID=SystemAssigned ayarını yapmak, bu ayarı belirtmemekle aynıdır ve bu durumda uygulamaya sistem tarafından atanan yönetilen kimlik kullanılır.

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. ağ kısıtlamaları veya diğer sınırlayıcı faktörler nedeniyle işlev uygulaması aşağı akış Depolama Hesabına veya Key Vault'a düzgün şekilde çağrı yapmadığı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 olarak 0 alır ve doğrulama gerçekleşir.

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

Read-only. Geçerli dağıtım yuvasının adı. Üretim yuvasının adı Production.

Key Örnek değer
WEBSITE_SLOT_NAME Production

WEBSITE_TIME_ZONE

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

Key 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 Plan Value
Windows All Değeri, Windows komutunun verdiği her çiftin ikinci satırında belirtilen istenen saat diliminin adı olarak ayarlayın tzutil.exe /L
Linux Premium
Dedicated		 Değeri tz veritabanında gösterildiği gibi istenen saat diliminin adına ayarlayın

Note

WEBSITE_TIME_ZONE ve TZ şu anda bir Flex Consumption ya da Consumption planında Linux üzerinde çalışırken desteklenmemekte. Bu durumda, ayar WEBSITE_TIME_ZONE veya TZ SSL ile ilgili sorunlar oluşturabilir ve ölçümlerin uygulamanız için çalışmayı durdurmasına neden olabilir.

Örneğin, ABD'de Doğu Saati ((Windows) veya Eastern Standard Time (Linux) ile America/New_York 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ının her gün Doğu Saati ile 10:00'da tetiklenmesini sağlamak için, işlev uygulamanız için WEBSITE_TIME_ZONE adında bir uygulama ayarı oluşturun, değerini Eastern Standard Time (Windows) veya America/New_York (Linux) olarak belirleyin ve ardından aşağıdaki NCRONTAB ifadesini kullanın:

"0 0 10 * * *"

WEBSITE_TIME_ZONE'ı kullandığınızda, belirli bir saat dilimindeki saat değişikliklerine, yaz saati ve standart saat değişiklikleri dahil olmak üzere, uygun şekilde ayarlanır.

WEBSITE_USE_PLACEHOLDER

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

Key Örnek değer
WEBSITE_USE_PLACEHOLDER 1

WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED

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

Key Örnek değer
WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED 1

WEBSITE_VNET_ROUTE_ALL

Important

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 uygulama trafiğinin sanal ağ üzerinden yönlendirildiğini gösterir. Elastik Premium ve Ayrılmış barındırma planlarında Bölgesel sanal ağ tümleştirmesini yapılandırı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.

Key Örnek değer
WEBSITE_VNET_ROUTE_ALL 1

WEBSITES_ENABLE_APP_SERVICE_STORAGE

Dizinin, varsayılan değeri /homeolan ölçeklendirilmiş örnekler arasında paylaşılıp paylaşılmadığını true gösterir. İşlev uygulamanızı bir kapsayıcıya dağıtırken bu değeri false olarak ayarlamalısınız.

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 Azure portalında 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ı aşağıdadır.

AcrUseManagedIdentityCreds

Görüntünün yönetilen kimlik doğrulaması kullanılarak bir Azure Container Registry örneğinden alınıp alınmadığını gösterir. değeri true , yönetilen kimlik kullanmanızı gerektirir. Bu yaklaşımı, en iyi güvenlik uygulaması olarak depolanan kimlik doğrulama bilgileri yerine öneririz.

AcrUserManagedIdentityID

Görüntüyü bir Azure Container Registry örneğinden alırken kullanılacak yönetilen kimliği gösterir. AcrUseManagedIdentityCreds değerinin true olarak ayarlanmasını gerektirir. Bu değerler geçerlidir:

Value Description
system İşlev uygulamasının sistem tarafından atanan yönetilen kimliği kullanılır.
<USER_IDENTITY_RESOURCE_ID> Kullanıcıya atanan yönetilen kimliğin tam nitelikli kaynak kimliği.

Belirttiğiniz kimlik, kapsayıcı kayıt defterindeki ACRPull role eklenmelidir. Daha fazla bilgi için bkz Görüntüyle Azure'da işlev uygulaması oluşturma ve yapılandırma.

alwaysOn

Ayrılmış (App Service) planında çalışan bir işlev uygulamasında, İşlevler çalışma zamanı birkaç dakika etkinlik dışı kaldığında boşta olur ve bu noktada yalnızca HTTP tetikleyicisine yönelik istekler işlev uygulamanızı uyandırır. HTTP ile tetiklenmeyen, ZAMANLAYıCı tetikleyici işlevleri de dahil olmak üzere işlevlerinizin doğru çalıştığından emin olmak için, alwaysOn site ayarını true değerine ayarlayarak işlev uygulaması için Daima Açık'ı etkinleştirin.

functionsRuntimeAdminIsolationEnabled

İşlev uygulamanızdaki yerleşik yönetici (/admin) uç noktalarına erişilip erişilemeyeceğini belirler. (tr-TR) Varsayılan ayar olan false kullanıldığında, uygulama, isteklerde bir /admin sunulduğunda altındaki uç noktalara yönelik isteklere izin verir. olduğunda true, /admin uç noktalara ana anahtarla bile erişilemiyor.

Bu özellik, Tüketim planında Linux üzerinde çalışan uygulamalar için ayarlanamaz. Azure İşlevleri'nin 1.x sürümünde çalışan uygulamalar için ayarlanamaz. 1.x sürümünü kullanıyorsanız, önce 4.x sürümüne geçmeniz gerekir.

Esnek Tüketim planı artık Azure İşlevleri için önerilen sunucusuz barındırma planıdır. Daha hızlı ölçeklendirme, azaltılmış soğuk başlangıçlar, özel ağ iletişimi ve performans ve maliyet üzerinde daha fazla denetim sunar. Daha fazla bilgi için bkz . Esnek Tüketim planı.

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 örnek, 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.

Important

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 özeldir. Bkz. Azure İşlevleri temel görüntü depoları.

İş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. Daha fazla bilgi için bkz . Özel kapsayıcıları koruma.

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 .

vnetContentShareEnabled

Premium planda çalışan uygulamalar içerik depolamak için dosya paylaşımı kullanır. Bu içerik paylaşımının adı uygulama ayarında WEBSITE_CONTENTSHARE ve bağlantı dizesi içinde WEBSITE_CONTENTAZUREFILECONNECTIONSTRINGdepolanır. İşlev uygulamanızla içerik paylaşımı arasındaki trafiği bir sanal ağ üzerinden yönlendirmek için, vnetContentShareEnabled'yi true olarak ayarlamanız gerekir. Depolama hesabınızı Elastik Premium ve Ayrılmış barındırma planlarındaki bir sanal ağ ile kısıtlarken çapraz damga ölçeklendirmesi için bu site özelliğinin etkinleştirilmesi gerekir. Bu ayar olmadan işlev uygulaması yalnızca tek bir damga (yaklaşık 1-20 örnek) içinde ölçeklendirilebilir.

Note

Aynı planda birden çok işlev uygulaması tarafından paylaşılan bir depolama hesabında içerik paylaşımına yönlendirme yaparken özel bir özen göstermelisiniz. Daha fazla bilgi için Depolama ile ilgili dikkat edilmesi gerekenler makalesindeki Sanal ağlar üzerinden tutarlı yönlendirme makalesine bakın.

Bu site özelliği eski WEBSITE_CONTENTOVERVNET ayarın yerini alır.

vnetImagePullEnabled

İşlevler , Linux kapsayıcılarında çalışan işlev uygulamalarını destekler. Sanal ağ içindeki bir kapsayıcı kayıt defterine bağlanmak ve kayıt defterinden çekmek için, vnetImagePullEnabled'i true olarak ayarlamanız gerekir. Bu site özelliği Elastik Premium ve Ayrılmış barındırma planlarında desteklenir. Esnek Tüketim planı, Ağ'ı yapılandırmak için site özelliklerine veya uygulama ayarlarına güvenmez. Daha fazla bilgi için bkz. Esnek Tüketim planı sonlandırmalar.

vnetRouteAllEnabled

Uygulamadan gelen tüm giden trafiğin sanal ağ üzerinden yönlendirilip yönlendirmediğini gösterir. ayarı değeri true , tüm uygulama trafiğinin sanal ağ üzerinden yönlendirildiğini gösterir. Elastik Premium ve Ayrılmış planlarda Bölgesel sanal ağ tümleştirmesini yapılandırırken bu ayarı kullanın. Statik bir giden IP adresi tanımlamak için bir sanal ağ NAT ağ geçidi kullanıldığında da kullanılır. Daha fazla bilgi için bkz . Uygulama yönlendirmesini yapılandırma.

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

Esnek Tüketim planının kullanımdan kaldırılması

Esnek Tüketim planında, bu site özellikleri ve uygulama ayarları kullanım dışıdır ve işlev uygulaması kaynakları oluşturulurken kullanılmamalıdır:

Setting/property Reason
ENABLE_ORYX_BUILD Flex Consumption'da dağıtım yaparken remoteBuild parametresiyle değiştirilen
FUNCTIONS_EXTENSION_VERSION Uygulama Ayarı arka uç tarafından ayarlanır. ~1 değeri yoksayılabilir.
FUNCTIONS_WORKER_RUNTIME şununla name değiştirildi: properties.functionAppConfig.runtime
FUNCTIONS_WORKER_RUNTIME_VERSION şununla version değiştirildi: properties.functionAppConfig.runtime
FUNCTIONS_MAX_HTTP_CONCURRENCY Ölçek ve eşzamanlılık tetikleyici bölümüyle değiştirildi.
FUNCTIONS_WORKER_PROCESS_COUNT Ayar geçerli değil
FUNCTIONS_WORKER_DYNAMIC_CONCURRENCY_ENABLED Ayar geçerli değil
SCM_DO_BUILD_DURING_DEPLOYMENT Flex Consumption'da dağıtım yaparken remoteBuild parametresiyle değiştirilen
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING functionAppConfig'in dağıtım bölümüyle değiştirildi
WEBSITE_CONTENTOVERVNET Esnek Tüketim'de ağ iletişimi için kullanılmaz
WEBSITE_CONTENTSHARE functionAppConfig'in dağıtım bölümüyle değiştirildi
WEBSITE_DNS_SERVER DNS, Flex'teki tümleşik sanal ağdan devralınır
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT şununla maximumInstanceCount değiştirildi: properties.functionAppConfig.scaleAndConcurrency
WEBSITE_NODE_DEFAULT_VERSION şununla version değiştirildi: properties.functionAppConfig.runtime
WEBSITE_RUN_FROM_PACKAGE Flex Tüketimi kapsamındaki kurulumlar için kullanılmaz
WEBSITE_SKIP_CONTENTSHARE_VALIDATION İçerik paylaşımı Esnek Tüketim'de kullanılmaz
WEBSITE_VNET_ROUTE_ALL Esnek Tüketim'de ağ iletişimi için kullanılmaz
properties.alwaysOn Geçersiz
properties.containerSize Olarak yeniden adlandırıldı instanceMemoryMB
properties.ftpsState FTPS desteklenmiyor
properties.isReserved Geçersiz
properties.IsXenon Geçersiz
properties.javaVersion şununla version değiştirildi: properties.functionAppConfig.runtime
properties.LinuxFxVersion şununla değiştirildi: properties.functionAppConfig.runtime
properties.netFrameworkVersion şununla version değiştirildi: properties.functionAppConfig.runtime
properties.powerShellVersion şununla version değiştirildi: properties.functionAppConfig.runtime
properties.siteConfig.functionAppScaleLimit Olarak yeniden adlandırıldı maximumInstanceCount
properties.siteConfig.preWarmedInstanceCount Olarak yeniden adlandırıldı alwaysReadyInstances
properties.use32BitWorkerProcess 32 bit desteklenmiyor
properties.vnetBackupRestoreEnabled Esnek Tüketim'de ağ iletişimi için kullanılmaz
properties.vnetContentShareEnabled Esnek Tüketim'de ağ iletişimi için kullanılmaz
properties.vnetImagePullEnabled Esnek Tüketim'de ağ iletişimi için kullanılmaz
properties.vnetRouteAllEnabled Esnek Tüketim'de ağ iletişimi için kullanılmaz
properties.windowsFxVersion Geçersiz

İlgili içerik

  • Last updated on