İşlev uygulamanızı yönetme

Azure Functions bir işlev uygulaması, tek tek işlevlerinizin yürütme bağlamını sağlar. İşlev uygulaması davranışları, belirli bir işlev uygulaması tarafından barındırılan tüm işlevler için geçerlidir. İşlev uygulamasındaki tüm işlevler aynı dilde olmalıdır.

İşlev uygulamasındaki tek tek işlevler birlikte dağıtılır ve birlikte ölçeklendirilir. Aynı işlev uygulamasındaki tüm işlevler, işlev uygulaması ölçeklendirildikçe örnek başına kaynakları paylaşır.

Bağlantı dizeleri, ortam değişkenleri ve diğer uygulama ayarları her işlev uygulaması için ayrı ayrı tanımlanır. İşlev uygulamaları arasında paylaşılması gereken tüm veriler kalıcı bir depoda harici olarak depolanmalıdır.

Azure portalında çalışmaya başlama

Not

Azure portalında işlev kodunu düzenlemeyle ilgili sınırlamalar nedeniyle, işlevlerinizi yerel olarak geliştirmeli ve kod projenizi Azure bir işlev uygulamasında yayımlamalısınız. Daha fazla bilgi için bkz. Azure portalında Geldirme sınırlamaları

İşlev uygulamanızdaki uygulama ayarlarını görüntülemek için şu adımları izleyin:

1. Azure hesabınızı kullanarak Azure portalında oturum açın. İşlev uygulamanızı arayın ve seçin.

2. İşlev uygulamanızın sol bölmesinde Ayarlar'ı genişletin, Ortam değişkenleri'ni ve ardından Uygulama ayarları sekmesini seçin.

   

Uygulama ayarlarıyla çalışma

Azure Functions tarafından kullanılan önceden tanımlanmış uygulama ayarlarına ek olarak, işlev kodunuzun gerektirdiği şekilde istediğiniz sayıda uygulama ayarı oluşturabilirsiniz. Daha fazla bilgi için bkz. Azure Functions için Uygulama Ayarları Başvurusu.

Bu ayarlar şifrelenmiş olarak depolanır. Daha fazla bilgi için bkz . Uygulama ayarları güvenliği.

Uygulama ayarlarını Azure portalından ve Azure CLI ve Azure PowerShell kullanarak yönetebilirsiniz. Uygulama ayarlarını Visual Studio Code ve Visual Studio'den de yönetebilirsiniz.

Not

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.

Azure portalı

Uygulama ayarlarınızı görüntülemek için bkz. Azure portalında başlama.

Uygulama ayarları sekmesi, işlev uygulamanız tarafından kullanılan ayarları korur:

1. Uygulama ayarlarının değerlerini görmek için Değerleri göster'i seçin.

2. Ayar eklemek için + Ekle'yi seçin ve ardından yeni anahtar-değer çiftinin Adı ve Değeri'ni girin.

   

Azure CLI

Komut az functionapp config appsettings list , var olan uygulama ayarlarını döndürür, örneğin:

az functionapp config appsettings list --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME>

komutu az functionapp config appsettings set bir uygulama ayarı ekler veya güncelleştirir. Aşağıdaki örnek, CUSTOM_FUNCTION_APP_SETTING adlı bir anahtar ve 12345 ile bir değer içeren bir ayar oluşturur.

az functionapp config appsettings set --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--settings CUSTOM_FUNCTION_APP_SETTING=12345

Azure PowerShell

Get-AzFunctionAppSetting Cmdlet var olan uygulama ayarlarını döndürür, örneğin:

Get-AzFunctionAppSetting -Name <FUNCTION_APP_NAME> -ResourceGroupName <RESOURCE_GROUP_NAME>

komutu Update-AzFunctionAppSetting bir uygulama ayarı ekler veya güncelleştirir. Aşağıdaki örnek, adı CUSTOM_FUNCTION_APP_SETTING olan anahtarla ve değeri 12345 ile bir ayar oluşturur.

