AzureRmWebAppDeployment@4 - v4 görevini dağıtma Azure App Service

Docker, Java, .NET, .NET Core, Node.js, PHP, Python veya Ruby kullanarak web, mobil veya API uygulaması Azure App Service dağıtmak için bu görevi kullanın.

Not

Azure İşlevleri uygulamaları dağıtmak için AzureFunctionApp@1 kullanın.

Syntax

# Azure App Service deploy v4
# Deploy to Azure App Service a web, mobile, or API app using Docker, Java, .NET, .NET Core, Node.js, PHP, Python, or Ruby.
- task: AzureRmWebAppDeployment@4
  inputs:
    ConnectionType: 'AzureRM' # 'AzureRM' | 'PublishProfile'. Required. Connection type. Default: AzureRM.
    azureSubscription: # string. Alias: ConnectedServiceName. Required when ConnectionType = AzureRM. Azure subscription. 
    #PublishProfilePath: '$(System.DefaultWorkingDirectory)/**/*.pubxml' # string. Required when ConnectionType = PublishProfile. Publish profile path. Default: $(System.DefaultWorkingDirectory)/**/*.pubxml.
    #PublishProfilePassword: # string. Required when ConnectionType = PublishProfile. Publish profile password. 
    appType: 'webApp' # 'webApp' | 'webAppLinux' | 'webAppContainer' | 'webAppHyperVContainer' | 'functionApp' | 'functionAppLinux' | 'functionAppContainer' | 'apiApp' | 'mobileApp'. Alias: WebAppKind. Required when ConnectionType = AzureRM. App Service type. Default: webApp.
    WebAppName: # string. Required when ConnectionType = AzureRM. App Service name. 
    #deployToSlotOrASE: false # boolean. Alias: DeployToSlotOrASEFlag. Optional. Use when ConnectionType = AzureRM && WebAppKind != "". Deploy to Slot or App Service Environment. Default: false.
    #ResourceGroupName: # string. Required when DeployToSlotOrASEFlag = true. Resource group. 
    #SlotName: 'production' # string. Required when DeployToSlotOrASEFlag = true. Slot. Default: production.
    #DockerNamespace: # string. Required when WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = webAppHyperVContainer. Registry or Namespace. 
    #DockerRepository: # string. Required when WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = webAppHyperVContainer. Image. 
    #DockerImageTag: # string. Optional. Use when WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = webAppHyperVContainer. Tag. 
    #VirtualApplication: # string. Optional. Use when WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != functionApp && webAppKind != functionAppLinux && WebAppKind != "". Virtual application. 
    #packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Alias: Package. Required when ConnectionType = PublishProfile || WebAppKind = webApp || WebAppKind = apiApp || WebAppKind = functionApp || WebAppKind = mobileApp || WebAppKind = webAppLinux || webAppKind = functionAppLinux. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #RuntimeStack: # string. Optional. Use when WebAppKind = webAppLinux. Runtime Stack. 
    #RuntimeStackFunction: # 'DOTNET|2.2' | 'DOTNET|3.1' | 'JAVA|8' | 'JAVA|11' | 'NODE|8' | 'NODE|10' | 'NODE|12' | 'NODE|14' | 'PYTHON|3.6' | 'PYTHON|3.7' | 'PYTHON|3.8'. Optional. Use when WebAppKind = functionAppLinux. Runtime Stack. 
    #StartupCommand: # string. Optional. Use when WebAppKind = webAppLinux || WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = functionAppLinux || WebAppKind = webAppHyperVContainer. Startup command. 
  # Post Deployment Action
    #ScriptType: # 'Inline Script' | 'File Path'. Optional. Use when ConnectionType = AzureRM && WebAppKind != "" && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer. Deployment script type. 
    #InlineScript: ':: You can provide your deployment commands here. One command per line.' # string. Required when ScriptType == Inline Script && ConnectionType = AzureRM && WebAppKind != "" && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer. Inline Script. Default: :: You can provide your deployment commands here. One command per line..
    #ScriptPath: # string. Required when ScriptType == File Path && ConnectionType = AzureRM && WebAppKind != "" && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer. Deployment script path. 
  # File Transforms & Variable Substitution Options
    #WebConfigParameters: # string. Optional. Use when WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war. Generate web.config parameters for Python, Node.js, Go and Java apps. 
    #enableXmlTransform: false # boolean. Alias: XmlTransformation. Optional. Use when WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war. XML transformation. Default: false.
    #enableXmlVariableSubstitution: false # boolean. Alias: XmlVariableSubstitution. Optional. Use when WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war. XML variable substitution. Default: false.
    #JSONFiles: # string. Optional. Use when WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war. JSON variable substitution. 
  # Application and Configuration Settings
    #AppSettings: # string. Optional. Use when ConnectionType = AzureRM. App settings. 
    #ConfigurationSettings: # string. Optional. Use when ConnectionType = AzureRM. Configuration settings. 
  # Additional Deployment Options
    #enableCustomDeployment: false # boolean. Alias: UseWebDeploy. Optional. Use when ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Select deployment method. Default: false.
    #DeploymentType: 'webDeploy' # 'webDeploy' | 'zipDeploy' | 'runFromZip'. Required when UseWebDeploy == true && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Deployment method. Default: webDeploy.
    #TakeAppOfflineFlag: true # boolean. Optional. Use when UseWebDeploy == true && DeploymentType != runFromZip && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Take App Offline. Default: true.
    #SetParametersFile: # string. Optional. Use when UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. SetParameters file. 
    #RemoveAdditionalFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Remove additional files at destination. Default: false.
    #ExcludeFilesFromAppDataFlag: true # boolean. Optional. Use when UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Exclude files from the App_Data folder. Default: true.
    #AdditionalArguments: '-retryAttempts:6 -retryInterval:10000' # string. Optional. Use when UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Additional arguments. Default: -retryAttempts:6 -retryInterval:10000.
    #RenameFilesFlag: true # boolean. Optional. Use when UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Rename locked files. Default: true.

