AzureFunctionApp@2 - Azure İşlevleri Dağıtma v2 görevi

Bir işlev uygulamasını .NET, Python, JavaScript, PowerShell, Java tabanlı web uygulamalarıyla güncelleştirin.

Sözdizimi

# Azure Functions Deploy v2
# Update a function app with .NET, Python, JavaScript, PowerShell, Java based web applications.
- task: AzureFunctionApp@2
  inputs:
    connectedServiceNameARM: # string. Alias: azureSubscription. Required. Azure Resource Manager connection. 
    appType: # 'functionApp' | 'functionAppLinux'. Required. App type. 
    #isFlexConsumption: false # boolean. Is Function App on Flex Consumption Plan. Default: false.
    appName: # string. Required. Azure Functions App name. 
    #deployToSlotOrASE: false # boolean. Optional. Use when appType != "" && isFlexConsumption = false. Deploy to Slot or App Service Environment. Default: false.
    #resourceGroupName: # string. Required when deployToSlotOrASE = true. Resource group. 
    #slotName: 'production' # string. Required when deployToSlotOrASE = true. Slot. Default: production.
    package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #runtimeStack: # 'DOTNET|6.0' | 'DOTNET-ISOLATED|6.0' | 'DOTNET-ISOLATED|7.0' | 'DOTNET-ISOLATED|8.0' | 'JAVA|8' | 'JAVA|11' | 'JAVA|17' | 'JAVA|21' | 'NODE|14' | 'NODE|16' | 'NODE|18' | 'NODE|20' | 'PYTHON|3.8' | 'PYTHON|3.9' | 'PYTHON|3.10' | 'PYTHON|3.11'. Optional. Use when appType = functionAppLinux && isFlexConsumption = false. Runtime stack. 
  # Application and Configuration Settings
    #appSettings: # string. App settings. 
  # Additional Deployment Options
    #deploymentMethod: 'auto' # 'auto' | 'zipDeploy' | 'runFromPackage'. Required when appType != "" && isFlexConsumption = false && package NotEndsWith .war && Package NotEndsWith .jar. Deployment method. Default: auto.

Giriş

Azure Resource Manager bağlantı
Giriş diğer adı: azureSubscription. string. Gerekli.

Dağıtım için Azure Resource Manager aboneliğini seçin.

uygulama türü
string. Gerekli. İzin verilen değerler: functionApp (Windows'ta İşlev Uygulaması), functionAppLinux (Linux'ta İşlev Uygulaması).

Dağıtım için Azure İşlev Uygulaması türünü seçin.

isFlexConsumption - Esnek Tüketim Planında İşlev Uygulamasıdır
boolean. Varsayılan değer: false.

İşlev uygulamasıEsnek Tüketim planındaysa olarak ayarlayın.

Azure İşlevleri Uygulama adı
string. Gerekli.

Mevcut bir Azure İşlevleri Uygulamasının adını belirtin. Listelenen İşlev Uygulamaları seçili uygulama türünü temel alır.

deployToSlotOrASE - Yuvaya veya App Service Ortamına Dağıtma
boolean. Opsiyonel. appType != "" && isFlexConsumption = falseolduğunda kullanın. Varsayılan değer: false.

Mevcut bir dağıtım yuvasına veya Azure App Service Ortamı'na dağıtır. Her iki hedef için de görevin bir Kaynak grubu adı gerekir.

Dağıtım hedefi bir yuvaysa, varsayılan olarak üretim yuvası olur. Diğer tüm mevcut yuva adları da sağlanabilir.

Dağıtım hedefi bir Azure App Service Ortamıysa yuva adını üretim olarak bırakın ve Kaynak grubu adını belirtin.

kaynak grubu
string. deployToSlotOrASE = truegerekir.

Dağıtım hedefi bir dağıtım yuvası veya App Service Ortamı olduğunda Kaynak grubu adı gereklidir.

Yukarıda belirtilen Azure App Service'i içeren Azure Kaynak grubunu girer veya seçer.

slotName - Yuvası
string. deployToSlotOrASE = truegerekir. Varsayılan değer: production.