Update-AzFunctionAppSetting -Name <FUNCTION_APP_NAME> -ResourceGroupName <RESOURCE_GROUP_NAME> -AppSetting @{"CUSTOM_FUNCTION_APP_SETTING" = "12345"}

Uygulama ayarlarını kullanma

İşlev uygulaması ayarları değerleri, kodunuz içinde ortam değişkenleri olarak da okunabilir. Daha fazla bilgi için bu dile özgü başvuru makalelerinin Ortam değişkenleri bölümüne bakın:

• C# önceden derlenmiş
• C# betiği (.csx)
• Java
• JavaScript
• PowerShell
• Python

Bir işlev uygulamasını yerel olarak geliştirirken, bu değerlerin yerel kopyalarını local.settings.json proje dosyasında tutmanız gerekir. Daha fazla bilgi için bkz . Yerel ayarlar dosyası.

FTPS dağıtım ayarları

Azure Functions, FTPS kullanarak işlev uygulamanıza proje kodu dağıtmayı destekler. Bu dağıtım yöntemi tetikleyicileri eşitlemenizi gerektirdiği için önerilmez. Proje dosyalarını güvenli bir şekilde aktarmak için her zaman FTP'yi değil FTPS'yi kullanın.

FTPS dağıtımı için gereken kimlik bilgilerini almak için şu yöntemlerden birini kullanın:

Azure portalı

İşlev uygulamanızın yayımlama profilini indirerek Azure portalında FTPS yayımlama kimlik bilgilerini alabilirsiniz.

Önemli

Yayımlama profili önemli güvenlik kimlik bilgilerini içerir. İndirilen dosyanın güvenliğini her zaman yerel bilgisayarınızda sağlayın.

İşlev uygulamanızın yayımlama profilini indirmek için:

1. Azure portalında işlev uygulamanızın sayfasını bulun, sol sütunda Settings>Configuration genişletin.

2. Yapılandırma sayfasında Genel ayarlar sekmesini seçin ve SCM Temel Kimlik Doğrulama Yayımlama Kimlik Bilgileri'ninAçık olduğundan emin olun. Bu ayar Kapalı olduğunda yayımlama profillerini kullanamazsınız, bu nedenle Açık'ı ve ardından Uygula'yı seçin.

3. İşlev uygulamasının Genel Bakış sayfasına dönün ve ardından Yayımlama profilini al'ı seçin.

   

4. Dosyanın içeriğini kaydedin ve kopyalayın.

3. Dosyada, publishMethod="FTP" özniteliğine sahip publishProfile öğesini bulun. Bu öğede publishUrl, , userNameve userPWD öznitelikleri FTPS yayımlama için hedef URL'yi ve kimlik bilgilerini içerir.

Azure CLI

Yayımlama profilinden FTPS kimlik bilgilerini döndüren bu Azure CLI komutunu çalıştırın.

az functionapp deployment list-publishing-profiles --name <APP_NAME> --resource-group <GROUP_NAME> --query "[?publishMethod=='FTP'].{URL:publishUrl, username:userName, password:userPWD}" -o table

Bu örnekte, <APP_NAME> değerini işlev uygulamanızın adı ve <GROUP_NAME> değerini kaynak grubu ile değiştirin. Döndürülen URL, usernameve password sütunları FTPS yayımlama için hedef URL'yi ve kimlik bilgilerini içerir.

Azure PowerShell

Yayımlama profilinden FTPS kimlik bilgilerini döndüren bu Azure PowerShell komutunu çalıştırın.

$profile = [xml](Get-AzWebAppPublishingProfile -ResourceGroupName "<GROUP_NAME>" -Name "<APP_NAME>" -Format "Ftp") 
$profile.publishData.publishProfile | Where-Object -Property publishMethod -eq Ftp | Select-Object -Property @{Name="URL"; Expression = {$_.publishUrl}}, 
@{Name="username"; Expression = {$_.userName}}, @{Name="password"; Expression = {$_.userPWD}} | Format-Table

Bu örnekte, <APP_NAME> değerini işlev uygulamanızın adıyla ve <GROUP_NAME> değerini kaynak grubuyla değiştirin. Döndürülen URL, usernameve password sütunları FTPS yayımlama için hedef URL'yi ve kimlik bilgilerini içerir.