Girişler

ConnectionType - Bağlantı türü
string. Gereklidir. İzin verilen değerler: AzureRM (Azure Resource Manager), PublishProfile (Yayımlama Profili). Varsayılan değer: AzureRM.

Web Uygulamasını dağıtmak için kullanılacak hizmet bağlantı türünü belirtin.

Visual Studio tarafından oluşturulan Yayımlama profillerini kullanmak için belirtinPublish Profile.

azureSubscription - Azure aboneliği
Giriş diğer adı: ConnectedServiceName. string. olduğunda ConnectionType = AzureRMgereklidir.

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

PublishProfilePath - Yayımlama profili yolu
string. olduğunda ConnectionType = PublishProfilegereklidir. Varsayılan değer: $(System.DefaultWorkingDirectory)/**/*.pubxml.

Visual Studio'dan oluşturulan yayımlama profilinin yolu.

PublishProfilePassword - Profil parolasını yayımlama
string. olduğunda ConnectionType = PublishProfilegereklidir.

Parolayı bir gizli dizi değişkeninde depolamanız ve bu değişkeni burada kullanmanız önerilir; örneğin. $(Password)

appType - App Service türü
Giriş diğer adı: WebAppKind. string. olduğunda ConnectionType = AzureRMgereklidir. İzin verilen değerler: webApp (Windows üzerinde Web Uygulaması), webAppLinux (Linux üzerinde Web Uygulaması), (Kapsayıcılar için Web Uygulaması (Linux)), webAppContainerwebAppHyperVContainer (Kapsayıcılar için Web Uygulaması (Windows)), functionApp (Windows'da İşlev Uygulaması (Önerilmez, Azure İşlevleri Görevi Kullan)), functionAppLinux (Linux'ta İşlev Uygulaması (Önerilmez, Azure İşlevleri Görevi Kullan)), functionAppContainer (Kapsayıcılar için İşlev Uygulaması (Linux) (Önerilmez, Kullanma Kapsayıcı görevi için Azure İşlevleri)), apiApp (API Uygulaması), mobileApp (Mobil Uygulama). Varsayılan değer: webApp.

Windows'ta Web Uygulaması, Linux'ta Web Uygulaması, Kapsayıcılar için Web Uygulaması, İşlev Uygulaması, Linux'ta İşlev Uygulaması, Kapsayıcılar için İşlev Uygulaması ve Mobil Uygulama arasından seçim yapın.

WebAppName - App Service adı
string. olduğunda ConnectionType = AzureRMgereklidir.

Var olan bir Azure App Service adını belirtin. Seçili uygulama türüne dayalı uygulama hizmetleri yalnızca görev yardımcı kullanılırken listelenir.

deployToSlotOrASE - Yuvaya veya App Service Ortamı dağıtma
Giriş diğer adı: DeployToSlotOrASEFlag. boolean. İsteğe bağlı. olduğunda ConnectionType = AzureRM && WebAppKind != ""kullanın. Varsayılan değer: false.

Mevcut bir dağıtım yuvasına veya Azure App Service ortamına dağıtma seçeneğini belirtin. Her iki hedef için de görev bir Kaynak Grubu adı gerektirir. Dağıtım hedefi bir yuvaysa, dağıtım varsayılan olarak Üretim yuvasına olur. Diğer tüm mevcut yuva adları sağlanabilir. Dağıtım hedefi Azure App Service bir ortamsa yuva adını olarak Production bırakın ve yalnızca Kaynak Grubu adını belirtin.

ResourceGroupName - Kaynak grubu
string. olduğunda DeployToSlotOrASEFlag = truegereklidir.

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

Yukarıda belirtilen Azure App Service içeren Azure Kaynak grubunu belirtin.

SlotName - Yuvası
string. olduğunda DeployToSlotOrASEFlag = truegereklidir. Varsayılan değer: production.

Üretim yuvası dışında mevcut bir yuva belirtin.

DockerNamespace - Kayıt Defteri veya Ad Alanı
string. olduğunda WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = webAppHyperVContainergereklidir.

Özel kayıt defteriniz veya ad alanınız için genel olarak benzersiz bir üst düzey etki alanı adı. Not: Tam resim adı şu biçimde olacaktır: {registry or namespace}/{repository}:{tag}. Örneğin, myregistry.azurecr.io/nginx:latest.

DockerRepository - Görüntü
string. olduğunda WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = webAppHyperVContainergereklidir.

Kapsayıcı görüntülerinin depolandığı deponun adı. Not: Tam resim adı şu biçimde olacaktır: {registry or namespace}/{repository}:{tag}. Örneğin, myregistry.azurecr.io/nginx:latest.

DockerImageTag - Etiket
string. İsteğe bağlı. olduğunda WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = webAppHyperVContainerkullanın.

Etiketler, kayıt defterlerinin Docker görüntülerine sürüm bilgilerini uygulamak için kullandığı mekanizmadır. Not: Tam resim adı şu biçimde olacaktır: {registry or namespace}/{repository}:{tag}. Örneğin, myregistry.azurecr.io/nginx:latest.

VirtualApplication - Sanal uygulama
string. İsteğe bağlı. olduğunda WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != functionApp && webAppKind != functionAppLinux && WebAppKind != ""kullanın.

Azure portal yapılandırılan Sanal Uygulamanın adını belirtin. Web sitesi köküne yapılan dağıtımlar için bu seçenek gerekli değildir. Sanal Uygulama, web projesinin dağıtımından önce yapılandırılmış olmalıdır.

