Azure Functions için uygulama ayarları başvurusu

İş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 connection string değerleri kesilir.

Azure Functions barındırma için Azure App Service platformunu kullanır. Azure App Service'da işlev uygulamanızı Environment 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 üst üsteler yalnızca Windows 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 app configuration 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, project 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 Functions App Service üzerinde çalıştığından, diğer uygulama ayarları da desteklenir. Daha fazla bilgi için bkz. Azure App Service'da Environment değişkenleri ve uygulama ayarları.

  • Bazı senaryolar, App Service site ayarları belgelenmiş ayarlarla çalışmanızı da gerektirir.

  • read-onlyApp Service uygulama ayarlarının değiştirilmesi 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 Work.

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 Functions 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 access 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. Microsoft Entra authentication for Application Insights.

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, Monitoring Metrics Publisher ile eşdeğer atanmış bir rolle işlev uygulamasında zaten kullanılabilir olması gerekir.

Note

Microsoft Entra kimlik doğrulamasını kullanarak Application Insights'a bağlanmak için kullanırken, Application Insights için yerel kimlik doğrulaması>Disable yerel kimlik doğrulamasını da kullanmanı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 connection string. 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, connection string 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 Functions proxy'ler, Azure Functions çalışma zamanının versions 1.x ile 3.x arasında bir özelliğiydi. Daha fazla bilgi için bkz . İşlev proxy'leri.

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES

Important

Azure Functions proxy'ler, Azure Functions çalışma zamanının versions 1.x ile 3.x arasında bir özelliğiydi. Daha fazla bilgi için bkz . İşlev proxy'leri.

AZURE_FUNCTIONS_ENVIRONMENT

Azure'da çalışırken işlev uygulamasının çalışma zamanı hosting ortamı yapılandırılı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 Functions Temel Araçları, yerel bilgisayarınızda çalışırken AZURE_FUNCTIONS_ENVIRONMENTDevelopment olarak ayarlar. Bu ayar local.settings.json dosyasında geçersiz kılınamaz.

Azure çalışma zamanı ortamını ASPNETCORE_ENVIRONMENT dışında bir şeyle değiştirmeniz gerektiğinde Production 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ı storage 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. Host kimliğiyle ilgili önemli noktalar.

AzureWebJobsDashboard

Bu ayar kullanım dışıdır ve yalnızca Azure Functions runtime.

günlükleri depolamak ve Azure portal Monitor sekmesinde görüntülemek için isteğe bağlı storage hesabı connection string. storage hesabı blobları, kuyrukları ve tabloları destekleyen genel amaçlı bir hesap olmalıdır. Daha fazla bilgi edinmek için bkz. Storage hesap 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 false değeridir.

Key Örnek değer
AzureWebJobsDisableHomepage true

Bu uygulama ayarı atlandığında veya false olarak ayarlandığında, <functionappname>.azurewebsites.net URL'sine 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 kodu derlerken Release 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 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 Ayrılmış (App Service) planında çalışan Linux uygulamaları için Azure İzleme günlüklerinde ISO 8601 saat 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. Storage anahtar yönetme.

AzureWebJobsSecretStorageKeyVaultClientId

Kullanıcı tarafından atanan yönetilen kimliğin istemci kimliği veya anahtarların depolandığı kasayı access için 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
AzureWebJobsSecretStorageKeyVaultClientId <CLIENT_ID>

Daha fazla bilgi edinmek için bkz. Storage anahtar yönetme.

AzureWebJobsSecretStorageKeyVaultClientSecret

Kullanıcı tarafından atanan yönetilen kimliğin istemci kimliğinin gizli dizisi veya anahtarların depolandığı kasayı access için 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. Storage anahtar yönetme.

AzureWebJobsSecretStorageKeyVaultName

Bu ayar kullanım dışıdır ve yalnızca Azure Functions runtime.

Anahtarları depolamak için kullanılan key vault ö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.