Barındırma planı türü

bir işlev uygulaması oluşturduğunuzda, uygulamanın çalıştığı bir barındırma planı da oluşturursunuz. Bir planda bir veya daha fazla işlev uygulaması olabilir. İşlevlerinizin işlevselliği, ölçeklendirmesi ve fiyatlandırması planın türüne bağlıdır. Daha fazla bilgi için bkz. Azure Functions barındırma seçenekleri.

İşlev uygulamanız tarafından kullanılan plan türünü Azure portalından veya Azure CLI veya Azure PowerShell API'lerini kullanarak belirleyebilirsiniz.

Aşağıdaki değerler plan türünü gösterir:

Plan türü	Azure portalı	Azure CLI/PowerShell
Tüketim	Tüketim	Dynamic
Premium	ElasticPremium	ElasticPremium
Özel (App Service)	Çeşitli	Çeşitli

Azure portalı

1. İşlev uygulamanız tarafından kullanılan plan türünü belirlemek için Azure portalında işlev uygulamasının Overview sayfasındaki App Service Plan bölümüne bakın.

   

2. Fiyatlandırma katmanını görmek için App Service Planının adını seçin ve ardından sol bölmeden Ayarlar > Özellikleri'ni seçin.

Azure CLI

Barındırma planı türünüzü almak için aşağıdaki Azure CLI komutunu çalıştırın:

functionApp=<FUNCTION_APP_NAME>
resourceGroup=FunctionMonitoringExamples
appServicePlanId=$(az functionapp show --name $functionApp --resource-group $resourceGroup --query appServicePlanId --output tsv)
az appservice plan list --query "[?id=='$appServicePlanId'].sku.tier" --output tsv

Önceki örnekte ve öğesini sırasıyla kaynak grubu ve işlev uygulaması adlarıyla değiştirin <RESOURCE_GROUP><FUNCTION_APP_NAME> .

Azure PowerShell

Barındırma planı türünüzü almak için aşağıdaki Azure PowerShell komutunu çalıştırın:

$FunctionApp = '<FUNCTION_APP_NAME>'
$ResourceGroup = '<RESOURCE_GROUP>'

$PlanID = (Get-AzFunctionApp -ResourceGroupName $ResourceGroup -Name $FunctionApp).AppServicePlan
(Get-AzFunctionAppPlan -Name $PlanID -ResourceGroupName $ResourceGroup).SkuTier

Önceki örnekteki <RESOURCE_GROUP> ve <FUNCTION_APP_NAME> öğelerini sırasıyla kaynak grubu ve işlev uygulaması adlarıyla değiştirin.

Geçişi planlama

Bir işlev uygulamasını Tüketim Planı ile Premium Planı arasında Windows'ta geçirebilirsiniz.

Tavsiye

Tüketim planı uygulamanızı Premium plan yerine Flex Consumption planında çalışacak şekilde geçirmenizi öneririz. Flex Tüketim planına geçiş, Linux Tüketim planı uygulaması için tek geçiş seçeneğidir. Daha fazla bilgi için bkz . Tüketim planı uygulamalarını Esnek Tüketim planına geçirme.

Planlar arasında geçiş yaparken aşağıdaki noktaları göz önünde bulundurun:

• Ayrılmış (App Service) planına doğrudan geçiş desteklenmez.
• Linux'ta geçiş desteklenmez.
• Kaynak plan ve hedef plan aynı kaynak grubunda ve coğrafi bölgede olmalıdır. Daha fazla bilgi için bkz . Uygulamayı başka bir App Service planına taşıma.
• Belirli CLI komutları geçişin yönüne bağlıdır.
• Planlar arasında taşındığında, işlev uygulamanızdaki işlev yürütmelerinde kesinti süresi oluşur.
• Aynı Azure Files paylaşımı uygulama tarafından geçiş öncesinde ve sonrasında kullanıldığından, durum ve uygulamaya özgü diğer içerik korunur.

Planınızı şu araçları kullanarak taşıyabilirsiniz:

Azure portalı

