AzureRmWebAppDeployment@3 - v3 görevini dağıtma Azure App Service

  • Makale

Docker, Java, .NET, .NET Core, Node.js, PHP, Python veya Ruby kullanarak bir 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.

Windows üzerinde Azure Uygulaması Hizmetlerini, Linux üzerinde Web App'i yerleşik görüntüler veya docker kapsayıcıları, ASP.NET, .NET Core, PHP, Python veya Node.js tabanlı Web uygulamaları, İşlev Uygulamaları, Mobile Apps, API uygulamaları ve Web İşleri ile Web Dağıtımı/Kudu REST API'lerini kullanarak güncelleştirin.

Syntax

# Azure App Service deploy v3
# 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@3
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    appType: 'app' # 'app' | 'applinux' | 'functionapp' | 'api' | 'mobileapp'. Alias: WebAppKind. Required. App type. Default: app.
    WebAppName: # string. Required. App Service name. 
    #DeployToSlotFlag: false # boolean. Optional. Use when WebAppKind != "". Deploy to slot. Default: false.
    #ResourceGroupName: # string. Required when DeployToSlotFlag = true. Resource group. 
    #SlotName: # string. Required when DeployToSlotFlag = true. Slot. 
    #ImageSource: 'Registry' # 'Registry' | 'Builtin'. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Image Source. Default: Registry.
    #AzureContainerRegistry: # string. Required when ImageSource = AzureContainerRegistry. Registry. 
    #AzureContainerRegistryLoginServer: # string. Optional. Use when ImageSource = invalidimagesource. Registry Login Server Name. 
    #AzureContainerRegistryImage: # string. Required when ImageSource = AzureContainerRegistry. Image. 
    #AzureContainerRegistryTag: # string. Optional. Use when ImageSource = AzureContainerRegistry. Tag. 
    #DockerRepositoryAccess: 'public' # 'private' | 'public'. Required when ImageSource = invalidImage. Repository Access. Default: public.
    #dockerRegistryConnection: # string. Alias: RegistryConnectedServiceName. Required when DockerRepositoryAccess = private || ImageSource = PrivateRegistry. Registry Connection. 
    #PrivateRegistryImage: # string. Required when ImageSource = PrivateRegistry. Image. 
    #PrivateRegistryTag: # string. Optional. Use when ImageSource = PrivateRegistry. Tag. 
    #DockerNamespace: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Registry or Namespace. 
    #DockerRepository: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Image. 
    #DockerImageTag: # string. Optional. Use when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Tag. 
    #VirtualApplication: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Virtual application. 
    #Package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required when WebAppKind != linux && WebAppKind != applinux &&  WebAppKind != "". Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Alias: BuiltinLinuxPackage. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #RuntimeStack: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Runtime Stack. 
    #StartupCommand: # string. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Startup command. 
  # Output
    #WebAppUri: # string. Optional. Use when WebAppKind != "". App Service URL. 
  # Post Deployment Action
    #ScriptType: # 'Inline Script' | 'File Path'. Optional. Use when WebAppKind != "". Deployment script type. 
    #InlineScript: ':: You can provide your deployment commands here. One command per line.' # string. Required when ScriptType == Inline Script && WebAppKind != "". Inline Script. Default: :: You can provide your deployment commands here. One command per line..
    #ScriptPath: # string. Required when ScriptType == File Path && WebAppKind != "". Deployment script path. 
  # File Transforms & Variable Substitution Options
    #GenerateWebConfig: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Generate Web.config. Default: false.
    #WebConfigParameters: # string. Required when GenerateWebConfig == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Web.config parameters. 
    #enableXmlTransform: false # boolean. Alias: XmlTransformation. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML transformation. Default: false.
    #enableXmlVariableSubstitution: false # boolean. Alias: XmlVariableSubstitution. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML variable substitution. Default: false.
    #JSONFiles: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. JSON variable substitution. 
  # Application and Configuration Settings
    #AppSettings: # string. App settings. 
    #ConfigurationSettings: # string. Configuration settings. 
  # Additional Deployment Options
    #TakeAppOfflineFlag: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Take App Offline. Default: false.
    #UseWebDeploy: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Publish using Web Deploy. Default: false.
    #SetParametersFile: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". SetParameters file. 
    #RemoveAdditionalFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Remove additional files at destination. Default: false.
    #ExcludeFilesFromAppDataFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Exclude files from the App_Data folder. Default: false.
    #AdditionalArguments: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Additional arguments. 
    #RenameFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Rename locked files. Default: false.