Kasa, barındırma kaynağının sistem tarafından atanan yönetilen kimliğine karşılık gelen bir access ilkesine sahip olmalıdır. access 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. Storage anahtar yönetme.

AzureWebJobsSecretStorageKeyVaultTenantId

Anahtarların depolandığı kasayı access için 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. Storage anahtar yönetme.

Key Örnek değer
AzureWebJobsSecretStorageKeyVaultTenantId <TENANT_ID>

AzureWebJobsSecretStorageKeyVaultUri

Anahtarları depolamak için kullanılan key vault örneğin URI'si. İşlevler çalışma zamanının 4.x ve sonraki sürümlerinde desteklenir. Anahtar storage için key vault örneği kullanmak için bu ayarı öneririz. Bu ayar, AzureWebJobsSecretStorageType öğesini keyvault olarak ayarlamanızı gerektirir.

AzureWebJobsSecretStorageKeyVaultUri değeri, Key Vault genel bakış sekmesinde görüntülenen Vault URI tam değeri olmalıdır ve https:// de dahil olmak üzere.

Kasa, barındırma kaynağının sistem tarafından atanan yönetilen kimliğine karşılık gelen bir access ilkesine sahip olmalıdır. access 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 kullanacak şekilde yapılandırılmışsa, bunlar aynı gizli dizileri paylaşır ve büyük olasılıkla önemli çakışmalara 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. Manage Key Storage.

AzureWebJobsSecretStorageSas

Anahtar storage için kullanılan ikinci bir storage hesabının Blob Storage SAS URL'si. İşlevler varsayılan olarak içinde AzureWebJobsStorageayarlanan hesabı kullanır. Bu gizli dizi storage seçeneğini kullanırken, AzureWebJobsSecretStorageType'nin açıkça ayarlı olmadığından veya blob olarak ayarlandığından emin olun. Daha fazla bilgi edinmek için bkz. Storage anahtar yönetme.

Key Örnek değer
AzureWebJobsSecretStorageSas <BLOB_SAS_URL>

AzureWebJobsSecretStorageType

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

Key Value Description
AzureWebJobsSecretStorageType blob Anahtarlar, AzureWebJobsStorage ayarı tarafından sağlanan hesaptaki Blob storage kapsayıcısında depolanır. AzureWebJobsSecretStorageType ayarlı olmadığında Blob storage varsayılan davranıştır.
Farklı bir storage hesabı belirtmek için AzureWebJobsSecretStorageSas ayarını kullanarak ikinci bir storage hesabının SAS URL'sini belirtin.
AzureWebJobsSecretStorageType files Anahtarlar dosya sisteminde kalıcıdır. Bu davranış, İşlevler v1.x için varsayılandır.
AzureWebJobsSecretStorageType keyvault Anahtarlar, AzureWebJobsSecretStorageKeyVaultName tarafından ayarlanan bir key vault örneğinde 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. Storage anahtar yönetme.

AzureWebJobsStorage

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

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

connection string yerine, bu storage hesabı için kimlik tabanlı bir bağlantı kullanabilirsiniz. Daha fazla bilgi için bkz. Identity ile storage barındırmaya bağlanma.

AzureWebJobsStorage__accountName

Kimlik tabanlı bir storage bağlantısı kullanırken, AzureWebJobsStorage'da connection string kullanmak yerine storage 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ı bir storage bağlantısı kullanırken, storage 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 bkz. Identity ile storage barındırmaya bağlanma.

AzureWebJobsStorage__clientId

Yönetilen kimlik kimlik doğrulaması için access 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 bir access 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

Yönetilen kimlik kimlik doğrulaması için access belirteci almak için kullanılan kullanıcı tarafından atanan kimliğin 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ı bir storage bağlantısı kullanırken, storage 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 bkz. Identity ile storage barındırmaya bağlanma.

AzureWebJobsStorage__tableServiceUri

Kimlik tabanlı storage bağlantısı kullanırken, storage 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 bkz. Identity ile storage barındırmaya bağlanma.

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 kapsayıcı kayıt defteri access 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 App Service'da Environment 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 App Service'da Environment değişkenleri ve uygulama ayarları.