Farklı bir plana geçmek için Azure portal kullanabilirsiniz.

Azure CLI

Azure CLI komutlarını kullanarak el ile yeni bir plan oluşturabilir, uygulamanızı yeni planı kullanacak şekilde değiştirebilir ve özgün planı silebilirsiniz.

Azure PowerShell

Azure PowerShell komutlarını kullanarak el ile yeni bir plan oluşturabilir, uygulamanızı yeni planı kullanacak şekilde değiştirebilir ve özgün planı silebilirsiniz.

Windows'da uygulamanız için geçiş yönünü seçin.

Tüketimden Premium'a

1. Azure portalında Tüketim planı uygulamanıza gidin ve sol bölmede App Service planı genişletin ve App Service planı öğesini seçin.

2. App Service planı sayfasında Geçerli App Service planı altında Planı değiştir'i seçin.

3. App Service planını değiştir bölümünde Plan türü için Premium'u seçin, yeni bir Premium plan oluşturun ve Tamam'ı seçin.

Daha fazla bilgi için bkz . Uygulamayı başka bir App Service planına taşıma.

Premium-Tüketim

1. Azure portalında Elastik Premium planı uygulamanıza gidin ve sol bölmede App Service planı genişletin ve App Service planı öğesini seçin.

2. App Service planı sayfasında Geçerli App Service planı altında Planı değiştir'i seçin.

3. App Service planını değiştir bölümünde, Plan türü altında Tüketim'i seçin, yeni bir Tüketim planı oluşturun ve Tamam'ı seçin.

Daha fazla bilgi için bkz . Uygulamayı başka bir App Service planına taşıma.

Tüketimden Premium'a

Tüketim planından Windows premium plana geçmek için aşağıdaki yordamı kullanın:

1. Mevcut işlev uygulamanızla aynı bölgede ve kaynak grubunda yeni bir App Service planı (Elastic Premium) oluşturmak için az functionapp create komutunu aşağıdaki gibi çalıştırın:

   az functionapp plan create --name <NEW_PREMIUM_PLAN_NAME> --resource-group <MY_RESOURCE_GROUP> --location <REGION> --sku EP1
   

2. Mevcut işlev uygulamasını yeni Premium plana geçirmek için az functionapp update komutunu aşağıdaki gibi çalıştırın:

   az functionapp update --name <MY_APP_NAME> --resource-group <MY_RESOURCE_GROUP> --plan <NEW_PREMIUM_PLAN>
   

3. İlk olarak uygulama tarafından kullanılan Tüketim planına artık ihtiyacınız kalmadığında, yeni plana başarıyla geçiş yaptığınızdan emin olduktan sonra özgün planınızı silin. Kaynak grubunuzdaki tüm Tüketim planlarının listesini almak için az functionapp plan list komutunu aşağıdaki gibi çalıştırın:

   az functionapp plan list --resource-group <MY_RESOURCE_GROUP> --query "[?sku.family=='Y'].{PlanName:name,Sites:numberOfSites}" -o table
   

   Sıfır site içeren ve geçiş yaptığınız planı güvenle silebilirsiniz.

4. Geçiş yaptığınız Tüketim planını silmek için az functionapp plan delete komutunu aşağıdaki şekilde çalıştırın.

   az functionapp plan delete --name <CONSUMPTION_PLAN_NAME> --resource-group <MY_RESOURCE_GROUP>
   

Premium'den Tüketim'e

Premium planından Windows'de Tüketim planına geçmek için aşağıdaki yordamı kullanın:

1. Mevcut işlev uygulamanızla aynı bölgede ve kaynak grubunda yeni bir işlev uygulaması (Tüketim) oluşturmak için az functionapp create komutunu aşağıdaki gibi çalıştırın. Bu komut, işlev uygulamasının çalıştırıldığı yeni bir Tüketim planı da oluşturur:

   az functionapp create --resource-group <MY_RESOURCE_GROUP> --name <NEW_CONSUMPTION_APP_NAME> --consumption-plan-location <REGION> --runtime <LANGUAGE_RUNTIME> --functions-version 4 --storage-account <STORAGE_NAME>
   