# Azure App Service Deploy v3
# Update Azure App Services on Windows, Web App on Linux with built-in images or Docker containers, ASP.NET, .NET Core, PHP, Python or Node.js based Web applications, Function Apps, Mobile Apps, API applications, Web Jobs using Web Deploy / Kudu REST APIs.
- task: AzureRmWebAppDeployment@3
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    appType: 'app' # 'app' | 'applinux' | 'functionapp' | 'api' | 'mobileapp'. Alias: WebAppKind. Required. App type. Default: app.
    WebAppName: # string. Required. App Service name. 
    #DeployToSlotFlag: false # boolean. Optional. Use when WebAppKind != "". Deploy to slot. Default: false.
    #ResourceGroupName: # string. Required when DeployToSlotFlag = true. Resource group. 
    #SlotName: # string. Required when DeployToSlotFlag = true. Slot. 
    #ImageSource: 'Registry' # 'Registry' | 'Builtin'. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Image Source. Default: Registry.
    #AzureContainerRegistry: # string. Required when ImageSource = AzureContainerRegistry. Registry. 
    #AzureContainerRegistryLoginServer: # string. Optional. Use when ImageSource = invalidimagesource. Registry Login Server Name. 
    #AzureContainerRegistryImage: # string. Required when ImageSource = AzureContainerRegistry. Image. 
    #AzureContainerRegistryTag: # string. Optional. Use when ImageSource = AzureContainerRegistry. Tag. 
    #DockerRepositoryAccess: 'public' # 'private' | 'public'. Required when ImageSource = invalidImage. Repository Access. Default: public.
    #dockerRegistryConnection: # string. Alias: RegistryConnectedServiceName. Required when DockerRepositoryAccess = private || ImageSource = PrivateRegistry. Registry Connection. 
    #PrivateRegistryImage: # string. Required when ImageSource = PrivateRegistry. Image. 
    #PrivateRegistryTag: # string. Optional. Use when ImageSource = PrivateRegistry. Tag. 
    #DockerNamespace: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Registry or Namespace. 
    #DockerRepository: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Image. 
    #DockerImageTag: # string. Optional. Use when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Tag. 
    #VirtualApplication: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Virtual application. 
    #Package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required when WebAppKind != linux && WebAppKind != applinux &&  WebAppKind != "". Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Alias: BuiltinLinuxPackage. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #RuntimeStack: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Runtime Stack. 
    #StartupCommand: # string. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Startup command. 
  # Output
    #WebAppUri: # string. Optional. Use when WebAppKind != "". App Service URL. 
  # Post Deployment Action
    #ScriptType: # 'Inline Script' | 'File Path'. Optional. Use when WebAppKind != "". Deployment script type. 
    #InlineScript: ':: You can provide your deployment commands here. One command per line.' # string. Required when ScriptType == Inline Script && WebAppKind != "". Inline Script. Default: :: You can provide your deployment commands here. One command per line..
    #ScriptPath: # string. Required when ScriptType == File Path && WebAppKind != "". Deployment script path. 
  # File Transforms & Variable Substitution Options
    #GenerateWebConfig: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Generate Web.config. Default: false.
    #WebConfigParameters: # string. Required when GenerateWebConfig == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Web.config parameters. 
    #enableXmlTransform: false # boolean. Alias: XmlTransformation. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML transformation. Default: false.
    #enableXmlVariableSubstitution: false # boolean. Alias: XmlVariableSubstitution. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML variable substitution. Default: false.
    #JSONFiles: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. JSON variable substitution. 
  # Application and Configuration Settings
    #AppSettings: # string. App settings. 
    #ConfigurationSettings: # string. Configuration settings. 
  # Additional Deployment Options
    #TakeAppOfflineFlag: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Take App Offline. Default: false.
    #UseWebDeploy: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Publish using Web Deploy. Default: false.
    #SetParametersFile: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". SetParameters file. 
    #RemoveAdditionalFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Remove additional files at destination. Default: false.
    #ExcludeFilesFromAppDataFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Exclude files from the App_Data folder. Default: false.
    #AdditionalArguments: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Additional arguments. 
    #RenameFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Rename locked files. Default: false.

Girişler

azureSubscription - Azure aboneliği
Giriş diğer adı: ConnectedServiceName. string. Gereklidir.

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


