İşlev uygulamanızı yönetme

Azure İşlevleri bir işlev uygulaması, tek tek işlevleriniz için yürütme bağlamı 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ını kullanmaya başlama

Not

Azure portalında işlev kodunu düzenlemeyle ilgili sınırlamalar nedeniyle işlevlerinizi yerel olarak geliştirmeniz ve kod projenizi Azure'daki bir işlev uygulamasında yayımlamanız gerekir. Daha fazla bilgi için bkz . Azure portalında geliştirme 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 portalda 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 İşlevleri tarafından kullanılan önceden tanımlanmış uygulama ayarlarına ek olarak işlev kodunuzun gerektirdiği sayıda uygulama ayarı oluşturabilirsiniz. Daha fazla bilgi için bkz. Azure İşlevleri 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 ile Azure PowerShell kullanarak yönetebilirsiniz. Uygulama ayarlarını Visual Studio Code'dan ve Visual Studio'dan da yönetebilirsiniz.

Azure portalı

Uygulama ayarlarınızı görüntülemek için bkz . Azure portalında kullanmaya 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 adlı CUSTOM_FUNCTION_APP_SETTING bir anahtar ve değeri 12345ile 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 adlı CUSTOM_FUNCTION_APP_SETTING bir anahtar ve değeri 12345ile 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 İşlevleri, 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. İşlev uygulamasının Genel Bakış sayfasını ve ardından Yayımlama profilini al'ı seçin.

   

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