2. Yeni işlev uygulamasıyla oluşturulan Tüketim planının adını almak için az functionapp show komutunu aşağıdaki gibi çalıştırın:

   az functionapp show --resource-group <MY_RESOURCE_GROUP> --name <NEW_CONSUMPTION_APP_NAME> --query "{appServicePlanId}" -o tsv
   

   Tüketim planı adı, döndürülen tam kaynak kimliğinin son bölümüdür.

3. Mevcut işlev uygulamasını yeni Tüketim planına geçirmek için az functionapp update komutunu aşağıdaki gibi çalıştırın:

   az functionapp update --name <MY_APP_NAME> --resource-group <MY_RESOURCE_GROUP> --plan <NEW_CONSUMPTION_PLAN> --force
   

4. 1. adımda oluşturduğunuz işlev uygulamasını silmek için az functionapp delete komutunu aşağıdaki gibi çalıştırın çünkü yalnızca mevcut işlev uygulamasını çalıştırmak için oluşturulan plana ihtiyacınız vardır:

   az functionapp delete --name <NEW_CONSUMPTION_APP_NAME> --resource-group <MY_RESOURCE_GROUP>
   

5. İlk olarak uygulama tarafından kullanılan Premium plana artık ihtiyacınız kalmadığında, yeni plana başarıyla geçtiğinizi onayladıktan sonra özgün planınızı silin. Premium plan silinene kadar ücretlendirilmeye devam edersiniz. Kaynak grubunuzdaki tüm Premium planların listesini almak için az functionapp plan list komutunu aşağıdaki gibi çalıştırın:

   az functionapp plan list --resource-group <MY_RESOURCE_GROUP> --query "[?sku.family=='EP'].{PlanName:name,Sites:numberOfSites}" -o table
   

6. Geçirdiğiniz Premium planı silmek için az functionapp plan delete komutunu aşağıdaki gibi çalıştırın:

   az functionapp plan delete --name <PREMIUM_PLAN> --resource-group <MY_RESOURCE_GROUP>
   

Tüketimden Premium'a Geçiş

Tüketim planından Windows premium plana geçmek için aşağıdaki yordamı kullanın:

1. Mevcut işlev uygulamanızla aynı bölgede ve kaynak grubunda yeni bir App Service planı (Elastic Premium) oluşturmak için New-AzFunctionAppPlan komutunu aşağıdaki gibi çalıştırın:

   New-AzFunctionAppPlan -Name <NEW_PREMIUM_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Location <REGION> -Sku EP1 -WorkerType Windows
   

2. Mevcut işlev uygulamasını yeni Premium plana geçirmek için Update-AzFunctionApp komutunu aşağıdaki gibi çalıştırın:

   Update-AzFunctionApp -Name <MY_APP_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -PlanName <NEW_PREMIUM_PLAN> -Force
   

3. Başlangıçta uygulama tarafından kullanılan Tüketim planına artık ihtiyacınız kalmadığında, aşağıdaki gibi Remove-AzFunctionAppPlan komutunu çalıştırarak geçiş yaptığınız Tüketim planını silebilirsiniz:

   Remove-AzFunctionAppPlan -Name <CONSUMPTION_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Force
   

Premium-Tüketim

Premium planından Windows'de Tüketim planına geçmek için aşağıdaki yordamı kullanın:

1. Mevcut işlev uygulamanızla aynı bölgede ve kaynak grubunda yeni bir işlev uygulaması (Tüketim) oluşturmak için New-AzFunctionApp komutunu aşağıdaki gibi çalıştırın. Bu komut, işlev uygulamasının çalıştırıldığı yeni bir Tüketim planı da oluşturur:

   New-AzFunctionApp -Name <NEW_CONSUMPTION_APP_NAME> -StorageAccountName <STORAGE_NAME> -Location <REGION> -ResourceGroupName <MY_RESOURCE_GROUP> -Runtime <LANGUAGE_RUNTIME> -RuntimeVersion <LANGUAGE_VERSION> -FunctionsVersion 4 -OSType Windows
   