DOCKER_REGISTRY_SERVER_USERNAME

Özel kapsayıcı kayıt defteri access 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 App Service'da Environment değişkenleri ve uygulama ayarları.

DOCKER_SHM_SIZE

Python çalışanı paylaşılan bellek kullandığında paylaşılan bellek boyutunu (bayt cinsinden) ayarlar. Daha fazla bilgi edinmek için bkz. Shared memory.

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

Dağıtım sırasında Oryx derleme sisteminin 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 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 Geldirme 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 Functions ç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 Functions çalışma zamanı sürümlerini hedefleme.

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ğerin 1 olarak ayarlanması gerekir. Diğer gerekli yapılandırma değerleri de dahil olmak üzere tüm yönergeler için bkz. .NET 8 hedefine destek verme.

Key Örnek değer
FUNCTIONS_INPROC_NET8_ENABLED 1

İşlem içi modelde .NET 8 desteğini devre dışı bırakmak için 0 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 Functions ç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şlemde çalışan .NET (FUNCTIONS_WORKER_RUNTIME=dotnet) 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 Functions ç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 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ını sağlar. 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. Shared memory.

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ğın True olarak ayarlanması, İşlevler ana bilgisayarına Java çalışan işleminin OpenTelemetry günlüklerini doğrudan akışına izin vermesini bildirir ve bu da yinelenen konak düzeyi girdileri önler. 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 Storage SDK 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şlevlerin 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 PowerShell Gallery modül yükseltmelerini denetlemeyi başlatır ve başlangıçtan sonra her MDMaxBackgroundUpgradePeriod. PowerShell Gallery 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 storage 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 bkz. Azure Functions ile OpenTelemetry kullanma.

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 bkz. Azure Functions ile OpenTelemetry kullanma.

PIP_INDEX_URL

Uzak derleme çalıştırırken Python Paket Dizini'nin (https://pypi.org/simple) varsayılan temel URL'sini geçersiz kılar. Bu ayar paket dizininin yerini alır, geri yüklemede beklenmeyen davranışlar görebilirsiniz. Bu ayarı yalnızca tam bir özel bağımlılık kümesi kullanmanız gerektiğinde kullanın. Mümkün olduğunda, bunun yerine ek bir paket dizinine başvurmanızı sağlayan seçeneğini kullanmalısınız PIP_EXTRA_URL. Daha fazla bilgi için Python derleme makalesindeki Özel bağımlılıklar bölümüne bakın.

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

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. Daha fazla bilgi için pip belgelerine bakın --index-url.

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. Daha fazla bilgi için Python derleme makalesindeki Özel bağımlılıklar bölümüne bakın.

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

ile aynı kurallara uymalıdır --index-url. Daha fazla bilgi için pip belgelerine bakın --extra-index-url.

PROJECT

Kudu dağıtım hizmetine bağlı depodaki klasörü dağıtılabilir project konumunu bildiren continuous deployment ayarı.

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

PYTHON_APPLICATIONINSIGHTS_ENABLE_TELEMETRY