packageForLinux - Paket veya klasör
Giriş diğer adı: Package. string. olduğunda ConnectionType = PublishProfile || WebAppKind = webApp || WebAppKind = apiApp || WebAppKind = functionApp || WebAppKind = mobileApp || WebAppKind = webAppLinux || webAppKind = functionAppLinuxgereklidir. Varsayılan değer: $(System.DefaultWorkingDirectory)/**/*.zip.

Paketin veya MSBuild tarafından oluşturulan app service içeriklerini içeren bir klasörün ya da sıkıştırılmış zip veya savaş dosyasının dosya yolu.

Değişkenler Derleme ve Yayın'dır. Joker karakterler desteklenir.

Örneğin $(System.DefaultWorkingDirectory)/\*\*/\*.zip veya $(System.DefaultWorkingDirectory)/\*\*/\*.war olabilir.

RuntimeStack - Çalışma Zamanı Yığını
string. İsteğe bağlı. olduğunda WebAppKind = webAppLinuxkullanın.

Linux'ta İşlev Uygulaması için çerçeveyi ve sürümü belirtin.

RuntimeStackFunction - Çalışma Zamanı Yığını
string. İsteğe bağlı. olduğunda WebAppKind = functionAppLinuxkullanın. İzin verilen değerler: DOTNET|2.2 (DOTNET|2.2 (functionapp v2)), DOTNET|3.1 (DOTNET|3.1 (functionapp v3)), JAVA|8 (JAVA|8 (functionapp v2/v3)), JAVA|11 (JAVA|11 (functionapp v3)), NODE|8 (NODE|8 (functionapp v2)), (NODE|10 (functionapp v3)), (NODE|10 (functionapp v3)) NODE|10 v2/v3)), NODE|12 (NODE|12 (functionapp v3)), NODE|14 (NODE|14 (functionapp v3)), PYTHON|3.6 (PYTHON|3.6 (functionapp v2/v3)), PYTHON|3.7 (PYTHON|3.7 (functionapp v2/v3)), PYTHON|3.8 (PYTHON|3.8 (functionapp v3)).

Çerçeveyi ve sürümü belirtin. Desteklenen çalışma zamanı sürümleri için Azure İşlevleri çalışma zamanı sürümlerine genel bakış bölümüne bakın. gibi DOCKER|microsoft/azure-functions-* eski değerler kullanım dışıdır. Lütfen açılan listeden yeni değerleri kullanın.

StartupCommand - Başlangıç komutu
string. İsteğe bağlı. olduğunda WebAppKind = webAppLinux || WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = functionAppLinux || WebAppKind = webAppHyperVContainerkullanın.

Başlangıç komutunu belirtin. Örnek:

dotnet exec filename.dll

dotnet filename.dll.

ScriptType - Dağıtım betiği türü
string. İsteğe bağlı. olduğunda ConnectionType = AzureRM && WebAppKind != "" && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainerkullanın. İzin verilen değerler: Inline Script, File Path (Betik Dosyası Yolu).

Başarılı bir dağıtımdan sonra Azure App Service üzerinde çalışan bir betik sağlayarak dağıtımı özelleştirir. Satır içi dağıtım betiğini veya bir betik dosyasının yolunu ve adını seçin. Azure App Service Dağıtımı hakkında daha fazla bilgi edinin.

InlineScript - Satır içi Betik
string. olduğunda ScriptType == Inline Script && ConnectionType = AzureRM && WebAppKind != "" && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainergereklidir. Varsayılan değer: :: You can provide your deployment commands here. One command per line..

Yürütülecek betik. Dağıtım komutlarınızı burada, her satıra bir komut olacak şekilde sağlayabilirsiniz. Aşağıdaki örneğe bakın.

ScriptPath - Dağıtım betiği yolu
string. olduğunda ScriptType == File Path && ConnectionType = AzureRM && WebAppKind != "" && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainergereklidir.

Yürütülecek betiğin yolu ve adı.

WebConfigParameters - Python, Node.js, Go ve Java uygulamaları için web.config parametreleri oluşturma
string. İsteğe bağlı. olduğunda WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .warkullanın.

Uygulamada yoksa bir standart Web.config oluşturulur ve Azure App Service dağıtılır. içindeki web.config değerler düzenlenebilir ve uygulama çerçevesine göre farklılık gösterebilir. Örneğin, uygulamalar web.config için node.js bir Başlangıç dosyası ve iis_node modül değerleri olacaktır. Bu düzenleme özelliği yalnızca oluşturulan web.configöğesine yöneliktir. Azure App Service Dağıtımı hakkında daha fazla bilgi edinin.

AppSettings - Uygulama ayarları
string. İsteğe bağlı. olduğunda ConnectionType = AzureRMkullanın.

Web uygulaması uygulama ayarlarını söz dizimini -key valuekullanarak düzenler. Boşluk içeren değerler çift tırnak içine alınmalıdır. Örnekler: -Port 5000 -RequestTimeout 5000 ve -WEBSITE_TIME_ZONE "Eastern Standard Time". İki veya daha fazla anahtar değeri sağlamak için anahtar değerleri boşlukla ayrılmalıdır. Örnek: -key1 "Value1" -Key2 "Value2".

ConfigurationSettings - Yapılandırma ayarları
string. İsteğe bağlı. olduğunda ConnectionType = AzureRMkullanın.

web uygulaması yapılandırma ayarlarını söz dizimini -key valuekullanarak düzenler. Boşluk içeren değerler çift tırnak içine alınmalıdır. Örnek: -phpVersion 5.6 -linuxFxVersion node|6.11.

enableCustomDeployment - Dağıtım yöntemini seçme
Giriş diğer adı: UseWebDeploy. boolean. İsteğe bağlı. olduğunda ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jarkullanın. Varsayılan değer: false.