2. Yeni işlev uygulamasıyla oluşturulan Tüketim planının adını almak için Get-AzFunctionApp komutunu aşağıdaki gibi çalıştırın:

   Get-AzFunctionApp -ResourceGroupName <MY_RESOURCE_GROUP> -Name <NEW_CONSUMPTION_APP_NAME> | Select-Object -Property AppServicePlan | Format-List
   

3. Mevcut işlev uygulamasını yeni Tüketim planına geçirmek için Update-AzFunctionApp komutunu aşağıdaki gibi çalıştırın:

   Update-AzFunctionApp -Name <MY_APP_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -PlanName <NEW_CONSUMPTION_PLAN> -Force
   

4. Başlangıçta uygulama tarafından kullanılan Tüketim planına artık ihtiyacınız kalmadığında, aşağıdaki gibi Remove-AzFunctionAppPlan komutunu çalıştırarak geçiş yaptığınız Tüketim planını silebilirsiniz:

   Remove-AzFunctionAppPlan -Name <CONSUMPTION_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Force
   

Azure portalında geliştirme sınırlamaları

Aşağıdaki tabloda, portal içi düzenlemeyi destekleyen işletim sistemleri ve diller gösterilmektedir:

Dil	Flex Consumption	Premium	Dedicated	Tüketim
C# (programlama dili)
Java
JavaScript (Node.js)		✔	✔	Yalnızca Windows
Python		Yalnızca Linux	Yalnızca Linux	Yalnızca Linux
PowerShell		Yalnızca Windows	Yalnızca Windows	Yalnızca Windows
TypeScript (Node.js)

İşlevlerinizi Azure portalında geliştirirken bu sınırlamaları göz önünde bulundurun:

• Portal içi düzenleme yalnızca Azure portalında oluşturulan veya en son değiştirilen işlevler için desteklenir.
• Portal içi düzenleme yalnızca JavaScript, PowerShell, Python ve C# betiği (işlem içi) işlevleri için desteklenir.
• Portal içi düzenleme şu anda Flex Consumption planı tarafından desteklenmiyor.
• Uygulamalarınızı Linux üzerinde tüketim planında çalıştırma özelliği kullanımdan kaldırılması planlanıyor. Daha fazla bilgi için Azure Functions Tüketim Planı Barındırma'ya bakın.
• Azure portalının dışından bir işlev uygulamasına kod dağıttığınızda, artık portalda bu işlev uygulamasının kodlarından hiçbirini düzenleyemezsiniz. Bu durumda yerel geliştirmeyi kullanmaya devam edin.
• Python için özel modüllerle geliştirme şu anda portalda desteklenmemektedir. İşlev uygulamanıza özel modüller eklemek için uygulamanızı yerel olarak geliştirmeniz gerekir.
• Derlenmiş C# işlevleri ve Java işlevleri için portalda işlev uygulamasını ve ilgili kaynakları oluşturabilirsiniz. Ancak, işlev kodu projesini yerel olarak oluşturup Azure yayımlamanız gerekir.

Mümkün olduğunda işlevlerinizi yerel olarak geliştirin ve kod projenizi Azure bir işlev uygulamasında yayımlayın. Daha fazla bilgi için bkz. Azure İşlevlerini yerel olarak kodlayın ve test edin.

Uzantıları el ile yükleme

C# sınıf kitaplığı işlevleri, uzantıları doğrudan sınıf kitaplığı projesinde bağlamaya yönelik NuGet paketlerini içerebilir. diğer .NET olmayan diller ve C# betiği için uzantı paketlerini kullanmanız gerekir. Uzantıları el ile yüklemeniz gerekiyorsa, bunu Azure Functions Core Tools yerel olarak kullanarak yapabilirsiniz. Uzantı paketlerini kullanamıyorsanız ve yalnızca portalda çalışabiliyorsanız, extensions.csproj dosyasını doğrudan sitede el ile oluşturmak için Gelişmiş Araçlar'ı (Kudu) kullanmanız gerekir. önce öğesini host.json dosyasından kaldırdığınızdan extensionBundleemin olun.