appType - Uygulama türü
Giriş diğer adı: WebAppKind. string. Gereklidir. İzin verilen değerler: app (Web Uygulaması), applinux (Linux Web Uygulaması), functionapp (İşlev Uygulaması (Önerilmez, görev Azure İşlevleri kullanın)), api (API Uygulaması), mobileapp (Mobil Uygulama). Varsayılan değer: app.

Dağıtılacak web uygulamasının türünü belirtin.

Not: Yerleşik platform görüntüleri veya özel kapsayıcı görüntüsü dağıtımları için Linux Web App'i belirtin.


appType - Uygulama türü
Giriş diğer adı: WebAppKind. string. Gereklidir. İzin verilen değerler: app (Web Uygulaması), applinux (Linux Web Uygulaması), functionapp (İşlev Uygulaması), api (API Uygulaması), mobileapp (Mobil Uygulama). Varsayılan değer: app.

Dağıtılacak web uygulamasının türünü belirtin.

Not: Yerleşik platform görüntüleri veya özel kapsayıcı görüntüsü dağıtımları için Linux Web App'i belirtin.


WebAppName - App Service adı
string. Gereklidir.

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


DeployToSlotFlag - Yuvaya dağıtma
boolean. İsteğe bağlı. when WebAppKind != ""kullanın. Varsayılan değer: false.

Üretim yuvası dışındaki mevcut bir yuvaya dağıtmak için bu seçeneği kullanın. Bu seçenek belirlenmezse, Azure App Service Üretim yuvasına dağıtılır.


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

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


SlotName - Yuvası
string. olduğunda DeployToSlotFlag = truegereklidir.

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


ImageSource - Görüntü Kaynağı
string. İsteğe bağlı. when WebAppKind = applinux || WebAppKind = linuxkullanın. İzin verilen değerler: Registry (Container Registry), Builtin (Yerleşik Görüntü). Varsayılan değer: Registry.

Linux üzerinde App Service uygulamanızı yayımlamak için iki farklı seçenek sunar:

Yerleşik bir platform görüntüsüyle özel görüntü dağıtımı veya uygulama dağıtımı.


AzureContainerRegistry - Kayıt defteri
string. olduğunda ImageSource = AzureContainerRegistrygereklidir.

Özel kayıt defteriniz için genel olarak benzersiz bir üst düzey etki alanı adı.

Not: Tam görüntü adı şu biçimde olacaktır: :<registry><repository>/<tag>. Örneğin, myregistry.azurecr.io/nginx:latest.


AzureContainerRegistryLoginServer - Kayıt Defteri Oturum Açma Sunucusu Adı
string. İsteğe bağlı. when ImageSource = invalidimagesourcekullanın.

Bir Azure kapsayıcı kayıt defteri oturum açma sunucusu adı belirtin.


AzureContainerRegistryImage - Görüntü
string. olduğunda ImageSource = AzureContainerRegistrygereklidir.

Kapsayıcı görüntülerinin depolandığı deponun adı.

Not: Tam görüntü adı şu biçimde olacaktır: :<registry><repository>/<tag>. Örneğin: myregistry.azurecr.io/nginxlatest


AzureContainerRegistryTag - Etiket
string. İsteğe bağlı. when ImageSource = AzureContainerRegistrykullanın.

Bu, kayıt defterlerinin Docker görüntülerine bir sürüm vermek için kullandığı mekanizmadır.

Not: Tam görüntü adı şu biçimde olacaktır: :<registry><repository>/<tag>. Örneğin: myregistry.azurecr.io/nginxlatest


DockerRepositoryAccess - Depo Erişimi
string. olduğunda ImageSource = invalidImagegereklidir. İzin verilen değerler: private, public. Varsayılan değer: public.

Docker deposu erişimini belirtin.


dockerRegistryConnection - Kayıt Defteri Bağlantısı
Giriş diğer adı: RegistryConnectedServiceName. string. olduğunda DockerRepositoryAccess = private || ImageSource = PrivateRegistrygereklidir.

Kayıt defteri bağlantısını belirtin.


PrivateRegistryImage - Görüntü
string. olduğunda ImageSource = PrivateRegistrygereklidir.

Kapsayıcı görüntülerinin depolandığı deponun adı.

Not: Tam görüntü adı şu biçimde olacaktır: :<registry><repository><tag>. Örneğin: myregistry.azurecr.io/nginxlatest