Üretim yuvası hariç mevcut bir yuvayı girer veya seçer.

Paket veya klasör
string. Gerekli. Varsayılan değer: $(System.DefaultWorkingDirectory)/**/*.zip.

MSBuild veya sıkıştırılmış zip dosyası tarafından oluşturulan App Service içeriğini içeren paket veya klasörün dosya yolu. Değişkenler ( Derleme | Sürümü) ve joker karakterler desteklenir. Örneğin, $(System.DefaultWorkingDirectory)/**/*.zip.

çalışma zamanı yığını
string. Opsiyonel. appType = functionAppLinux && isFlexConsumption = falseolduğunda kullanın. İzin verilen değerler: DOTNET|6.0, DOTNET-ISOLATED|6.0, DOTNET-ISOLATED|7.0, DOTNET-ISOLATED|8.0, JAVA|8, JAVA|11, JAVA|17, JAVA|21, NODE|14, NODE|16, NODE|18, NODE|20, PYTHON|3.8, PYTHON|3.9, PYTHON|3.10, PYTHON|3.11.

İşlev uygulamanızın üzerinde çalıştırılacağı çerçeveyi ve sürümü belirtin. desteklenen çalışma zamanı sürümlerinden herhangi birini kullanabilirsiniz. DOCKER|microsoft/azure-functions-* gibi eski değerler kullanım dışıdır. Yeni değerler , görev yardımcısındaki açılan listede listelenir. Desteklenen çalışma zamanı sürümlerinde bir çerçevenin daha yeni bir sürümü varsa, listede olmasa bile belirtebilirsiniz.

Not

Bu değer şu anda sitenin üzerinde çalıştığı linuxFxVersion güncelleştirmiyor. Başka bir deyişle, yığını Node 18'den Node 20'ye güncelleştiremezsiniz. Görev şu anda yalnızca uygulama ayarlarını güncelleştirir.

uygulama ayarlarını
string.

Uygulama ayarlarını -key value söz dizimini kullanarak girin (örneğin: -Port 5000-RequestTimeout 5000-WEBSITE_TIME_ZONE). Boşluk içeren değerleri çift tırnak içine alın (örneğin: "Eastern Standard Time").

Uygulama ayarları hakkında daha fazla bilgi için bkz. Azure App ServiceOrtam değişkenleri ve uygulama ayarları.

deploymentMethod - Dağıtım yöntemi
string. appType != "" && isFlexConsumption = false && package NotEndsWith .war && Package NotEndsWith .jargerekir. İzin verilen değerler: auto (Otomatik algılama), zipDeploy (Zip Dağıtımı), runFromPackage (Paketten Çalıştır ile Zip Dağıtımı). Varsayılan değer: auto.

Uygulama için dağıtım yöntemini belirtir. Linux Tüketim uygulamaları bu yapılandırmayı desteklemez.

SKU Linux Tüketimi olduğunda zip dağıtımları için Azure Web İşleri Depolama uygulaması ayarlarının ayarlanması gerekir. Zip dağıtımları, uygulama kodunu uygulamaya yüklemek ve bağlamak için bir depolama hesabı kullanır.

Görev denetimi seçenekleri

Tüm görevlerin, görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz. Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Bu görevaşağıdaki çıkış değişkenlerini tanımlar. Bu değişkenleri aşağı akış adımlarında, işlerde ve aşamalarda kullanabilirsiniz.

AppServiceApplicationUrl
Seçili Azure İşlev Uygulamasının Uygulama URL'sini .

Açıklamalar

Azure İşlevleri Dağıtımı görevi, İşlevleri Azure'a dağıtmak üzere Azure İşlevleri'ni güncelleştirmek için kullanılır. Görev, Windows, Linux veya Mac çalıştıran platformlar arası Azure Pipelines aracılarında çalışır ve RunFromPackage, Zip Deploy ve Kudu REST API'lerinin temel dağıtım teknolojilerini kullanır.

Görev, Azure İşlevleri tarafından desteklenen diller için çalışır.

Görev için önkoşullar

Görevin düzgün çalışması için hedef makinelerde aşağıdaki önkoşulların ayarlanması gerekir.