Python çalışan işleminin Telemetriyi Application Insights uç noktasına Açık Telemetri biçiminde çıkarıp çıkarmayacağını gösterir. Bu bayrağın True olarak ayarlanması, İşlevler ana bilgisayarına Python çalışan işleminin OpenTelemetry verilerini Application Insights uç noktasına dışarı 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 varsayılan davranış olan iç Python çalışan bağımlılıklarından Python kitaplıklarını yüklemeyi öncelik sırasına alın. 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ışan 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. 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şlev 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 Functions 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ğın True olarak ayarlanması, İşlevler ana bilgisayarına Python çalışan işleminin OpenTelemetry verilerini yapılandırılmış OTEL_EXPORTER_OTLP_ENDPOINT dışarı aktarmasına izin vermesini söyler. 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 özellikleri access 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 Functions 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.txtuzantı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. ayarı, Python iş parçacığı sayısını belirtilen değere genişletmesine olanak tanır. Bu ayar yalnızca Python işlev 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 Functions ö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 azure-functions-scale-controller uygulama ayarında ayarlanan varsayılan storage hesabındaki AzureWebJobsStorage 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 true olarak ayarlandığında, project 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 Functions'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ığı storage hesabı için Connection string. Daha fazla bilgi için bkz. Storage hesap bağlantısı ayarı.

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ı, Azure İşlevleri için önerilen sunucusuz barındırma planıdır. Tüketim planına kıyasla daha hızlı ölçeklendirme, düşük soğuk başlangıç, özel ağ ve performans ve maliyet üzerinde daha fazla denetim sağlar. Şu anda Tüketim planını kullanıyorsanız Esnek Tüketim planına geçmenizi öneririz. 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 Files şu anda dosya paylaşımına erişirken yönetilen kimliğin kullanılmasını desteklemez. Daha fazla bilgi için bkz. Azure Files desteklenen kimlik doğrulama senaryoları.

Bu bağlantı ayarı için KeyVault başvurusu kullanabilirsiniz. Ancak, storage connection string bir KeyVault içinde tutulduğunda Premium veya Tüketim planında bir işlev uygulaması oluşturmak ve dinamik olarak ölçeklendirmek için ek yapılandırma gerekir. Daha fazla bilgi için bkz. Azure Files bağlama için Considerations.

WEBSITE_CONTENTOVERVNET

Important

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

1 değeri, storage hesabınız bir virtual network kısıtlandığında işlev uygulamanızın damgalar arasında ölçeklendirilmesini sağlar. storage hesabınızı bir virtual network 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. Storage hesabınızı virtual networkye dağıtma.

Key Örnek değer
WEBSITE_CONTENTOVERVNET 1

bu uygulama ayarı, Elastic Premium ve Dedicated (App Service) planları (Standart ve üzeri) üzerinde storage hesabı sanal ağ kısıtlı olduğunda ç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ı plandaki birden çok işlev uygulaması tarafından paylaşılan bir storage hesabındaki içerik paylaşımına yönlendirme yaparken özellikle dikkatli olmanız gerekir. Daha fazla bilgi için, Storage konuları makalesindeki Sanel ağlar üzerinden tutarlı yönlendirme bölümüne 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 bkz. Storage hesap bağlantısı ayarı.

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ı, Azure İşlevleri için önerilen sunucusuz barındırma planıdır. Tüketim planına kıyasla daha hızlı ölçeklendirme, düşük soğuk başlangıç, özel ağ ve performans ve maliyet üzerinde daha fazla denetim sağlar. Şu anda Tüketim planını kullanıyorsanız Esnek Tüketim planına geçmenizi öneririz. 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.
  • WEBSITE_CONTENTSHARE değerini önceden tanımlanmış bir değere ayarlamanız gereken senaryolar vardır; örneğin, virtual network içinde güvenli bir storage hesabı kullanmanız gerekir. 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. virtual network tarafından güvenliği sağlanan bir storage 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ölgeler ve private 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 scale out olabilecek en fazla örnek sayısı. Varsayılan olarak sınır yoktur.

Important

Bu ayar önizleme aşamasındadır. Max scale out işlevi için app ö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 ç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 a yuva değiştirme gerçekleştirdiğinizde, uygulama tarafından kullanılan ayrılmış storage hesabı ağ kısıtlandığında değiştirme işlemi başarısız olabilir. Bu hataya, hem İşlevler hem de App Service paylaşan eski bir uygulama günlüğü özelliği neden olur. 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.

WEBSITE_RUN_FROM_PACKAGE=<URL> kullandığınızda, URL'nin Azure Blob Storage kapsayıcısı gibi erişilebilir bir storage konumundaki paket dosyası konumuna çözümlenmesi gerekir. Kapsayıcının yetkisiz access önlemek için özel olması gerekir. Bu, URL'de paylaşılan bir access imzası (SAS) veya access izin vermek için Microsoft Entra ID kimlik doğrulaması kullanmanızı gerektirir. yönetilen kimliklerle Microsoft Entra ID kullanılması önerilir.