Aynı işlem, uygulamanıza eklemeniz gereken diğer tüm dosyalarda da çalışır.

Önemli

Mümkün olduğunda, Azure'da doğrudan işlev uygulamanızda dosyaları düzenlemeyin. Uygulama dosyalarınızı yerel olarak indirmenizi, uzantıları ve diğer paketleri yüklemek için Core Tools'u kullanmanızı, değişikliklerinizi doğrulamanızı ve ardından Core Tools veya desteklenen diğer dağıtım yöntemlerinden birini kullanarak uygulamanızı yeniden yayımlamanızı öneririz.

Azure portalında yerleşik olarak bulunan İşlevler düzenleyicisi, işlev kodunuzu ve yapılandırma dosyalarınızı doğrudan portalda güncelleştirmenize olanak tanır:

1. İşlev uygulamanızı seçin, ardından İşlevler'in altında İşlevler'i seçin.

2. İşlevinizi seçin ve Geliştirici'nin altında Kod + test'i seçin.

3. Düzenlemek istediğiniz dosyayı seçin ve bitirdiğinizde Kaydet'i seçin.

Uygulamanın kökündeki function.proj veya extensions.csproj gibi dosyaların Gelişmiş Araçlar (Kudu) kullanılarak oluşturulması ve düzenlenmesi gerekir:

1. İşlev uygulamanızı seçin, Geliştirme araçlarını genişletin ve ardından Gelişmiş araçlar>Git öğesini seçin.

2. İstenirse, Azure kimlik bilgilerinizle Kaynak Denetim Yöneticisi (SCM) sitesinde oturum açın.

3. Hata ayıklama konsolu menüsünden CMD'yi seçin.

4. adresine .\site\wwwrootgidin, üstteki artı (+) düğmesini seçin ve Yeni dosya'yı seçin.

5. Dosyaya gibi extensions.csprojbir ad verin ve Enter tuşuna basın.

6. Yeni dosyanın yanındaki düzenle düğmesini seçin, dosyaya kod ekleyin veya güncelleştirin ve ardından Kaydet'i seçin.

7. extensions.csproj gibi bir proje dosyası için aşağıdaki komutu çalıştırarak extensions projesini yeniden oluşturun:

   dotnet build extensions.csproj
   

Platform özellikleri

İşlev uygulamaları, bunların bakımını yapan Azure App Service platformunda çalışır. Bu nedenle işlev uygulamalarınız Azure temel web barındırma platformunun özelliklerinin çoğuna erişebilir. Azure portalını kullandığınızda, sol bölmede App Service platformunun işlev uygulamalarınızda kullanabileceğiniz birçok özelliğe erişebilirsiniz.

Aşağıdaki matriste, barındırma planı ve işletim sistemi tarafından Azure portal özelliği desteği gösterilir:

Özellik	Tüketim planı	Esnek Tüketim planı	Premium planı	Ayrılmış plan
Gelişmiş araçlar (Kudu)	Windows: ✔ Linux: X	X	✔	✔
App Service düzenleyicisi	Windows: ✔ Linux: X	X	Windows: ✔ Linux: X	Windows: ✔ Linux: X
Backups	X	X	X	✔
Konsol	Windows: komut satırı Linux: X	X	Windows: komut satırı Linux: SSH	Windows: komut satırı Linux: SSH

Bu makalenin geri kalanında portalda işlev uygulamalarınız için yararlı olan aşağıdaki özelliklere odaklanılır:

• App Service düzenleyicisi
• Konsol
• Gelişmiş araçlar (Kudu)
• Dağıtım seçenekleri
• CORS
• Kimlik Doğrulaması

App Service ayarlarıyla çalışma hakkında daha fazla bilgi için bkz. Yapılandırma Azure App Service Ayarları.

App Service düzenleyicisi

App Service düzenleyicisi, JSON yapılandırma dosyalarını ve kod dosyalarını değiştirmek için kullanabileceğiniz gelişmiş bir portal içi düzenleyicidir. Bu seçeneğin seçilmesi, temel bir düzenleyici ile ayrı bir tarayıcı sekmesi başlatır. Bu düzenleyici Git deposuyla tümleştirmenize, kodu çalıştırmanıza ve hatalarını ayıklamanıza ve işlev uygulaması ayarlarını değiştirmenize olanak tanır. Bu düzenleyici, yerleşik işlev düzenleyicisine kıyasla işlevleriniz için gelişmiş bir geliştirme ortamı sağlar.

