Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
İş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 Uygulaması Hizmeti platformunu kullandığından, Azure Uygulaması Hizmeti'ndeki Ortam değişkenleri ve uygulama ayarları bölümünde belgelenen işlev uygulamanızla ilgili bazı ayarlar bulabilirsiniz.
Uygulama ayarında dikkat edilmesi gerekenler
Uygulama ayarlarını kullanırken aşağıdaki noktalara dikkat etmeniz gerekir:
İşlev uygulaması ayarlarında yapılan değişiklikler, işlev uygulamanızın yeniden başlatılmasını gerektirir.
Adları ayarlarken, çift alt çizgi (
__
) ve iki nokta (:
) ayrılmış değerler olarak görülür. Çift alt çizgiler, hem Windows hem de Linux'ta hiyerarşik sınırlayıcılar olarak yorumlanır ve iki nokta üst üste ise yalnızca Windows'ta benzer şekilde yorumlanır. Örneğin, ayarAzureFunctionsWebHost__hostid=somehost_123456
aşağıdaki JSON nesnesi olarak yorumlanır:"AzureFunctionsWebHost": { "hostid": "somehost_123456" }
Bu makalede, her iki işletim sisteminde de desteklendiği için yalnızca çift alt çizgi kullanılır. Yönetilen kimlik bağlantılarını destekleyen ayarların çoğu çift alt çizgi kullanır.
İşlevler yerel olarak çalıştırıldığında, uygulama ayarları local.settings.json koleksiyonda
Values
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, belirli bir ortam için belirli host.json ayarlarını yapılandırmanız veya değiştirmeniz gereken senaryolar için yararlıdır. Bu, projenizi yeniden yayımlamak zorunda kalmadan host.json ayarlarını değiştirmenize de olanak tanır. Daha fazla bilgi edinmek için host.json başvuru makalesine bakın.
Bu makalede, işlev uygulamalarınızla en ilgili ayarlar belgelenir. Azure İşlevleri App Service üzerinde çalıştığından, diğer uygulama ayarları da desteklenir. Daha fazla bilgi için bkz. Azure Uygulaması Hizmeti'nde ortam değişkenleri ve uygulama ayarları.
Bazı senaryolar, App Service site ayarlarında belgelenen ayarlarla çalışmanızı da gerektirir.
Salt 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_INSTRUMENTATIONKEY
hem 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_STRING
gerekir. Daha fazla bilgi için bkz. Azure İşlevleri için izlemeyi yapılandırma.
Anahtar | Örnek değer |
---|---|
APPINSIGHTS_INSTRUMENTATIONKEY | 55555555-af77-484b-9032-64f83bb83bb |
hem APPINSIGHTS_INSTRUMENTATIONKEY
hem de APPLICATIONINSIGHTS_CONNECTION_STRING
kullanmayın.
APPLICATIONINSIGHTS_CONNECTION_STRING
kullanılması önerilir.
APPLICATIONINSIGHTS_KİMLİK_DOĞRULAMA_DİZİ
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:
Yönetilen kimlik | Ayar değeri |
---|---|
Sistem tarafından atanan | Authorization=AAD |
Kullanıcı tarafından atanan | 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.
Not
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_INSTRUMENTATIONKEY
hem de APPLICATIONINSIGHTS_CONNECTION_STRING
kullanmayın.
APPLICATIONINSIGHTS_CONNECTION_STRING
kullanımı her durumda önerilmekle birlikte, aşağıdaki durumlarda zorunludur:
- İş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.
Anahtar | Örnek değer |
---|---|
APPLICATIONINSIGHTS_CONNECTION_STRING | InstrumentationKey=... |
Microsoft Entra kimlik doğrulaması ile Application Insights'a bağlanmak için kullanmanız APPLICATIONINSIGHTS_AUTHENTICATION_STRING
gerekir.
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL (Azure İşlev Vekilini Yerel Çağrıyı Devre Dışı Bırak)
Önemli
Azure İşlevleri proxy'ler, Azure İşlevleri çalışma zamanının 1.x ile 3.x sürümleri için eski bir özelliktir. 4.x sürümündeki eski destek hakkında daha fazla bilgi için bkz İşlev proxy'leri.
İşlev proxy'leri varsayılan olarak, proxy'lerden api çağrılarını doğrudan aynı işlev uygulamasındaki işlevlere göndermek için bir kısayol kullanır. Bu kısayol, yeni bir HTTP isteği oluşturmak yerine kullanılır. Bu ayar, bu kısayol davranışını devre dışı bırakmanızı sağlar.
Anahtar | Değer | Açıklama |
---|---|---|
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL (Azure İşlev Vekilini Yerel Çağrıyı Devre Dışı Bırak) | true |
Yerel işlev uygulamasındaki bir işleve işaret eden arka uç URL'si olan çağrılar doğrudan işleve gönderilmez. Bunun yerine, istekler işlev uygulamasının HTTP ön ucuna yönlendirilir. |
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL (Azure İşlev Vekilini Yerel Çağrıyı Devre Dışı Bırak) | false |
Yerel işlev uygulamasındaki bir işleve işaret eden arka uç URL'si olan çağrılar doğrudan işleve iletilir.
false varsayılan değerdir. |
AZURE_FUNCTION_PROXY_BACKEND_URL_SLASHLARINI_ÇÖZÜMLE
Önemli
Azure İşlevleri proxy'ler, Azure İşlevleri çalışma zamanının 1.x ile 3.x sürümleri için eski bir özelliktir. 4.x sürümündeki eski destek hakkında daha fazla bilgi için bkz İşlev proxy'leri.
Bu ayar, karakterlerin %2F
arka uç URL'sine eklendiğinde yol parametrelerinde eğik çizgi olarak çözülüp çözülmediğini kontrol eder.
Anahtar | Değer | Açıklama |
---|---|---|
AZURE_FUNCTION_PROXY_BACKEND_URL_SLASHLARINI_ÇÖZÜMLE | true |
Kodlanmış eğik çizgilere sahip rota parametreleri çözülür. |
AZURE_FUNCTION_PROXY_BACKEND_URL_SLASHLARINI_ÇÖZÜMLE | false |
Tüm yol parametreleri değiştirilmeden geçirilir ve bu varsayılan davranıştır. |
Örneğin, bir alan adındaki işlev uygulaması için myfunction.com
proxies.json dosyasını göz önünde bulundurun.
{
"$schema": "http://json.schemastore.org/proxies",
"proxies": {
"root": {
"matchCondition": {
"route": "/{*all}"
},
"backendUri": "example.com/{all}"
}
}
}
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES
olarak ayarlandığında, true
URL example.com/api%2ftest
, example.com/api/test
olarak çözümlenir. Varsayılan olarak, URL olarak değişmeden example.com/test%2fapi
kalır. Daha fazla bilgi için bkz . İşlev proxy'leri.
AZURE_FUNCTIONS_ENVIRONMENT
Azure'da çalışırken işlev uygulamasının çalışma zamanı barındırma ortamını yapılandırır. Bu değer başlatma sırasında okunur ve yalnızca bu değerler çalışma zamanı tarafından kabul edilir:
Değer | Açıklama |
---|---|
Production |
Azaltılmış günlük kaydı ve tam performans iyileştirmeleri ile bir üretim ortamını temsil eder. Bu, ayarlanmamışsa veya desteklenmeyen bir değere ayarlandığında varsayılan AZURE_FUNCTIONS_ENVIRONMENT değerdir. |
Staging |
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.
Anahtar | Örnek değer |
---|---|
AzureFunctionsWebHost__hostid | myuniquefunctionappname123456789 |
Daha fazla bilgi için bkz . Konak Kimliği ile ilgili dikkat edilmesi gerekenler.
AzureWebJobsDashboard
Bu ayar kullanım dışıdır ve yalnızca Azure İşlevleri çalışma zamanının 1.x sürümünde çalışırken desteklenir.
günlükleri depolamak ve portaldaki İzleyici sekmesinde görüntülemek için isteğe bağlı depolama hesabı bağlantı dizesi. Depolama hesabı blobları, kuyrukları ve tabloları destekleyen genel amaçlı bir hesap olmalıdır. Daha fazla bilgi edinmek için bkz . Depolama hesabı gereksinimleri.
Anahtar | Örnek değer |
---|---|
AzureWebJobsDashboard | DefaultEndpointsProtocol=https;AccountName=... |
AzureWebJobsDisableHomepage
değeri true
, bir işlev uygulamasının kök URL'si için gösterilen varsayılan giriş sayfasını devre dışı bırakır. Varsayılan değer şudur: false
.
Anahtar | Örnek değer |
---|---|
AzureWebJobsDisableHomepage | true |
Bu uygulama ayarı atlandığında veya false
olarak ayarlandığında, URL'ye <functionappname>.azurewebsites.net
yanıt olarak aşağıdaki örneğe benzer bir sayfa görüntülenir.
AzureWebJobsDotNetReleaseDerleme
true
.NET kodunu derlerken kullanılacak Release
modunu ifade eder; false
Hata Ayıklama modunu ifade eder. Varsayılan true
değeridir.
Anahtar | Örnek değer |
---|---|
AzureWebJobsDotNetReleaseDerleme | true |
AzureWebJobsFeatureFlags
Etkinleştirilen beta özelliklerinin virgülle ayrılmış listesi. Bu bayrakların etkinleştirdiği beta özellikleri üretime hazır değildir, ancak canlı yayına geçmeden önce deneysel kullanım için etkinleştirilebilir.
Anahtar | Örnek değer |
---|---|
AzureWebJobsFeatureFlags | feature1,feature2,EnableProxies |
Uygulamanızda şu anda bu ayar varsa, virgülle ayrılmış listenin sonuna yeni bayraklar ekleyin.
Şu anda desteklenen özellik bayrakları:
Bayrak değeri | Açıklama |
---|---|
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.
Anahtar | Örnek değer |
---|---|
AzureWebJobsKubernetesSecretName | <SECRETS_RESOURCE> |
Kubernetes Secrets kaynağını kullanırken göz önünde bulundurulması gerekenler:
-
AzureWebJobsSecretStorageType
ayrıcakubernetes
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.
Anahtar | Ö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.
Anahtar | Ö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 ve ayarlar local.settings.json dosyasında olmalıdır.
Anahtar | Ö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.
Anahtar | Ö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. Bu, anahtar depolama için bir anahtar kasası örneği kullanmak için önerilen ayardır. 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.
Anahtar | Örnek değer |
---|---|
AzureWebJobsSecretStorageKeyVaultUri | https://<VAULT_NAME>.vault.azure.net |
Önemli
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 kullanılması önerilir.
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 AzureWebJobsStorage
ayarlanan 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.
Anahtar | Ö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.
Anahtar | Değer | Açıklama |
---|---|---|
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, İşlevler v1.x için varsayılan davranıştı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.
Anahtar | Örnek değer |
---|---|
AzureWebJobsStorage | DefaultEndpointsProtocol=https;AccountName=... |
bağlantı dizesi yerine, bu depolama hesabı için kimlik tabanlı bir bağlantı kullanabilirsiniz. Daha fazla bilgi için Bir kimlikle konak depolama alanına bağlanma makalesine bakın.
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.
Anahtar | Ö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.
Anahtar | Ö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__queueServiceUri
Kimlik tabanlı depolama bağlantısı kullanırken, depolama hesabının kuyruk hizmetinin veri düzlemi URI'sini ayarlar.
Anahtar | Örnek değer |
---|---|
AzureWebJobsStorage__queueServiceUri | https://<STORAGE_ACCOUNT_NAME>.queue.core.windows.net |
Ö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.
Anahtar | Ö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.
Anahtar | Ö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_KAYIT_DEFTERİ_SUNUCU_KULLANICI_ADI
Ö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.
Anahtar | Örnek değer |
---|---|
DOCKER_SHM_SIZE | 268435456 |
Yukarıdaki değer paylaşılan bellek boyutunu yaklaşık 256 MB olarak ayarlar.
gerektirir ki FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED
, 1
olarak ayarlansın.
ETKİNLEŞTİR_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 bkz Uzak derleme.
Anahtar | Örnek değer |
---|---|
ETKİNLEŞTİR_ORYX_BUILD | true |
FUNCTION_APP_DÜZENLEME_MODU
İşlev uygulamanızı Azure portalında düzenleyip düzenleyemeyeceğinizi gösterir. Geçerli değerler: readwrite
ve readonly
.
Anahtar | Örnek değer |
---|---|
FUNCTION_APP_DÜZENLEME_MODU | readonly |
Değer, işlev uygulamanızın dil yığınına ve dağıtım durumuna göre çalışma zamanı tarafından ayarlanır. Daha fazla bilgi için bkz . Azure portalında geliştirme sınırlamaları.
FONKSİYONLAR_UZANTISI_SÜRÜMÜ
İş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.
Anahtar | Örnek değer |
---|---|
FONKSİYONLAR_UZANTISI_SÜRÜMÜ | ~4 |
Aşağıdaki ana çalışma zamanı sürüm değerleri desteklenir:
Değer | Çalışma zamanı hedefi | Yorum |
---|---|---|
~4 |
4.x | Önerilir |
~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ı (örneğin, 4.0.12345
) kullanın. Daha fazla bilgi için bkz. Azure İşlevleri çalışma zamanı sürümlerinin hedefini belirleme.
İŞLEVLER_İŞLEMİÇİ_NET8_ETKİN
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 1
ayarlanmalı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.
Anahtar | Örnek değer |
---|---|
İŞLEVLER_İŞLEMİÇİ_NET8_ETKİN | 1 |
0
İşlem içi modelde .NET 8 desteğini devre dışı bırakmak için olarak ayarlayın.
FONKSİYONLAR_DÜĞÜM_GİRİŞ_NOKTASINDA_HATA_BLOKAJI
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. Özellikle her zaman giriş noktası dosyalarını kullanan true
programlama modeli v4 uygulamaları için kullanılması kesinlikle önerilir. 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 (örneğin, model v3 kullanıyorsanız veya giriş noktası dosyanız yoksa), varsayılan davranış ile eşleşir
false
. - Hata sonrasında oluşursa (örneğin, yinelenen model v4 işlevlerini kaydetmeye çalışırsanız), varsayılan davranış ile eşleşir
true
.
Anahtar | Değer | Açıklama |
---|---|---|
FONKSİYONLAR_DÜĞÜM_GİRİŞ_NOKTASINDA_HATA_BLOKAJI | true |
Giriş noktası hatalarını engelleyin ve bunları Application Insights'ta kaydedin. |
FONKSİYONLAR_DÜĞÜM_GİRİŞ_NOKTASINDA_HATA_BLOKAJI | false |
Giriş noktalarındaki hataları önemsemeyin ve Application Insights'a kaydetmeyin. |
İŞLEVLER_İSTEK_GÖVDE_BOYUTU_SINIRI
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.
Anahtar | Örnek değer |
---|---|
İŞLEVLER_İSTEK_GÖVDE_BOYUTU_SINIRI | 250000000 |
FUNCTIONS_V2_UYUMLULUK_MODU
Önemli
Bu ayar artık desteklenmiyor. Başlangıçta, v2.x çalışma zamanını hedefleyen uygulamaların hala desteklendiği sırada v3.x çalışma zamanında çalışabilmesi için kısa vadeli bir geçici çözüm sağlamak için sağlanmıştır. 1.x sürümünde çalışan eski uygulamalar dışında, tüm işlev uygulamaları İşlevler çalışma zamanının 4.x sürümünde çalıştırılmalıdır: FUNCTIONS_EXTENSION_VERSION=~4
. Daha fazla bilgi için bkz. Azure İşlevleri çalışma zamanı sürümlerine genel bakış.
FUNCTIONS_WORKER_PROCESS_COUNT (İşlev İşçisi İşlem Sayısı)
Varsayılan değeri 1
olan 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.
Anahtar | Örnek değer |
---|---|
FUNCTIONS_WORKER_PROCESS_COUNT (İşlev İşçisi İşlem Sayısı) | 2 |
FUNCTIONS_WORKER_RUNTIME
İşlev uygulamasına yüklenmesi gereken çalışan çalışma zamanının dil veya dil yığını. Bu, uygulamanızda kullanılan dile karşılık gelir (örneğin, python
). Azure İşlevleri çalışma zamanının 2.x sürümünden başlayarak, belirli bir işlev uygulaması yalnızca tek bir dili destekleyebilir.
Anahtar | Örnek değer |
---|---|
FUNCTIONS_WORKER_RUNTIME | node |
Geçerli değerler:
Değer | Dil/dil yığını |
---|---|
dotnet |
C# (sınıf kitaplığı) C# (betik) |
dotnet-isolated |
C# (yalıtılmış çalışan işlemi) |
java |
Java |
node |
JavaScript TypeScript |
powershell |
PowerShell |
python |
Piton |
custom |
Diğer |
FONKSİYONLAR_İŞÇİ_PAYLAŞILAN_BELLEK_VERİ_TRANSFERİ_ETKİN
Bu ayar, Python çalışanının aktarım hızını geliştirmek için paylaşılan belleği kullanmasına olanak tanır. Python işlev uygulamanız bellek performans sorunlarına neden olduğunda paylaşılan belleği etkinleştirin.
Anahtar | Örnek değer |
---|---|
FONKSİYONLAR_İŞÇİ_PAYLAŞILAN_BELLEK_VERİ_TRANSFERİ_ETKİN | 1 |
Bu ayar etkinleştirildiğinde, paylaşılan bellek boyutunu ayarlamak için DOCKER_SHM_SIZE ayarını kullanabilirsiniz. Daha fazla bilgi edinmek için bkz . Paylaşılan bellek.
JAVA_OPTS
Premium planda veya Ayrılmış planda çalışırken Java işlevlerinizi çalıştırmak için kullanılan Java sanal makinesini (JVM) özelleştirmek için kullanılır. Tüketim planında çalışırken bunun yerine kullanın languageWorkers__java__arguments
. Daha fazla bilgi için bkz . JVM'yi özelleştirme.
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.
MDMaxArka Plan Yükseltme Süresi
Varsayılan değeri 7.00:00:00
(haftalık) olan PowerShell işlev uygulamaları için yönetilen bağımlılıklar arka plan güncelleştirme süresini denetler.
Her PowerShell çalışan işlemi, işlem başlangıcında ve MDMaxBackgroundUpgradePeriod
sonrasında PowerShell Galerisi modül yükseltmelerini denetlemeyi başlatır. PowerShell Galerisi yeni bir modül sürümü kullanılabilir olduğunda, dosya sistemine yüklenir ve PowerShell çalışanlarının kullanımına sunulur. Bu değerin azaltılması işlev uygulamanızın daha yeni modül sürümlerini daha erken almasına olanak tanır, ancak uygulama kaynak kullanımını da artırır (ağ G/Ç, CPU, depolama). Bu değerin artırılması uygulamanın kaynak kullanımını azaltır, ancak uygulamanıza yeni modül sürümlerinin gönderilmesini de geciktirebilir.
Anahtar | Örnek değer |
---|---|
MDMaxArka Plan Yükseltme Süresi | 7.00:00:00 |
Daha fazla bilgi için bkz . Bağımlılık yönetimi.
MDYeniAnlıkGörüntüKontrolDönemi
Her PowerShell çalışanının yönetilen bağımlılık yükseltmelerinin yüklenip yüklenmediğini ne sıklıkta denetlediğini belirtir. Varsayılan sıklık ( 01:00:00
saatlik).
Dosya sistemine yeni modül sürümleri yüklendikten sonra, her PowerShell çalışan işleminin yeniden başlatılması gerekir. PowerShell çalışanlarının yeniden başlatılması, uygulamanızın kullanılabilirliğini etkiler, bu da geçerli işlev yürütmeyi kesintiye uğratabilir. Tüm PowerShell çalışan işlemleri yeniden başlatılana kadar işlev çağrıları eski veya yeni modül sürümlerini kullanabilir. Tüm PowerShell çalışanlarının yeniden başlatılması MDNewSnapshotCheckPeriod
içinde tamamlanır.
Her MDNewSnapshotCheckPeriod
içinde, PowerShell çalışanı yönetilen bağımlılık yükseltmelerinin yüklenip yüklenmediğini denetler. Yükseltmeler yüklendiğinde yeniden başlatma başlatılır. Bu değerin artırılması, yeniden başlatmalar nedeniyle kesintilerin sıklığını azaltır. Ancak, artış işlev çağrılarının belirsiz bir şekilde eski veya yeni modül sürümlerini kullanabildiği süreyi de artırabilir.
Anahtar | Örnek değer |
---|---|
MDYeniAnlıkGörüntüKontrolDönemi | 01:00:00 |
Daha fazla bilgi için bkz . Bağımlılık yönetimi.
MDArkaPlanYükseltmeDönemi
Ö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).
Sık çalışan yeniden başlatmalarında aşırı modül yükseltmelerini önlemek için, herhangi bir işçi son MDMinBackgroundUpgradePeriod
içinde bu kontrolü başlatmışsa modül yükseltmeleri kontrol edilmiyor.
Anahtar | Örnek değer |
---|---|
MDArkaPlanYükseltmeDönemi | 1.00:00:00 |
Daha fazla bilgi için bkz . Bağımlılık yönetimi.
PIP_INDEX_URL
Bu ayar, varsayılan olarak https://pypi.org/simple
olan Python Paket Dizini'nin temel URL'sini geçersiz kılmanızı sağlar. Özel bağımlılıkları kullanarak uzak derleme çalıştırmanız gerektiğinde bu ayarı kullanın. Bu özel bağımlılıklar, PEP 503 (basit depo API'si) ile uyumlu bir paket dizini deposunda veya aynı biçimi izleyen yerel bir dizinde olabilir.
Anahtar | Örnek değer |
---|---|
PIP_INDEX_URL | http://my.custom.package.repo/simple |
Daha fazla bilgi edinmek için 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-url
kullanılacağını gösterir. Ek paket dizininde bulunan özel bağımlılıkları kullanarak uzak derleme çalıştırmanız gerektiğinde bu ayarı kullanın. ile aynı kurallara uymalıdır --index-url
.
Anahtar | Örnek değer |
---|---|
PIP_EXTRA_INDEX_URL | http://my.custom.package.repo/simple |
Daha fazla bilgi edinmek için pip
belgelerine ve Python geliştirici başvurusundaki --extra-index-url
kısmına bakın.
PROJE
Anahtar | Örnek değer |
---|---|
PROJE | WebProject/WebProject.csproj |
PYTHON_İZOLA_ET_ÇALIŞAN_BAĞIMLILIKLARI
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 0
ayarlanır.
Anahtar | Değer | Açıklama |
---|---|---|
PYTHON_İZOLA_ET_ÇALIŞAN_BAĞIMLILIKLARI | 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 dosyasında tanımlanan üçüncü taraf kütüphaneler gizlenmiş olabilir. |
PYTHON_İZOLA_ET_ÇALIŞAN_BAĞIMLILIKLARI | 1 |
Requirements.txt'de tanımlanan uygulamanın paketinden Python kitaplıklarını yüklemenin önceliğini belirleyin. Bu, kitaplıklarınızın iç Python çalışanlarının kitaplıklarıyla çakışmasını önler. |
PYTHON_ENABLE_DEBUG_LOGGING - (Python Hata Ayıklama Günlüğünü Etkinleştir)
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_WORKER_EXTENSIONS
Yapılandırma Python işlev uygulamalarına özgüdür. Bunu 1
olarak ayarlamak, çalışanın requirements.txt'de tanımlanan Python çalışan uzantılarını yüklemesine olanak tanır. İşlev uygulamanızın üçüncü taraf paketler tarafından sağlanan yeni özelliklere erişmesini sağlar. Ayrıca uygulamanızdaki işlev yükünün ve çağrının davranışını da değiştirebilir. 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.
Anahtar | Değer | Açıklama |
---|---|---|
PYTHON_ENABLE_WORKER_EXTENSIONS | 0 |
Herhangi bir Python çalışan uzantısını devre dışı bırakın. |
PYTHON_ENABLE_WORKER_EXTENSIONS | 1 |
Python çalışanının requirements.txt uzantılarını yüklemesine izin verin. |
PYTHON_THREADPOOL_THREAD_COUNT
Python dil çalışanının işlev çağrılarını yürütmek için kullanacağı iş parçacığı sayısı üst sınırını, Python 1
ve daha düşük sürümler için varsayılan 3.8
değeri 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.
Anahtar | Örnek değer | En yüksek değer |
---|---|---|
PYTHON_THREADPOOL_THREAD_COUNT | 2 | 32 |
ÖLÇEK_DENETLEYİCİ_GÜNLÜK_KAYDI_AKTİF
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.
Anahtar | Örnek değer |
---|---|
ÖLÇEK_DENETLEYİCİ_GÜNLÜK_KAYDI_AKTİF | AppInsights:Verbose |
Bu anahtarın değeri <DESTINATION>:<VERBOSITY>
biçiminde, şu şekilde tanımlanmıştır:
Mülk | Açıklama |
---|---|
<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 , None ve Warning değ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. |
İpucu
Ö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ı düşünün.
SCM_DO_BUILD_DURING_DEPLOYMENT (Dağıtım sırasında derleme yapılır)
Dağıtım sırasında uzaktan derleme davranışını denetler.
SCM_DO_BUILD_DURING_DEPLOYMENT
olarak ayarlandığındatrue
, proje dağıtım sırasında uzaktan oluşturulur.
Anahtar | Örnek değer |
---|---|
SCM_DO_BUILD_DURING_DEPLOYMENT (Dağıtım sırasında derleme yapılır) | true |
SCM_GÜNLÜKAKIŞ_ZAMAN_AŞIMI
Akış loglarına bağlanıldığında zaman aşımını saniye cinsinden denetler. Varsayılan değer 7200'dür (2 saat).
Anahtar | Örnek değer |
---|---|
SCM_GÜNLÜKAKIŞ_ZAMAN_AŞIMI | 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 (Web Sitesi İçeriği Azure Dosya Bağlantı Dizesi)
İş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.
Anahtar | Örnek değer |
---|---|
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING (Web Sitesi İçeriği Azure Dosya Bağlantı Dizesi) | DefaultEndpointsProtocol=https;AccountName=... |
Bu ayar hem Windows hem de Linux üzerinde çalışan Tüketim ve Elastik Premium planı uygulamaları için gereklidir. İşlevler tarafından dinamik olarak ölçeklendirilmeyen Ayrılmış plan uygulamaları için gerekli değildir.
Bu ayarı değiştirmek veya kaldırmak işlev uygulamanızın başlatılmamasına neden olabilir. Daha fazla bilgi edinmek için bu sorun giderme makalesine bakın.
Azure Dosyalar, dosya paylaşımına erişirken yönetilen kimliğin kullanılmasını desteklemez. Daha fazla bilgi için, bkz Azure Dosyalar desteklenen kimlik doğrulama senaryoları.
Websitesi İçerik Genel Bakış
Önemli
WEBSITE_CONTENTOVERVNET, vnetContentShareEnabled site özelliğiyle değiştirilen eski bir uygulama ayarıdır.
değeri 1
, depolama hesabınız bir sanal ağ ile sınırlı olduğunda işlev uygulamanızın ölçeklendirilmesini sağlar. Depolama hesabınızı bir sanal ağ ile kısıtlarken bu ayarı etkinleştirmeniz gerekir. Yalnızca 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.
Anahtar | Örnek değer |
---|---|
Websitesi İçerik Genel Bakış | 1 |
Bu uygulama ayarı Elastik Premium ve Ayrılmış (App Service) planlarında (Standart ve üzeri) gereklidir. Tüketim planında çalıştırılırken desteklenmez.
Not
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.
WEB_SİTESİ_İÇERİK_PAYLAŞIMI
İş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.
Anahtar | Örnek değer |
---|---|
WEB_SİTESİ_İÇERİK_PAYLAŞIMI | functionapp091999e2 |
Bu ayar hem Windows hem de Linux'ta Tüketim ve Premium plan uygulamaları için gereklidir. İşlevler tarafından dinamik olarak ölçeklendirilmeyen Ayrılmış plan uygulamaları için gerekli değildir.
Paylaşım, işlev uygulamanız oluşturulduğunda oluşturulur. Bu ayarı değiştirmek veya kaldırmak işlev uygulamanızın başlatılmamasına neden olabilir. Daha fazla bilgi edinmek için bu sorun giderme makalesine bakın.
Dağıtım sırasında işlev uygulaması oluşturmak için Bir Azure Resource Manager (ARM) şablonu veya Bicep dosyası kullanılırken aşağıdaki önemli noktalar geçerlidir:
- Ana 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ındaWEBSITE_CONTENTSHARE
ayar 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ı söz konusu olduğunda, otomatik dağıtımınızın bir parçası olarak paylaşımın kendisini de oluşturmanız gerekir. Daha fazla bilgi için bkz . Güvenli dağıtımlar. - "Slot ayarı yapmayın
WEBSITE_CONTENTSHARE
." - Bir değer belirttiğinizde
WEBSITE_CONTENTSHARE
, paylaşım adları için bu kılavuzu izlemesi gerekir.
WEB_SİTESİ_DNS_SUNUCUSU
IP adreslerini çözerken uygulama tarafından kullanılan DNS sunucusunu ayarlar. Bu ayar genellikle Azure DNS özel bölgeleri ve özel uç noktalar gibi belirli ağ işlevleri kullanılırken gereklidir.
Anahtar | Örnek değer |
---|---|
WEB_SİTESİ_DNS_SUNUCUSU | 168.63.129.16 |
Web Sitesinde Brotli Kodlamayı Etkinleştir
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 1
Brotli kodlaması kullanılır; aksi takdirde gzip kodlaması kullanılır.
WEB SİTESİ İŞLEVLERİ_ARMCACHE_ETKİN
Azure Resource Manager (ARM) şablonlarını kullanarak işlev uygulamalarını dağıtırken önbelleğe almayı devre dışı bırakır.
Anahtar | Örnek değer |
---|---|
WEB SİTESİ İŞLEVLERİ_ARMCACHE_ETKİN | 0 |
WEBSİTE_AZAMİ_DİNAMİK_UYGULAMA_YAYILIMI
Uygulamanın ölçeğini genişletebileceği en fazla örnek sayısı. Varsayılan olarak sınır yoktur.
Önemli
Bu ayar önizleme aşamasındadır. Maksimum ölçeği genişletme işlevine yönelik bir uygulama özelliği eklendi ve ölçeği genişletmeyi sınırlamanın önerilen yoludur.
Anahtar | Örnek değer |
---|---|
WEBSİTE_AZAMİ_DİNAMİK_UYGULAMA_YAYILIMI | 5 |
WEBSITE_NODE_DEFAULT_VERSION (if it should remain untranslated due to being a technical term or code) or Websitesi_Düğümü_Öntanımlı_Sürüm (if an explanatory Turkish version is needed)
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 ~18
ayarlandığında, Node.js 18'in en son sürümü kullanılır. Ana sürüm bir tilde ile hedeflendiğinde, ikincil sürümü el ile güncelleştirmeniz gerekmez.
Anahtar | Örnek değer |
---|---|
WEBSITE_NODE_DEFAULT_VERSION (if it should remain untranslated due to being a technical term or code) or Websitesi_Düğümü_Öntanımlı_Sürüm (if an explanatory Turkish version is needed) | ~18 |
WEBSITE_OVERRIDE_YAPIŞKAN_TANI_SEÇENEKLERİNI_AŞ"
Premium planda çalışan bir işlev uygulamasında yuva değişimi gerçekleştirirken, uygulama tarafından kullanılan ayrılmış depolama hesabı ağ kısıtlandığında değiştirme işlemi başarısız olabilir. Bu hata, hem İşlevler hem de App Service tarafından paylaşılan eski bir uygulama günlüğü özelliğinden kaynaklanır. Bu ayar eski günlüğe kaydetme özelliğini geçersiz kılar ve değiştirme işleminin gerçekleşmesine izin verir.
Anahtar | Örnek değer |
---|---|
WEBSITE_OVERRIDE_YAPIŞKAN_TANI_SEÇENEKLERİNI_AŞ" | 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.
WEB_SİTESİ_AŞIRI_YAPIŞKAN_EKLENTİ_SÜRÜMLERİ
Varsayılan olarak, işlev uygulamalarının sürüm ayarları her yuvaya özgüdür. Bu ayar, dağıtım yuvalarını kullanarak işlevleri yükseltirken kullanılır. Bu, değiştirme işleminden sonra sürümlerin değiştirilmesi nedeniyle tahmin edilmeyen davranışı önler.
0
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.
Anahtar | Örnek değer |
---|---|
WEB_SİTESİ_AŞIRI_YAPIŞKAN_EKLENTİ_SÜRÜMLERİ | 0 |
PAKETTEN_ÇALIŞAN_WEB_SİTESİ
İşlev uygulamanızın yerel olarak bağlanabilen veya bir dış URL'ye dağıtılabilen bir paket dosyasından çalışmasını sağlar.
Anahtar | Örnek değer |
---|---|
PAKETTEN_ÇALIŞAN_WEB_SİTESİ | 1 |
Geçerli değerler, bir dış dağıtım paketi dosyasının konumuna çözümleyen bir URL'dir veya 1
. olarak ayarlandığında 1
, paketin d:\home\data\SitePackages
klasöründe olması gerekir. Zip dağıtımını etkin olarak WEBSITE_RUN_FROM_PACKAGE
kullandığınızda paket otomatik olarak bu konuma yüklenir. Önizlemede bu ayar olarak adlandırılmıştır WEBSITE_RUN_FROM_ZIP
. Daha fazla bilgi için bkz . İşlevlerinizi paket dosyasından çalıştırma.
Dış paket URL'sinden dağıttığınızda tetikleyicileri de el ile eşitlemeniz gerekir. Daha fazla bilgi için bkz . Tetikleyici eşitleme.
İçerik Paylaşımı Doğrulamasını Atla
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 1
doğrulama denetimi atlanır; aksi takdirde değer varsayılan 0
olarak ayarlanır ve doğrulama gerçekleşir.
Anahtar | Örnek değer |
---|---|
İçerik Paylaşımı Doğrulamasını Atla | 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"
WEB_SİTESİ_YUVASI_ADI
Yalnızca okunabilir Geçerli dağıtım yuvasının adı. Üretim yuvasının adı Production
.
Anahtar | Örnek değer |
---|---|
WEB_SİTESİ_YUVASI_ADI | Production |
Web Sitesi Saat Dilimi
İşlev uygulamanız için saat dilimini ayarlamanıza olanak tanır.
Anahtar | İşletim Sistemi (OS) | Örnek değer |
---|---|---|
Web Sitesi Saat Dilimi | Windows | Eastern Standard Time |
Web Sitesi Saat Dilimi | Linux işletim sistemi | 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_ZONE
bir uygulama ayarı oluşturun.
Bu ayarın değeri, işlev uygulamanızın üzerinde çalıştırıldığı işletim sistemine ve plana bağlıdır.
İşletim sistemi | Planlama | Değer |
---|---|---|
Windows | Tümü | Değeri, Windows komutunun verdiği her çiftin ikinci satırında belirtilen istenen saat diliminin adı olarak ayarlayın tzutil.exe /L |
Linux | Üst Düzey Adanmış |
değeri, tz veritabanında gösterildiği gibi istenen saat diliminin adına ayarlayın. |
Not
Linux üzerinde Bir Tüketim veya Esnek Tüketim planında çalışırken WEBSITE_TIME_ZONE
ve TZ
şu anda desteklenmemektedir. Bu durumda, WEBSITE_TIME_ZONE
veya TZ
ayarlamak SSL ile ilgili sorunlara yol açabilir ve ölçümlerin uygulamanızda ç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, saat, yaz saati uygulaması ve standart zaman değişiklikleri de dahil olmak üzere, belirli bir saat dilimindeki saat değişikliklerine göre ayarlanır.
WEB SİTESİ KULLANIM YER TUTUCU
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.
Anahtar | Örnek değer |
---|---|
WEB SİTESİ KULLANIM YER TUTUCU | 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.
Anahtar | Örnek değer |
---|---|
WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED | 1 |
WEBSITE_VNET_ROUTE_ALL
Önemli
WEBSITE_VNET_ROUTE_ALL, vnetRouteAllEnabled site ayarıyla değiştirilen eski bir uygulama ayarıdır.
Uygulamadan gelen tüm giden trafiğin sanal ağ üzerinden yönlendirilip yönlendirmediğini gösterir. ayarı değeri 1
, tüm 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 olacaktır. Statik bir giden IP adresi tanımlamak için bir sanal ağ NAT ağ geçidi kullanıldığında da kullanılır.
Anahtar | Örnek değer |
---|---|
WEBSITE_VNET_ROUTE_ALL | 1 |
WEBSITES_APP_SERVİS_DEPOLAMASINI_ETKİNLEŞTİR
Dizinin, varsayılan değeri /home
olan ölçeklendirilmiş örnekler arasında paylaşılıp paylaşılmadığını true
gösterir. İşlev uygulamanızı bir kapsayıcıda dağıtırken, bunu false
olarak ayarlamanız gerekir.
App Service site ayarları
Bazı yapılandırmalar, dil sürümleri gibi site ayarları olarak App Service düzeyinde tutulmalıdır. Bu ayarlar portalda REST API'leri veya Azure CLI ya da Azure PowerShell kullanılarak yönetilir. Çalışma zamanı dilinize, işletim sisteminize ve sürümlerinize bağlı olarak gerekli olabilecek site ayarları şunlardır:
YönetilenKimlikKimlikBilgileriniKullan
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.
true
değeri, yönetilen bir kimliğin kullanılmasını gerektirir. Bu, güvenlik açısından en iyi uygulama olarak depolanan kimlik doğrulama bilgileri yerine önerilir.
Acr Kullanıcı Yönetimli Kimlik ID
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. Geçerli değerler şunlardır:
Değer | Açıklama |
---|---|
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.
her zaman açık
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.
İşlevlerÇalışmaZamanıYöneticiYalıtımıEtkin
İş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 Linux Tüketim SKU'su üzerinde çalışan uygulamalar için ayarlanamaz ve Azure İşlevleri 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_VERSION
birlikte kullanılır. Bu ayar önceden tanımlanmış bir değere veya özel görüntü URI'sine ayarlanabilir.
Bu değer, Linux işlev uygulamanızı oluştururken sizin için ayarlanır. ARM şablonu ve Bicep dağıtımları için ve belirli yükseltme senaryolarında ayarlamanız gerekebilir.
Geçerli linuxFxVersion değerleri
Desteklenen İşlevler çalışma zamanı sürümüne göre geçerli linuxFxVersion
değerlerin tablosunu görmek için aşağıdaki Azure CLI komutunu kullanabilirsiniz:
az functionapp list-runtimes --os linux --query "[].{stack:join(' ', [runtime, version]), LinuxFxVersion:linux_fx_version, SupportedFunctionsVersions:to_string(supported_functions_versions[])}" --output table
Önceki komut, Azure CLI'nın 2.40 sürümüne yükseltmenizi gerektirir.
Özel görüntüler
İşlev uygulamanız için kendi özel Linux kapsayıcınızı oluşturduğunuzda ve bakımını yaptığınızda, linuxFxVersion
değer aşağıdaki örnekte olduğu gibi biçiminde DOCKER|<IMAGE_URI>
olur:
linuxFxVersion = "DOCKER|contoso.com/azurefunctionsimage:v1.0.0"
Bu, dağıtılan kapsayıcının kayıt defteri kaynağını gösterir. Daha fazla bilgi için bkz. Kapsayıcılarla çalışma ve Azure İşlevleri.
Önemli
Kendi kapsayıcılarınızı oluştururken kapsayıcınızın temel görüntüsünü desteklenen en son temel görüntüye güncel tutmanız gerekir. Azure İşlevleri için desteklenen temel görüntüler dile özgü olup Azure İşlevleri temel görüntü depolarında bulunur.
İşlevler ekibi, bu temel görüntüler için aylık güncelleştirmeleri yayımlamaya kararlıdır. Düzenli güncelleştirmeler, hem İşlevler çalışma zamanı hem de diller için en son ikincil sürüm güncelleştirmelerini ve güvenlik düzeltmelerini içerir. Kapsayıcınızı düzenli olarak en son temel görüntüden güncelleştirmeli ve kapsayıcınızın güncelleştirilmiş sürümünü yeniden dağıtmalısınız. Daha fazla bilgi için bkz . Özel kapsayıcıları koruma.
.NET Framework Sürümü
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.
PowerShell sürümü
İş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_CONTENTAZUREFILECONNECTIONSTRING
depolanı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. Elastik Premium ve Ayrılmış barındırma planlarında depolama hesabınızı bir sanal ağ ile kısıtlarken bu site özelliğinin etkinleştirilmesi bir gereksinimdir.
Not
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:
Ayar/özellik | Nedeni |
---|---|
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ı Flex Tüketiminde 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 |
Sonraki adımlar
Uygulama ayarlarını güncelleştirme hakkında bilgi edinin
host.json dosyasında yapılandırma ayarlarına bakın
App Service uygulamaları için diğer uygulama ayarlarına bakın