İşaretsiz veya yanlış ise, görev uygulama türüne, paket biçimine ve diğer parametrelere göre en iyi dağıtım yöntemini otomatik olarak algılar. Desteklenen dağıtım yöntemlerini görüntülemek için görev yardımcı bu seçeneği işaretleyin ve uygulamanızı dağıtmak için birini seçin.

DeploymentType - Dağıtım yöntemi
string. olduğunda UseWebDeploy == true && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jargereklidir. İzin verilen değerler: webDeploy (Web Dağıtımı), zipDeploy (Zip Dağıtımı), runFromZip (Paketten Çalıştır). Varsayılan değer: webDeploy.

Uygulamanın dağıtım yöntemini belirler.

TakeAppOfflineFlag - Uygulamayı ÇevrimdışıNazıya Al
boolean. İsteğe bağlı. olduğunda UseWebDeploy == true && DeploymentType != runFromZip && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jarkullanın. Varsayılan değer: true.

Eşitleme işlemi başlamadan önce kök dizine bir app_offline.htm dosya yerleştirerek Azure App Service çevrimdışına almak için bu seçeneği belirtin. Eşitleme başarıyla tamamlandıktan sonra dosya kaldırılır.

SetParametersFile - SetParameters dosyası
string. İsteğe bağlı. olduğunda UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jarkullanın.

Kullanılacak dosyanın konumu SetParameters.xml .

RemoveAdditionalFilesFlag - Hedefte ek dosyaları kaldırma
boolean. İsteğe bağlı. olduğunda UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jarkullanın. Varsayılan değer: false.

Azure App Service App Service paketinde veya klasöründe eşleşen dosyası olmayan dosyaları silmek için 'true' değerini belirtin. Bu, bu Azure App Service yüklenen uzantılarla ilgili tüm dosyaları da kaldırır. Bunu önlemek için onay kutusunu seçin Exclude files from App_Data folder .

ExcludeFilesFromAppDataFlag - Dosyaları App_Data klasöründen dışlama
boolean. İsteğe bağlı. olduğunda UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jarkullanın. Varsayılan değer: true.

Klasördeki App_Data dosyaların Azure App Service dağıtılmasını/silinmesini önleme seçeneğini belirtin.

AdditionalArguments - Ek bağımsız değişkenler
string. İsteğe bağlı. olduğunda UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jarkullanın. Varsayılan değer: -retryAttempts:6 -retryInterval:10000.

söz dizimini -key:valueizleyen ek Web Dağıtımı bağımsız değişkenleri. Bunlar, Azure App Service dağıtılırken uygulanır. Örnekler: -disableLink:AppPoolExtension -disableLink:ContentExtension. Web Dağıtımı İşlem Ayarları hakkında daha fazla bilgi edinin.

RenameFilesFlag - Kilitli dosyaları yeniden adlandırma
boolean. İsteğe bağlı. olduğunda UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jarkullanın. Varsayılan değer: true.

Azure App Service uygulama ayarlarında msdeploy bayrağını MSDEPLOY_RENAME_LOCKED_FILES=1 etkinleştirmek için varsayılan değeri belirtin. Ayarlanırsa, bu seçenek msdeploy'un uygulama dağıtımı sırasında kilitlenen dosyaları yeniden adlandırmasını sağlar.

enableXmlTransform - XML dönüşümü
Giriş diğer adı: XmlTransformation. boolean. İsteğe bağlı. olduğunda WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .warkullanın. Varsayılan değer: false.

Yapılandırma dönüşümleri ve *.Release.config*.<EnvironmentName>.config üzerinde *.config fileçalıştırılır. Yapılandırma dönüşümleri değişken değiştirmeden önce çalıştırılır. XML dönüştürmeleri yalnızca Windows platformu için desteklenir.

enableXmlVariableSubstitution - XML değişken değiştirme
Giriş diğer adı: XmlVariableSubstitution. boolean. İsteğe bağlı. olduğunda WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .warkullanın. Varsayılan değer: false.

Derleme veya yayın işlem hattında tanımlanan değişkenler, herhangi bir yapılandırma dosyası ve dosyasının , , ve bölümlerindeki configSectionsanahtar veya parameters.xml ad girdileriyle eşleştirilir.connectionStringsapplicationSettingsappSettings Değişken değiştirme, yapılandırma dönüştürmelerinden sonra çalışır.