PrivateRegistryTag - Etiket
string. İsteğe bağlı. when ImageSource = PrivateRegistrykullanın.

Etiketler, kayıt defterlerinin Docker görüntülerine bir sürüm vermek için kullandığı mekanizmadır.

Not: Tam görüntü adı şu biçimde olacaktır: '<registry>/<repository>:<tag>'. Örneğin: myregistry.azurecr.io/nginxlatest


DockerNamespace - Kayıt Defteri veya Ad Alanı
string. olduğunda WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registrygereklidir.

Özel kayıt defteriniz veya ad alanınız için genel olarak benzersiz bir üst düzey etki alanı adı.

Not: Tam görüntü adı şu biçimde olacaktır: :<registry or namespace><repository>/<tag>. Örneğin: myregistry.azurecr.io/nginxlatest


DockerRepository - Görüntü
string. olduğunda WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registrygereklidir.

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/nginxlatest


DockerImageTag - Etiket
string. İsteğe bağlı. when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registrykullanın.

Bu, kayıt defterlerinin Docker görüntülerine bir sürüm vermek için kullandığı mekanizmadır.

Not: Tam görüntü adı şu biçimde olacaktır: '<registry or namespace>/<repository>:<tag>'. Örneğin: myregistry.azurecr.io/nginxlatest


VirtualApplication - Sanal uygulama
string. İsteğe bağlı. when WebAppKind != linux && WebAppKind != applinux && WebAppKind != ""kullanın.

Azure portal yapılandırılan Sanal Uygulamanın adını belirtin. App Service köküne yapılan dağıtımlar için bu seçenek gerekli değildir.


Package - Paket veya klasör
string. olduğunda WebAppKind != linux && WebAppKind != applinux && WebAppKind != ""gereklidir. Varsayılan değer: $(System.DefaultWorkingDirectory)/**/*.zip.

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

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

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


packageForLinux - Paket veya klasör
Giriş diğer adı: BuiltinLinuxPackage. string. olduğunda WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtingereklidir. Varsayılan değer: $(System.DefaultWorkingDirectory)/**/*.zip.

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

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. olduğunda WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtingereklidir.

Çerçeveyi ve sürümü belirtin.


StartupCommand - Başlangıç komutu
string. İsteğe bağlı. when WebAppKind = applinux || WebAppKind = linuxkullanın.

Başlangıç komutunu belirtin.


WebAppUri - App Service URL'si
string. İsteğe bağlı. when WebAppKind != ""kullanın.

Azure App Service URL'si için oluşturulan çıkış değişkeni için bir ad belirtin. Değişken sonraki görevlerde kullanılabilir.


ScriptType - Dağıtım betiği türü
string. İsteğe bağlı. when WebAppKind != ""kullanın. İzin verilen değerler: Inline Script, File Path (Betik Dosyası Yolu).

Görev dağıtımı başarıyla tamamladıktan sonra Azure Uygulaması hizmetinde çalışacak bir betik sağlayarak dağıtımı özelleştirir. Örneğin bu, Node, PHP ve Python uygulamaları için paketleri geri yükleyebilir. Azure App Service Dağıtımı hakkında daha fazla bilgi edinin.


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


ScriptPath - Dağıtım betiği yolu
string. olduğunda ScriptType == File Path && WebAppKind != ""gereklidir.


GenerateWebConfig - Web.configoluşturma
boolean. İsteğe bağlı. when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .warkullanın. Varsayılan değer: false.

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, uygulama web.config için node.js başlangıç dosyası ve iis_node modül değerleri olacaktır. Azure App Service Dağıtımı hakkında daha fazla bilgi edinin.


WebConfigParameters - parametreleriWeb.config
string. olduğunda GenerateWebConfig == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .wargereklidir.

Oluşturulan web.config dosyadaki başlangıç dosyaları gibi değerleri düzenler. Bu düzenleme özelliği yalnızca oluşturulan öğesine yöneliktir web.config. Azure App Service Dağıtımı hakkında daha fazla bilgi edinin.


AppSettings - Uygulama ayarları
string.

web uygulaması ayarlarını söz dizimi -key değerini izleyerek düzenler. Boşluk içeren değerler çift tırnak içine alınmalıdır. Örnekler: -Port 5000-RequestTimeout 5000-WEBSITE_TIME_ZONE"Eastern Standard Time".


ConfigurationSettings - Yapılandırma ayarları
string.