İşlevlerinizi yerel bilgisayarınızda geliştirmeyi düşünmenizi öneririz. Yerel olarak geliştirip Azure yayımladığınızda, proje dosyalarınız Azure portalında salt okunur olur. Daha fazla bilgi için bkz. Azure İşlevlerini yerel olarak kodlayın ve test edin.

Konsol

Komut satırından işlev uygulamanızla etkileşime geçmek istediğinizde portal içi konsol ideal bir geliştirici aracıdır. Yaygın komutlar, dizin ve dosya oluşturma ve gezintinin yanı sıra toplu iş dosyalarını ve betiklerini yürütmeyi içerir.

Yerel olarak geliştirme yaparken Azure Functions Core Tools ve Azure CLI kullanmanızı öneririz.

Gelişmiş araçlar (Kudu)

App Service için gelişmiş araçlar (Kudu olarak da bilinir), işlev uygulamanızın gelişmiş yönetim özelliklerine erişim sağlar. Kudu'dan sistem bilgilerini, uygulama ayarlarını, ortam değişkenlerini, site uzantılarını, HTTP üst bilgilerini ve sunucu değişkenlerini yönetirsiniz. Kudu'yu, işlev uygulamanızın SCM uç noktasına göz atarak da başlatabilirsiniz; örneğin: https://<myfunctionapp>.scm.azurewebsites.net/.

Dağıtım Merkezi

İşlev kodunuzu geliştirmek ve korumak için bir kaynak denetimi çözümü kullandığınızda, Dağıtım Merkezi kaynak denetiminden derlemenizi ve dağıtmanızı sağlar. Projeniz oluşturulur ve güncelleştirmeler yaptığınızda Azure dağıtılır. Daha fazla bilgi için bkz. deployment technologies in Azure Functions.

Kökenler arası kaynak paylaşımı

İstemcide kötü amaçlı kod yürütülmesini önlemek için modern tarayıcılar, web uygulamalarından ayrı bir etki alanında çalışan kaynaklara yönelik istekleri engeller. Çıkış noktaları arası kaynak paylaşımı (CORS), işlev uygulamanızdaki uç noktaları çağırmasına izin verilen kaynakları bildiren Access-Control-Allow-Origin başlığının hangi kaynaklara izin verildiğini belirtmesini sağlar.

Azure portalı

İşlev uygulamanız için İzin verilen çıkış noktaları listesini yapılandırdığınızda, Access-Control-Allow-Origin üst bilgi işlev uygulamanızdaki HTTP uç noktalarındaki tüm yanıtlara otomatik olarak eklenir.

Başka bir dizin girişi varsa joker karakter (*) yoksayılır.

Azure CLI

az functionapp cors add İzin verilen çıkış noktaları listesine etki alanı eklemek için komutunu kullanın. Aşağıdaki örnek contoso.com etki alanını ekler:

az functionapp cors add --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--allowed-origins https://contoso.com

az functionapp cors show İzin verilen geçerli çıkış noktalarını listelemek için komutunu kullanın.

Azure PowerShell

Şu anda Azure PowerShell kullanarak CORS ayarlarını güncelleştiremezsiniz.

Kimlik Doğrulaması

İşlevler bir HTTP tetikleyicisi kullandığında, çağrıların önce kimlik doğrulamasının yapılmasını gerektirebilirsiniz. App Service Microsoft Entra kimlik doğrulamasını ve Facebook, Microsoft ve X gibi sosyal sağlayıcılarla oturum açmayı destekler. Belirli kimlik doğrulama sağlayıcılarını yapılandırma hakkında bilgi için bkz. Azure App Service kimlik doğrulamasına genel bakış.

İlgili içerik

• App Service uygulamasını yapılandırma
• Azure Functions için Sürekli Dağıtım