Azure İşlevi

Görev, bir Azure İşlevleri projesini mevcut bir Azure İşlevi'ne dağıtmak için kullanılır. Görevi çalıştırmadan önce Azure İşlevi uygulaması mevcut olmalıdır. Azure İşlev Uygulaması, Azure portalından oluşturulabilir. Alternatif olarak azure powershell görev , Azure İşlevi uygulamasını sağlamak ve yapılandırmak için AzureRM PowerShell betiklerini çalıştırmak için kullanılabilir.

Görev , Azure İşlevleri'ni (Windows/Linux) dağıtmak için kullanılabilir.

Azure Aboneliği

Azure'a dağıtmak için Bir Azure aboneliğinin Hesap Yönetimi bölümündeki Hizmetler sekmesi kullanılarak Azure Pipelines'a bağlanması gerekir. Hesap Yönetimi ekranını (ekranın sağ üst köşesindeki dişli simgesi) açıp Hizmetler Sekmesine tıklayarak Derleme veya Yayın Yönetimi tanımında kullanılacak Azure aboneliğini ekleyin.

ARM hizmet uç noktasını oluşturun ve Azure Resource Manager uç nokta türünü kullanın. Diğer ayrıntılar için,buradaki bağlantı listelenen adımları izleyin.

Görev, Klasik Azure hizmet uç noktasıyla çalışmaz ve bu bağlantıları görevdeki parametrelerde listelemez.

Dağıtım yöntemleri

Bu görevde çeşitli dağıtım yöntemleri kullanılabilir.

Tasarımcı görevinde paket tabanlı dağıtım seçeneğini değiştirmek için Ek Dağıtım Seçenekleri genişletin veDağıtım Yöntemi Seç etkinleştirin.

Azure App Service ve Azure Pipelines aracısının türüne bağlı olarak, görev uygun bir dağıtım teknolojisi kullanır. Görevler tarafından kullanılan dağıtım teknolojileri şunlardır:

• Kudu REST API
• Zip Dağıtımı
• Paketten Çalıştır

Varsayılan olarak, görev giriş paketine, App Service türüne ve aracı işletim sistemine göre uygun dağıtım teknolojisini seçmeye çalışır.

• Dağıtım sonrası betiği sağlanmışsa Zip Deploy kullanın.
• App Service türü Linux üzerinde Web Uygulaması ise Zip Deploy kullanın.
• Bir .war dosyası sağlanmışsa War Deploy'ı kullanın.
• bir .jar dosyası sağlanırsa, Zip'ten Çalıştır'ı kullanın.
• Diğer tüm görevler için Paketten Çalıştır 'ı kullanın (Zip Dağıtımı aracılığıyla).

Windows olmayan bir aracıda (herhangi bir App Service türü için), görev web uygulamasını dağıtmak için Kudu REST API'sine dayanır.

Kudu REST API

Kudu REST API'sinin hem Windows hem de Linux otomasyon aracılarında çalışması için hedef, Windows üzerinde bir Web Uygulaması, Linux üzerinde Web Uygulaması (yerleşik kaynak) veya bir işlev uygulamasıdır. Görev, Azure App Service'e dosya kopyalamak için Kudu kullanır.

Zip Dağıtımı

Zip Deploy, seçilen paketten veya klasörden bir .zip dağıtım paketi oluşturur. Ardından dosya içeriğini Azure'daki App Service adı işlev uygulamasının wwwroot klasörüne dağıtır. Bu seçenek wwwroot klasöründeki tüm mevcut içeriğin üzerine yazar. Daha fazla bilgi için bkz. Azure İşlevleri için zip dağıtımı.

Paketten Çalıştır

Paketten Çalıştır, Zip Deploy ile aynı dağıtım paketini oluşturur. İşlevler çalışma zamanı, wwwroot klasörüne dosya dağıtmak yerine paketin tamamını bağlar. Bu seçeneği kullandığınızda wwwroot klasöründeki dosyalar salt okunur hale gelir. Daha fazla bilgi için bkz. Azure İşlevlerinizi bir paket dosyasından çalıştırma.