Bu, Azure Blog Storage kapsayıcısında dağıtım paketinin URL'sine WEBSITE_RUN_FROM_PACKAGE ayarlama ö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 paketi Azure Blob Storage dağıttığınızda, WEBSITE_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID kullanıcı tarafından atanan yönetilen kimliğin kaynak kimliğine de ayarlamanız 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 Storage 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. İşlev uygulaması ağ kısıtlamaları veya diğer sınırlayıcı faktörler nedeniyle aşağı akış Storage Hesabı veya Key Vault düzgün çağrılamadığı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 connection string 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 hatası: "Azure Functions Ç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

Consumption planı üzerinde yalıtılmış .NET çalışan işlemi işlevlerini çalıştırırken belirli bir cold start iyileştirmesinin 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 virtual network üzerinden yönlendirilip yönlendirmediğini gösterir. 1 ayar değeri, tüm uygulama trafiğinin virtual network üzerinden yönlendirildiğini gösterir. Elastik Premium ve Ayrılmış barındırma planlarında Regional virtual network tümleştirme yapılandırırken bu ayara ihtiyacınız vardır. Statik bir giden IP adresi tanımlamak için virtual network 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.

site ayarlarını App Service

Bazı yapılandırmalar, dil sürümleri gibi site ayarları olarak App Service düzeyinde tutulmalıdır. Bu ayarlar Azure portal, 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. Image ile Azure üzerinde işlev uygulaması oluşturma ve yapılandırma.

alwaysOn

Dedicated (App Service) planında çalışan bir işlev uygulamasında İşlevler çalışma zamanı birkaç dakika etkinlik dışı kaldığında boşta kalır ve bu da işlev uygulamanızın wakes up http tetikleyicisine yönelik istekleri gösterir. Zamanlayıcı tetikleyici işlevleri de dahil olmak üzere HTTP ile tetiklenmeyen işlevlerinizin doğru çalıştığından emin olmak için, alwaysOn site ayarını true değerine ayarlayarak işlev uygulaması için Always On 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 Functions 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.

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ğerlerinin 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 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 Functions.

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 Functions için desteklenen temel görüntüler dile özeldir. bkz. Azure Functions temel görüntüsü repos.

İş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 .NET sürümünü ayarlar. Daha fazla bilgi için bkz. İşlev uygulamanızı Azure'da 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ı WEBSITE_CONTENTSHARE uygulama ayarında depolanır ve connection string WEBSITE_CONTENTAZUREFILECONNECTIONSTRING içinde depolanır. İşlev uygulamanızla içerik paylaşımı arasındaki trafiği bir virtual network üzerinden yönlendirmek için vnetContentShareEnabled değerini de true olarak ayarlamanız gerekir. Elastik Premium ve Ayrılmış barındırma planlarında storage hesabınızı virtual network restricing sırasında çapraz damga ölçeklendirme 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ı plandaki birden çok işlev uygulaması tarafından paylaşılan bir storage hesabındaki içerik paylaşımına yönlendirme yaparken özellikle dikkatli olmanız gerekir. Daha fazla bilgi için, Storage konuları makalesindeki Sanel ağlar üzerinden tutarlı yönlendirme bölümüne 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. virtual network içindeki bir kapsayıcı kayıt defterine bağlanmak ve bu kayıt defterinden çekmek için vnetImagePullEnabled değerini 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 virtual network üzerinden yönlendirilip yönlendirmediğini gösterir. true ayar değeri, tüm uygulama trafiğinin virtual network üzerinden yönlendirildiğini gösterir. Elastik Premium ve Ayrılmış planlarda Regional virtual network tümleştirme yapılandırırken bu ayarı kullanın. Statik bir giden IP adresi tanımlamak için virtual network 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 virtual network 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.dnsConfiguration.dnsServers' DNS, Esnek Tüketim planındaki tümleşik virtual network devralınır.
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