Söz dizimi -key değerini izleyerek web uygulaması yapılandırma ayarlarını düzenler. Boşluk içeren değerler çift tırnak içine alınmalıdır.

Örnekler: -phpVersion 5.6-linuxFxVersion: node|6.11.


TakeAppOfflineFlag - Uygulamayı Çevrimdışına Alma
boolean. İsteğe bağlı. when WebAppKind != linux && WebAppKind != applinux && WebAppKind != ""kullanın. Varsayılan değer: false.

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


UseWebDeploy - Web Dağıtımı kullanarak yayımlama
boolean. İsteğe bağlı. when WebAppKind != linux && WebAppKind != applinux && WebAppKind != ""kullanın. Varsayılan değer: false.

Publish using Web Deploy seçenekleri yalnızca Windows aracısı kullanılırken desteklenir. Diğer platformlarda, görev Azure App Service dağıtmak için Kudu REST API'lerine dayanır ve aşağıdaki seçenekler desteklenmez.


SetParametersFile - SetParameters dosyası
string. İsteğe bağlı. when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != ""kullanın.

Kullanılacak dosyanın konumu SetParameters.xml .


RemoveAdditionalFilesFlag - Hedefte ek dosyaları kaldırma
boolean. İsteğe bağlı. when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != ""kullanı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 bu seçeneği kullanın.

Not: Bu işlem, 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ı. when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != ""kullanın. Varsayılan değer: false.

Klasördeki App_Data dosyaların Azure App Service dağıtılmasını/silinmesini önlemek için bu seçeneği kullanın.


AdditionalArguments - Ek bağımsız değişkenler
string. İsteğe bağlı. olduğunda UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != ""kullanın.

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.

Diğer Web Dağıtımı İşlem Ayarları örneklerine bakın.


RenameFilesFlag - Kilitli dosyaları yeniden adlandırma
boolean. İsteğe bağlı. olduğunda UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != ""kullanın. Varsayılan değer: false.

Azure App Service uygulama ayarlarında msdeploy bayrağını MSDEPLOY_RENAME_LOCKED_FILES=1 etkinleştirmek için bu seçeneği kullanın. seçeneği, msdeploy'un uygulama dağıtımı sırasında kilitlenen kilitli 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 != linux && WebAppKind != applinux && WebAppKind != "" && 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ştirme öncesinde çalıştırılacaktı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 != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .warkullanın. Varsayılan değer: false.

Derleme veya yayın işlem hattında tanımlanan değişkenler, ve yapılandırma dosyalarından parameters.xmlherhangi birinin , applicationSettingsve connectionStrings bölümlerindeki appSettingsveya name girdileriyle eşleştirilirkey. Değişken Değiştirme, yapılandırma dönüşümlerinden sonra çalıştırılır.

Not: Yayın işlem hattında ve ortamda aynı değişkenler tanımlanmışsa, ortam değişkenleri yayın işlem hattı değişkenlerinin yerini alır.


JSONFiles - JSON değişken değiştirme
string. İsteğe bağlı. olduğunda WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .warkullanın.

Değişken değerlerinin yerini almak için JSON dosyalarının satırlarla ayrılmış yeni bir listesini sağlar. Dosya adları kök klasöre göre sağlanacaktı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 örnekteki değerini ConnectionString değiştirmek için derleme/yayın işlem hattında (veya yayın işlem hattının ortamında) olduğu gibi Data.DefaultConnection.ConnectionString bir değişken tanımlamanız gerekir.

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

Değişken Değiştirme, yapılandırma dönüşümlerinden sonra çalıştırılır.

Not: değiştirmede işlem hattı değişkenleri dışlanır.


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

Yok.

Açıklamalar

Bu görevin daha yeni bir sürümü var. Daha fazla bilgi için bkz. AzureRmWebAppDeployment@4.

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:

  • Windows aracıda Web Dağıtımı paket biçimini kullanıyorsunuz
  • Aracınız eski birmsdeploy.exe sürümüyle çalışıyor (örneğin , Windows-2019 barındırılan aracı görüntüsünü kullanırken)
  • Azure App Service için temel kimlik doğrulaması 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'a) 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.

Gereksinimler

Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme, Klasik sürüm
Üzerinde çalıştırılır Agent, DeploymentGroup
Talep Hiçbiri
Özellikler Bu görev, işteki sonraki görevler için herhangi 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