Sorun giderme

Hata: Azure için erişim belirteci getirilemedi. Kullanılan Hizmet Sorumlusunun geçerli olduğunu ve süresinin dolmadığını doğrulayın.

Görev, Azure ile kimlik doğrulaması yapmak için hizmet bağlantısındaki hizmet sorumlusunu kullanır. Hizmet sorumlusunun süresi dolduysa veya App Service izinleri yoksa, görev bu hatayla başarısız olur. Kullanılan hizmet sorumlusunun geçerliliğini ve uygulama kaydında mevcut olduğunu doğrulayın. Daha fazla bilgi için bkz. Azure abonelik kaynaklarınıza erişimi yönetmek için rol tabanlı erişim denetimini kullanma. Bu blog gönderisi ayrıca hizmet sorumlusu kimlik doğrulaması kullanma hakkında daha fazla bilgi içerir.

SSL hatası

App Service'te bir sertifika kullanmak istiyorsanız, sertifikanın güvenilir bir sertifika yetkilisi tarafından imzalanması gerekir. Web uygulamanız size sertifika doğrulama hataları veriyorsa, büyük olasılıkla otomatik olarak imzalanan bir sertifika kullanıyorsunuz demektir. Hatayı çözmek için derleme veya yayın işlem hattındaki VSTS_ARM_REST_IGNORE_SSL_ERRORS değerine true adlı bir değişken ayarlayın.

Bir sürüm uzun süre askıda kalıyor ve sonra başarısız oluyor

Bu sorun, App Service planınızda yetersiz kapasitenin sonucu olabilir. Bu sorunu çözmek için kullanılabilir CPU, RAM ve disk alanını artırmak için App Service örneğinin ölçeğini artırabilir veya farklı bir App Service planıyla deneyebilirsiniz.

5xx hata kodu

5xx hatası görüyorsanız Azure hizmetinizin durumunu denetleyin.

Azure İşlevi aniden çalışmayı durdurdu

Son dağıtımdan bu yana bir yıldan fazla zaman geçtiyse Azure İşlevleri aniden çalışmayı durdurabilir. "deploymentMethod" içinde "RunFromPackage" ile dağıtım yaparsanız, son kullanma tarihi 1 yıl olan bir SAS oluşturulur ve uygulama yapılandırmasında "WEBSITE_RUN_FROM_PACKAGE" değeri olarak ayarlanır. Azure İşlevleri, işlev yürütmesi için paket dosyasına başvurmak üzere bu SAS'yi kullanır, dolayısıyla SAS'nin süresi dolduysa işlev yürütülmeyecektir. Bu sorunu çözmek için yeniden dağıtarak son kullanma tarihi bir yıl olan bir SAS oluşturun.

Hata: Belirtilen desene sahip paket bulunamadı

Görevde bahsedilen paketin derlemede veya önceki bir aşamada yapıt olarak yayımlanıp yayımlanmadığı ve geçerli işe indirilip indirilmediğini denetleyin.

Hata: Zip dağıtımı kullanarak yayımlama seçeneği msBuild paket türü için desteklenmiyor

MSBuild görevi aracılığıyla oluşturulan web paketleri (varsayılan bağımsız değişkenlerle) yalnızca Web Dağıtımı tarafından doğru dağıtılabilir iç içe bir klasör yapısına sahiptir. Bu paketleri dağıtmak için zip'e yayımla dağıtım seçeneği kullanılamaz. Paketleme yapısını dönüştürmek için şu adımları izleyin:

1. Çözüm oluşturma görevinde, MSBuild Bağımsız Değişkenleri'ni olarak değiştirin:

   

2. Arşiv görevi ekleyin ve değerleri aşağıdaki gibi değiştirin:

   1. arşivleye Kök klasör veya dosyayı olarak değiştirin.

   2. Yolları arşivle için ön ekli kök klasör adını onay kutusunu temizleyin:

      

Windows'ta işlev uygulaması dağıtımı başarılı olur ancak uygulama çalışmaz