3. dosyasında özniteliğine publishProfile publishMethod="FTP"sahip öğ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 değerini işlev uygulamanızın adıyla ve <GROUP_NAME> kaynak grubuyla değiştirin<APP_NAME>. 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 değerini işlev uygulamanızın adıyla ve <GROUP_NAME> kaynak grubuyla değiştirin<APP_NAME>. 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 İşlevleri 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
Ayrılmış (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ındaki işlev uygulamasının Genel Bakış sayfasındaki App Service Planı'na 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 örnekte ve öğesini sırasıyla kaynak grubu ve işlev uygulaması adlarıyla değiştirin <RESOURCE_GROUP> <FUNCTION_APP_NAME> .

Geçişi planlama

İşlev uygulamasını Tüketim planı ile Windows'ta Premium plan arasında geçirebilirsiniz. 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.
• İşlev uygulaması planlar arasında geçirilirken işlev yürütmelerinizde kapalı kalma süresi oluşur.
• Aynı Azure Dosyalar paylaşımı uygulama tarafından geçiş öncesinde ve sonrasında kullanıldığından, duruma ve uygulamaya özgü diğer içerik korunur.

Planınızı şu araçları kullanarak geçirebilirsiniz:

Azure portalı

Farklı bir plana geçmek için Azure portalını 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'ta 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 App Service planı altında App Service planını değiştir'i seçin.

2. Plan türü altında 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 Premium plan uygulamanıza gidin ve App Service planı altında App Service planını değiştir'i seçin.

2. 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'ta 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
   

   Planı, geçiş yaptığınız sıfır siteyle güvenle silebilirsiniz.

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

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

Premium-Tüketim

Bir Premium plandan Windows'ta Tüketim planına geçiş yapmak 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 kesimidir.

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

Tüketim planından Windows'ta 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

Bir Premium plandan Windows'ta Tüketim planına geçiş yapmak 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
   

İşlev erişim anahtarlarınızı alma

HTTP ile tetiklenen işlevler genellikle şu biçimde bir URL kullanılarak çağrılabilir: https://<APP_NAME>.azurewebsites.net/api/<FUNCTION_NAME>. İşlevinizin yetkilendirmesi dışında anonymousbir değer ayarlandığında, isteğinizde bir erişim anahtarı da sağlamanız gerekir. Erişim anahtarı, sorgu dizesi kullanılarak ?code= URL'de veya istek üst bilgisinde sağlanabilir. Daha fazla bilgi için bkz . İşlev erişim anahtarları. Erişim anahtarlarınızı almanın birkaç yolu vardır.

Azure portalı

1. Azure portalında oturum açın, ardından İşlev Uygulaması'nı arayın ve seçin.

2. Doğrulamak istediğiniz işlevi seçin.

3. Sol bölmede İşlevler'i genişletin ve uygulama anahtarları'nı seçin.

   Uygulama anahtarları sayfası görüntülenir. Bu sayfada konak anahtarları görüntülenir ve bu anahtarlar uygulamadaki herhangi bir işleve erişmek için kullanılabilir. Sistem anahtarı da görüntülenir ve bu da herkese tüm işlev uygulaması API'lerine yönetici düzeyinde erişim sağlar.

Ayrıca, belirli bir işlevin anahtarını kullanarak da en az ayrıcalık uygulayabilirsiniz. Bunu yapmak için HTTP ile tetiklenen işlevinizde Geliştirici'nin altında İşlev anahtarları'nı seçin.

Azure CLI

Aşağıdaki betiği Azure Cloud Shell'de çalıştırın; çıktısı, işlev uygulamasında http ile tetiklenen herhangi bir işleve erişmek için kullanılabilecek varsayılan (konak) anahtardır.

subName='<SUBSCRIPTION_ID>'
resGroup=AzureFunctionsContainers-rg
appName=glengagtestdocker
path=/subscriptions/$subName/resourceGroups/$resGroup/providers/Microsoft.Web/sites/$appName/host/default/listKeys?api-version=2018-11-01
az rest --method POST --uri $path --query functionKeys.default --output tsv

Bu betikte ve <APP_NAME> değerini <SUBSCRIPTION_ID> aboneliğinizin kimliğiyle ve işlev uygulamanızın adıyla değiştirin. Bu betik Cloud Shell'de Bash üzerinde çalışır. Windows komut isteminde çalıştırılacak şekilde değiştirilmelidir.

Azure PowerShell

Çıktısı , işlev uygulamasında http ile tetiklenen herhangi bir işleve erişmek için kullanılabilecek varsayılan (konak) anahtar olan aşağıdaki betiği çalıştırın.

$subName = '<SUBSCRIPTION_ID>'
$rGroup = 'AzureFunctionsContainers-rg'
$appName = '<APP_NAME>'
$path = "/subscriptions/$subName/resourceGroups/$rGroup/providers/Microsoft.Web/sites/$appName/host/default/listKeys?api-version=2018-11-01"
((Invoke-AzRestMethod -Path $path -Method POST).Content | ConvertFrom-JSON).functionKeys.default

Bu betikte ve yerine sırasıyla aboneliğinizin kimliğini ve işlev uygulamanızın adını yazın <SUBSCRIPTION_ID> <APP_NAME> .

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

İşlevlerinizi Azure portalında geliştirirken şu 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# Betik işlevleri için desteklenir.
• Flex Consumption planının önizleme sürümünde portal içi düzenleme desteklenmez.
• 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.
• Derlenmiş C# işlevleri ve Java işlevleri için, işlev uygulamasını ve ilgili kaynakları portalda oluşturabilirsiniz. Ancak işlev kodu projesini yerel olarak oluşturup Azure'da yayımlamanız gerekir.

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

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 non-.NET dilleri ve C# betiği için uzantı paketlerini kullanmanız gerekir. Uzantıları el ile yüklemeniz gerekiyorsa, Azure İşlevleri Core Tools'u yerel olarak kullanarak bunu 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 extensionBundle emin olun.

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

Önemli

Mümkün olduğunda, dosyaları doğrudan Azure'daki işlev uygulamanızda 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ştirmenizi sağlar:

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'i 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 Uygulaması Hizmeti platformunda çalışır. Bu nedenle işlev uygulamalarınız Azure'ın 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ğine erişebilirsiniz.

Aşağıdaki matris, barındırma planı ve işletim sistemi ile Azure portalı özellik desteğini gösterir:

Özellik	Tüketim planı	Premium planı	Ayrılmış plan
Gelişmiş araçlar (Kudu)	Windows: ✔ Linux: X	✔	✔
App Service düzenleyicisi	Windows: ✔ Linux: X	Windows: ✔ Linux: X	Windows: ✔ Linux: X
Yedeklemeler	X	X	✔
Konsol	Windows: komut satırı Linux: 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. Azure Uygulaması Hizmet Ayarlarını Yapılandırma.

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'da yayımladığınızda, proje dosyalarınız Azure portalında salt okunur olur. Daha fazla bilgi için bkz. Yerel olarak Azure İşlevleri kod ve test.

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 İşlevleri Core Tools ve Azure CLI'yi 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. Güncelleştirmeler yaptığınızda projeniz oluşturulur ve Azure'a dağıtılır. Daha fazla bilgi için bkz. Azure İşlevleri dağıtım teknolojileri.

Çıkış noktaları arası kaynak paylaşma

İ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), üst Access-Control-Allow-Origin bilginin işlev uygulamanızda uç noktaları çağırmasına izin verilen kaynakları bildirmesine olanak tanır.

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 etki alanı 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 Twitter 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. hizmet kimlik doğrulamasına genel bakış Azure Uygulaması.

İlgili içerik

• App Service uygulamasını yapılandırma
• Azure İşlevleri için sürekli dağıtım