Yayın işlem hattında ve aşamada aynı değişkenler tanımlanmışsa, aşama değişkenleri yayın işlem hattı değişkenlerinin yerini alır. [XML değişken değiştirme]](/azure/devops/pipelines/tasks/transforms-variable-substitution#xml-variable-substitution) hakkında daha fazla bilgi edinin.

JSONFiles - JSON değişken değiştirme
string. İsteğe bağlı. olduğunda WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .warkullanın.

Değişken değerlerinin yerini almak için JSON dosyalarının yeni satırla ayrılmış bir listesini sağlar. Dosya adları kök klasöre göre olmalıdır. İç içe veya hiyerarşik JSON değişkenlerini değiştirmek için bunları ifadeler kullanarak JSONPath belirtin. Örneğin, aşağıdaki örnekte değerini değiştirmek ConnectionString için derleme veya yayın işlem hattında (veya yayın işlem hatları aşamasında) adlı Data.DefaultConnection.ConnectionString bir değişken tanımlayın.

{
  "Data": {
    "DefaultConnection": {
      "ConnectionString": "Server=(localdb)\SQLEXPRESS;Database=MyDB;Trusted_Connection=True"
    }
  }
}

Değişken değiştirme, yapılandırma dönüştürmelerinden sonra çalışır. Not: Derleme ve yayın işlem hattı değişkenleri değiştirmenin dışında tutulur. JSON değişkeni değiştirme hakkında daha fazla bilgi edinin.

Görev denetim seçenekleri

Tüm görevlerde 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örev aşağı akış adımlarında, işlerde ve aşamalarda kullanabileceğiniz aşağıdaki çıkış değişkenlerini tanımlar.

AppServiceApplicationUrl
Seçili App Service uygulama URL'si.

Açıklamalar

• Görev için önkoşullar
• Kullanım notları
• Dağıtım yöntemleri
• Sorun giderme
• SSS

Azure'da bir dizi Uygulama Hizmeti'ne dağıtmak için bu görevi kullanın. Görev, Windows, Linux veya Mac çalıştıran platformlar arası aracılarda çalışır ve temel alınan birkaç farklı dağıtım teknolojisini kullanır.

Görev ASP.NET, ASP.NET Core, PHP, Java, Python, Go ve Node.js tabanlı web uygulamaları için çalışır.

Görev, aşağıdakiler gibi bir dizi Azure Uygulaması Hizmeti'ne dağıtmak için kullanılabilir:

• Hem Windows hem de Linux üzerinde Web Apps
• Kapsayıcılar için Web Apps
• Hem Windows hem de Linux'ta İşlev Uygulamaları
• Kapsayıcılar için İşlev Uygulamaları
• Web İşleri
• Azure App Service Ortamları altında yapılandırılan uygulamalar

Görevin önkoşulları

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

• App Service örneği. Görev, bir Web Uygulaması projesini veya Azure İşlevi projesini, görev çalışmadan önce var olması gereken mevcut bir Azure App Service örneğine dağıtmak için kullanılır. App Service örneği Azure portal oluşturulabilir ve burada yapılandırılabilir. Alternatif olarak, Azure PowerShell görevi Web Uygulamasını sağlamak ve yapılandırmak için AzureRM PowerShell betiklerini çalıştırmak için kullanılabilir.

• Azure Aboneliği. Azure'a dağıtmak için bir Azure aboneliğinin işlem hattına bağlanması gerekir. Görev, Klasik Azure hizmet bağlantısıyla çalışmaz ve bu bağlantıları görevin ayarlarında listelemez.

Kullanım notları

• Görev yalnızca Azure Resource Manager API'leriyle çalışır.
• SSL hatalarını yoksaymak için işlem hattında değeriyle true adlı VSTS_ARM_REST_IGNORE_SSL_ERRORS bir değişken tanımlayın. Otomatik değiştirme için yapılandırılmış bir yuvaya dağıtıyorsanız, uygulama hizmetleri yapılandırma ayarlarında veya SCM_SKIP_ASE_SSL_VALIDATION1 olarak ayarlamadığınız SCM_SKIP_SSL_VALIDATION sürece değiştirme işlemi başarısız olur.
• Windows'da Web Uygulamasını hedefleyen .NET uygulamaları için Kilitli dosyaları yeniden adlandır ve Uygulamayı Çevrimdışına Al ayarlarının etkinleştirildiğinden emin olarak hatayla ERROR_FILE_IN_USE birlikte dağıtım hatasını önleyin. Sıfır kapalı kalma süresi dağıtımı için yuva değiştirme seçeneğini kullanın.
• Application Insights'ın yapılandırıldığı bir App Service dağıtırken ve Hedefte ek dosyaları kaldır'ı etkinleştirdiğinizde, Application Insights uzantısını güvenli bir durumda tutmak için Dosyaları App_Data klasöründen dışla seçeneğini de etkinleştirdiğinizden emin olun. Application Insights sürekli web işi App_Data klasörüne yüklendiğinden bu gereklidir.

Dağıtım yöntemleri

Bu görevde çeşitli dağıtım yöntemleri kullanılabilir. Web Dağıtımı (msdeploy.exe) varsayılan değerdir. Dağıtım seçeneğini değiştirmek için Ek Dağıtım Seçenekleri'ni genişletin ve ek paket tabanlı dağıtım seçenekleri arasından seçim yapmak için Dağıtım yöntemini seçin'i etkinleştirin.

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

• Web Dağıtımı
• Kudu REST API'leri
• Container Registry
• Zip Deploy
• Paketten çalıştırma
• Savaş Dağıtımı

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

Mantığı Otomatik Algıla

Windows tabanlı aracılar için.

App Service türü	Paket türü	Dağıtım Yöntemi
Linux üzerinde WebApp veya Linux'ta İşlev Uygulaması	Klasör/Zip/jar Savaşı	Zip Deploy War Deploy
Kapsayıcılar için WebApp (Linux) veya Kapsayıcılar için İşlev Uygulaması (Linux)	Uygulama ayarlarını güncelleştirme	NA
Windows'da WebApp, Windows'da İşlev Uygulaması, API Uygulaması veya Mobil Uygulama	War Jar MsBuild paket türü veya sanal uygulamaya dağıtma Folder/Zip	War Deploy Zip Deploy Web Deploy if postDeploymentScript == true, Zip Deploy else, Run From Package

Windows olmayan aracılarda (herhangi bir App Service türü için), görev uygulamayı dağıtmak için Kudu REST API'lerini kullanır.

Web Dağıtımı

Web Dağıtımı (msdeploy.exe), Windows'da bir Web Uygulaması veya bir İşlev Uygulaması'nı Windows aracısı kullanarak Azure App Service dağıtmak için kullanılabilir. Web Dağıtımı özellik açısından zengindir ve aşağıdakiler gibi seçenekler sunar:

• Kilitli dosyaları yeniden adlandırın: Azure App Service ayarlarında msdeploy bayrağını MSDEPLOY\_RENAME\_LOCKED\_FILES=1 etkinleştirerek web sunucusu tarafından hala kullanımda olan tüm dosyaları yeniden adlandırın. Bu seçenek ayarlanırsa, msdeploy'un uygulama dağıtımı sırasında kilitlenen dosyaları yeniden adlandırmasını sağlar.

• Hedefte ek dosyaları kaldırın: Azure App Service App Service yapıt paketinde veya dağıtılan klasörde eşleşen dosyası olmayan dosyaları siler.

• Dosyaları App_Data klasöründen dışla: App_Data klasöründeki dosyaların (yapıt paketinde/klasöründe dağıtılıyor) Azure App Service dağıtılmasını engelle

• Ek Web Dağıtımı bağımsız değişkenleri: Azure App Service dağıtılırken uygulanacak bağımsız değişkenler. Örnek: -disableLink:AppPoolExtension -disableLink:ContentExtension. Web Dağıtımı işlem ayarları hakkında daha fazla örnek için bkz. Web Dağıtımı İşlem Ayarları.

Web Dağıtımı 3.6'dan aracıya Web Dağıtımı'nı yükleyin. Web Dağıtımı 3.5, paketlenmiş SQL desteği olmadan yüklenmelidir. Web Dağıtımı'nı yüklerken herhangi bir özel ayar seçmeniz gerekmez. Web Dağıtımı konumunda C:/Program Files (x86)/IIS/Microsoft Web Deploy V3yüklenir.

Kudu REST API'leri

Kudu REST API'leri , hedef Windows üzerinde bir Web Uygulaması, Linux üzerinde Web Uygulaması (yerleşik kaynak) veya İşlev Uygulaması olduğunda hem Windows hem de Linux otomasyon aracıları üzerinde çalışır. Görev, dosyaları Azure Uygulaması hizmetine kopyalamak için Kudu kullanır.

Container Registry

Hedef Kapsayıcılar için Web Uygulaması olduğunda hem Windows hem de Linux otomasyon aracılarında çalışır. Görev, uygun kapsayıcı kayıt defteri, depo, görüntü adı ve etiket bilgilerini ayarlayarak uygulamayı güncelleştirir. Kapsayıcı görüntüsü için bir başlangıç komutu geçirmek için de görevi kullanabilirsiniz.

Zip Deploy

bir .zip dağıtım paketi bekler ve dosya içeriğini Azure'daki App Service veya İşlev Uygulamasının wwwroot klasörüne dağıtır. Bu seçenek wwwroot klasöründeki tüm içeriğin üzerine yazar. Daha fazla bilgi için bkz. Azure İşlevleri için zip dağıtımı.

Paketten çalıştırma

Zip Deploy ile aynı dağıtım paketini bekler. Ancak, wwwroot klasörüne dosya dağıtmak yerine, paketin tamamı İşlevler çalışma zamanı tarafından bağlanır ve wwwroot klasöründeki dosyalar salt okunur hale gelir. Daha fazla bilgi için bkz. Azure İşlevlerinizi paket dosyasından çalıştırma.

Savaş Dağıtımı

Bir .war dağıtım paketi bekler ve dosya içeriğini Azure'daki App Service wwwroot klasörüne veya webapps klasörüne dağıtır.

Sorun giderme

Windows aracımdan Microsoft Entra ID kimlik doğrulaması kullanarak Azure App Service'ıma Web Dağıtımı alamıyorum

Azure App Service dağıtma görevi, aşağıdaki üç koşul mevcut olmadığı sürece Microsoft Entra ID kullanarak ARM hizmet bağlantısıyla Microsoft Azure'a bağlanmayı destekler:

• Bir Windows aracıda Web Dağıtımı paket biçimini kullanıyorsunuz
• Aracınız daha eski bir msdeploy.exe sürümüyle çalışıyor (örneğin , windows-2019 barındırılan aracı görüntüsünü kullanırken)
• temel kimlik doğrulaması Azure App Service için devre dışı bırakıldı

Bu üç koşul varsa şunun gibi bir hata alırsınız: App Service is configured to not use basic authentication. This requires Web Deploy msdeploy.exe version 7.1.7225.2108 or higher. You need a version of Visual Studio that includes an updated version of msdeploy.exe. For more information, visit https://aka.ms/azdo-webapp-msdeploy.

Bu sorunu çözmek için tercih sırasına göre aşağıdaki seçenekler arasından seçim yapabilirsiniz.

1. Aracı görüntüsünü güncelleştirin. Barındırılan aracılar kullanıyorsanız , windows-2019'danwindows-2022'ye (veya windows-latest'e) geçin. Şirket içinde barındırılan aracılar kullanıyorsanız, daha yeni bir msdeploy.exesürümü edinmek için aracıya Visual Studio 2022 yükleyin.
2. Eski bir aracı görüntüsüne bağımlıysanız ve işlem hattınızın aracısını güncelleştiremiyorsanız, Azure App Service dağıtma görevinin windows-2022 (veya windows-latest) üzerinde çalışması için işi bölmeyi göz önünde bulundurun.
3. Bu seçeneklerden hiçbiri mümkün değilse, Azure App Service için temel kimlik doğrulamasını etkinleştirebilirsiniz.

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 bir sertifika kullanmak istiyorsanız, sertifikanın güvenilen bir sertifika yetkilisi tarafından imzalanması gerekir. Web uygulamanız sertifika doğrulama hataları veriyorsa, büyük olasılıkla otomatik olarak imzalanan bir sertifika kullanıyorsunuz. Hatayı çözmek için derleme veya yayın işlem hattındaki değere true adlı VSTS_ARM_REST_IGNORE_SSL_ERRORS bir değişken ayarlayın.

Sürüm uzun süre kilitleniyor 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 kodları

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

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

Azure İşlevleri, son dağıtımın üzerinden bir yıldan fazla zaman geçtiyse 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 için bu SAS'yi kullanır, bu nedenle 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 düzene sahip bir paket bulunamadı

Görevde belirtilen paketin derlemede veya önceki bir aşamada yapıt olarak yayımlanıp yayımlanmadığını 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 (varsayılan bağımsız değişkenlerle) aracılığıyla oluşturulan web paketleri, 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ı uygulayın:

1. Çözüm oluştur görevinde , MSBuild Bağımsız Değişkenlerini olarak /p:DeployOnBuild=true /p:DeployDefaultTarget=WebPublish /p:WebPublishMethod=FileSystem /p:DeleteExistingFiles=True /p:publishUrl="$(System.DefaultWorkingDirectory)\\WebAppContent"değiştirin:

   

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

   1. Kök klasörü veya dosyayı arşiv olarak$(System.DefaultWorkingDirectory)\\WebAppContentdeğiştirin.

   2. Arşiv yollarına önceden eklenen kök klasör adı onay kutusunu temizleyin:

      

Windows üzerinde web uygulaması dağıtımı başarılı oldu ama uygulama çalışmıyor

Bunun nedeni web.config uygulamanızda mevcut olmaması olabilir. Kaynağınıza bir web.config dosyası ekleyebilir veya görevin Dosya Dönüşümleri ve Değişken Değiştirme Seçenekleri'ni kullanarak otomatik olarak oluşturabilirsiniz.

• Göreve tıklayın ve Python, Node.js, Go ve Java uygulamaları için web.config parametreleri oluştur'a gidin.

  

• Parametreleri düzenlemek için Python, Node.js, Go ve Java uygulamaları için web.config parametreleri oluştur düğmesine tıklayın.

  

• Açılan listeden uygulama türünüzü seçin.

• Tamam'a tıklayın. Bu, web.config oluşturmak için gereken web.config parametreleri doldurur.

Not

Bu bölüm kullanım dışıdır ve Dosya Dönüştürme göreviyle değiştirilmiştir.

ERROR_FILE_IN_USE

.NET uygulamalarını Windows üzerinde Web App'e dağıtırken, dağıtım ERROR_FILE_IN_USE hata koduyla başarısız olabilir. Hatayı çözmek için görevde Kilitli dosyaları yeniden adlandırın ve Uygulamayı Çevrimdışına Al seçeneklerinin etkinleştirildiğinden emin olun. Sıfır kapalı kalma süresiyle dağıtımlar yapmak için yuva değiştirmeyi kullanın.

Kaynak kilitlenmesini önlemek için Paket dağıtımdan çalıştır yöntemini de kullanabilirsiniz.

Web Dağıtımı Hatası

Web dağıtımını kullanarak uygulamanızı dağıtıyorsanız, bazı hata senaryolarında Web Dağıtımı günlükte bir hata kodu gösterir. Web dağıtımı hatasını gidermek için bkz. Web Dağıtımı hata kodları.

App Service Ortamı'nda (ASE) web uygulaması dağıtımı çalışmıyor

• Azure DevOps derleme aracısının ASE'nin İç Load Balancer (ILB) ile aynı sanal ağda (alt ağ farklı olabilir) olduğundan emin olun. Bu, aracının Azure DevOps'tan kod çekmesine ve ASE'ye dağıtmasına olanak tanır.
• Azure DevOps kullanıyorsanız, aracının İnternet'ten erişilebilir olması gerekmez, ancak Azure DevOps Hizmeti'ne bağlanmak için yalnızca giden erişime ihtiyacı vardır.
• Bir Sanal Ağ dağıtılan TFS/Azure DevOps Server kullanıyorsanız aracı tamamen yalıtılabilir.
• Derleme aracısı, dağıtılması gereken Web Uygulamasının DNS yapılandırmasıyla yapılandırılmalıdır. Sanal Ağ içindeki özel kaynakların Azure DNS'de girdileri olmadığından, bunun aracı makinedeki hosts dosyasına eklenmesi gerekir.
• ASE yapılandırması için otomatik olarak imzalanan bir sertifika kullanılıyorsa, -allowUntrusted MSDeploy için dağıtma görevinde seçeneğinin ayarlanması gerekir. Değişkenin VSTS_ARM_REST_IGNORE_SSL_ERRORS true olarak ayarlanması da önerilir. ASE yapılandırması için sertifika yetkilisinden bir sertifika kullanılıyorsa, bu gerekli olmamalıdır. Otomatik değiştirme için yapılandırılmış bir yuvaya dağıtıyorsanız, uygulama hizmetleri yapılandırma ayarlarında veya SCM_SKIP_ASE_SSL_VALIDATION1 olarak ayarlamadığınız SCM_SKIP_SSL_VALIDATION sürece değiştirme işlemi başarısız olur.

SSS

ve AzureRmWebAppDeployment görevleri arasındaki AzureWebApp fark nedir?

Azure Web App görevi (AzureWebApp), Azure Web App'e dağıtmanın en basit yoludur. Varsayılan olarak, dağıtımınız Azure Web App'teki kök uygulamaya gerçekleşir.

Azure App Service Dağıtma görevi (AzureRmWebAppDeployment), aşağıdakiler gibi daha fazla özel senaryoyu işleyebilir:

• Web paketleri ve XML parametre dosyaları içindeki yapılandırma ayarlarını değiştirin.
• IIS dağıtım işlemine alışkınsanız Web Dağıtımı ile dağıtın.
• Sanal uygulamalara dağıtma.
• Kapsayıcı uygulamaları, İşlev uygulamaları, Web İşleri veya API ve Mobil uygulamalar gibi diğer uygulama türlerine dağıtın.

Not

Dosya dönüşümleri ve değişken değiştirme, Azure Pipelines'da kullanılmak üzere ayrı Dosya Dönüştürme görevi tarafından da desteklenir. Herhangi bir yapılandırma ve parametre dosyasına dosya dönüştürmeleri ve değişken değiştirmeleri uygulamak için Dosya Dönüştürme görevini kullanabilirsiniz.

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?

Bir App Service dağıtırken 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.

aracımı App Service dağıtırken bir ara sunucu arkasındaysa 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 Azure Pipelines'a bağlanmasına veya ara sunucu üzerinden Azure DevOps Server 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.

Örnekler

• Belirli bir uygulama türüne dağıtma
• Azure Web App Linux kapsayıcısına dağıtma
• Dağıtım yuvaları arasında windows App Service web uygulaması dağıtma
• Örnek Dağıtım sonrası betiği

Belirli bir uygulama türüne dağıtma

Belirli bir uygulama türüne dağıtmak için şu kabul edilen değerlerden birine ayarlayınappType: (Windows'ta Web Uygulaması), webAppLinux (Linux üzerinde Web Uygulaması), (Kapsayıcılar için Web Uygulaması - Linux), webAppContainer (Windows'da İşlev Uygulaması), functionAppfunctionAppLinux (Linux'ta İşlev Uygulaması), functionAppContainer (Kapsayıcılar için İşlev Uygulaması - Linux), (API Uygulaması), apiAppmobileApp (Mobil webApp Uygulama). Belirtilmemişse, webApp varsayılan değer olarak alınır.

Gelişmiş dağıtım seçeneklerini etkinleştirmek için parametresini enableCustomDeployment: true ekleyin ve gerektiğinde aşağıdaki parametreleri ekleyin.

# deploymentMethod: 'runFromPackage' # supports zipDeploy as well
    # appOffline: boolean    # Not applicable for 'runFromPackage'
    # setParametersFile: string
    # removeAdditionalFilesFlag: boolean
    # additionalArguments: string

Azure Web App Linux kapsayıcısına dağıtma

Aşağıdaki YAML örneği bir Azure Web App kapsayıcısına (Linux) dağıtılır.

pool:
  vmImage: ubuntu-latest

variables:
  azureSubscriptionEndpoint: Contoso
  DockerNamespace: contoso.azurecr.io
  DockerRepository: aspnetcore
  WebAppName: containersdemoapp

steps:

- task: AzureRMWebAppDeployment@4
  displayName: Azure App Service Deploy
  inputs:
    appType: webAppContainer
    ConnectedServiceName: $(azureSubscriptionEndpoint)
    WebAppName: $(WebAppName)
    DockerNamespace: $(DockerNamespace)
    DockerRepository: $(DockerRepository)
    DockerImageTag: $(Build.BuildId)

Dağıtım yuvaları arasında windows App Service web uygulaması dağıtma

Aşağıdaki örnek, bir web uygulamasını dağıtım yuvaları arasında bir Windows App Service dağıtır.

pool:
  vmImage: 'windows-latest'

variables:
  solution: '**/*.sln'
  buildPlatform: 'Any CPU'
  buildConfiguration: 'Release'

stages:
 - stage: DeployDevStage
    displayName: 'Deploy App to Dev Slot'
    jobs:
      - job:  DeployApp
        displayName: 'Deploy App'
        steps:
        - task: DownloadPipelineArtifact@2
          inputs:
            buildType: 'current'
            artifactName: 'drop'
            targetPath: '$(System.DefaultWorkingDirectory)'
        - task: AzureRmWebAppDeployment@4
          inputs:
            ConnectionType: 'AzureRM'
            azureSubscription: 'Fabrikam Azure Subscription - PartsUnlimited'
            appType: 'webApp'
            WebAppName: 'partsunlimited'
            deployToSlotOrASE: true
            ResourceGroupName: 'rgPartsUnlimited'
            SlotName: 'Dev'
            packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip'

  - stage: DeployStagingStage
    displayName: 'Deploy App to Staging Slot'
    dependsOn: DeployDevStage
    jobs:
      - job:  DeployApp
        displayName: 'Deploy App'
        steps:
        - task: DownloadPipelineArtifact@2
          inputs:
            buildType: 'current'
            artifactName: 'drop'
            targetPath: '$(System.DefaultWorkingDirectory)'
        - task: AzureRmWebAppDeployment@4
          inputs:
            appType: webApp
            ConnectionType: AzureRM            
            ConnectedServiceName: 'Fabrikam Azure Subscription - PartsUnlimited'
            ResourceGroupName: 'rgPartsUnlimited'
            WebAppName: 'partsunlimited'
            Package: '$(System.DefaultWorkingDirectory)/**/*.zip'
            deployToSlotOrASE: true
            SlotName: 'staging'

Örnek Dağıtım sonrası betiği

Görev, uygulamanın yapıtları App Service başarıyla kopyalandıktan sonra Azure App Service çalışacak bir betik sağlayarak dağıtımı özelleştirme seçeneği sağlar. Satır içi dağıtım betiği veya yapıt klasörünüzdeki bir betik dosyasının yolunu ve adını sağlamayı seçebilirsiniz.

Uygulama bağımlılıklarınızı doğrudan App Service geri yüklemek istediğinizde bu çok yararlıdır. Node, PHP ve Python uygulamaları için paketlerin geri yüklenmesi, uygulama bağımlılığı aracıdan Azure App Service büyük bir yapıtın kopyalanmasıyla sonuçlandığında zaman aşımlarını önlemeye yardımcı olur.

Dağıtım betiği örneği:

@echo off
if NOT exist requirements.txt (
 echo No Requirements.txt found.
 EXIT /b 0
)
if NOT exist "$(PYTHON_EXT)/python.exe" (
 echo Python extension not available >&2
 EXIT /b 1
)
echo Installing dependencies
call "$(PYTHON_EXT)/python.exe" -m pip install -U setuptools
if %errorlevel% NEQ 0 (
 echo Failed to install setuptools >&2
 EXIT /b 1
)
call "$(PYTHON_EXT)/python.exe" -m pip install -r requirements.txt
if %errorlevel% NEQ 0 (
 echo Failed to install dependencies>&2
 EXIT /b 1
)

Gereksinimler

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

Ayrıca bkz.

• Bu görev GitHub'da açık kaynak. Geri bildirim ve katkılar kabul edilir.