Uygulamanızda bir web.config dosyası yoksa bu sorun oluşabilir. Kaynağınıza bir web.config dosyası ekleyebilir veya görevin Uygulama ve Yapılandırma Ayarları'nı kullanarak otomatik olarak bir dosya oluşturabilirsiniz.

1. Görevi seçin ve Python, Node.js, Go ve Java uygulamaları için web.config parametreleri oluştur'a gidin:

   

2. Parametreleri düzenlemek için Python, Node.js, Go ve Java uygulamaları için web.config parametreleri oluştur altındaki Diğer düğmesini (...) seçin:

   

3. Uygulama çerçevesi listesinden uygulama türünüzü seçin.

4. tamamseçin. Bunu yaptığınızda, web.config dosyasını oluşturmak için gereken web.config parametreleri doldurulur.

SSS

Hizmet bağlantımı nasıl yapılandırmalıyım?

Bu görev,bir Azure Resource Manager hizmet bağlantısı gerektirir.

Application Insights ile web işi dağıtımlarını nasıl yapılandırmalıyım?

App Service'e dağıtım yaparken , Application Insights'ı yapılandırdıysanız ve etkinleştirdiyseniz Remove additional files at destinationöğesini de etkinleştirmeniz Exclude files from the App_Data foldergerekir. Bu seçeneğin etkinleştirilmesi, Application Insights uzantısının güvenli durumda kalmasını sağlar. Application Insights sürekli Web İşi App_Data klasörüne yüklendiğinden bu adım gereklidir.

App Service'e dağıtım yaparken ara sunucu arkasındaysa aracımı nasıl yapılandırmalıyım?

Şirket içinde barındırılan aracınız bir web ara sunucusu gerektiriyorsa, aracıyı yapılandırma sırasında ara sunucu hakkında bilgilendirebilirsiniz. Bunun yapılması, aracınızın ara sunucu aracılığıyla Azure Pipelines'a veya Azure DevOps Server'a bağlanmasına olanak tanır. Web ara sunucusunun arkasında şirket içinde barındırılan aracı çalıştırma hakkında daha fazla bilgi edinin.

Azure Resource Manager hizmet bağlantısı ve Microsoft tarafından barındırılan bir aracı kullanarak iç App Service Ortamına dağıtamıyorum

Tasarım gereği, Microsoft tarafından barındırılan bir aracı App Service Ortamı ile çalışmaz. Bunun yerine, App Service Ortamı ile aynı sanal ağda yer alan bir sanal makinede özel bir aracı yapılandırmanız gerekir. Ayrıca, kaynaklar arasındaki iletişimi etkinleştirmek için özel bir DNS bölgesi ayarlayın.

Örnekler

Windows'da Azure işlevlerini dağıtan örnek bir YAML kod parçacığı aşağıda verilmiştir:

variables:
  azureSubscription: Contoso
  # To ignore SSL error, uncomment the below variable
  # VSTS_ARM_REST_IGNORE_SSL_ERRORS: true

steps:
- task: AzureFunctionApp@2
  displayName: Azure Function App Deploy
  inputs:
    azureSubscription: $(azureSubscription)
    appName: samplefunctionapp
    appType: functionApp
    package: $(System.DefaultWorkingDirectory)/**/*.zip

Linux'ta bir işlev dağıtmak için appType parametresini ekleyin ve appType: functionAppLinuxolarak ayarlayın. Bir değer belirtmezseniz functionApp varsayılan değerdir.

Dağıtım yöntemini Açıkça Zip Deploy olarak belirtmek için parametresini deploymentMethod: zipDeployekleyin. Bu parametre için desteklenen başka bir değer de runFromPackage. Bir değer belirtmezseniz auto varsayılan değerdir.

CI/CD işlem hattı oluşturmayı gösteren bir kılavuz için bkz. Azure İşlevleri'ne Java derleme ve dağıtma.

Gereksinim -leri

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır	Agent, DeploymentGroup
Talep	Hiç kimse
Yetenek -lerini	Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları	Herhangi
Ayarlanabilir değişkenler	Herhangi
Aracı sürümü	2.104.1 veya üzeri
Görev kategorisi	Dağıtmak