AzureRmWebAppDeployment@3 - Azure App Service menyebarkan tugas v3

Gunakan tugas ini untuk menyebarkan Azure App Service aplikasi web, seluler, atau API menggunakan Docker, Java, .NET, .NET Core, Node.js, PHP, Python, atau Ruby.

Catatan

Gunakan AzureFunctionApp@1 untuk menyebarkan aplikasi Azure Functions.

Perbarui Azure App Services di Windows, Aplikasi Web di Linux dengan gambar bawaan atau kontainer docker, ASP.NET, .NET Core, PHP, Python, atau aplikasi Web berbasis Node.js, Aplikasi Fungsi, Aplikasi Seluler, aplikasi API, dan Pekerjaan Web menggunakan WEB Deploy/Kudu REST API.

Sintaks

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

Input

azureSubscription - Langganan Azure
Alias input: ConnectedServiceName. string. Wajib diisi.

Tentukan langganan Azure Resource Manager untuk penyebaran.


appType - Jenis aplikasi
Alias input: WebAppKind. string. Wajib diisi. Nilai yang diizinkan: app (Aplikasi Web), applinux (Aplikasi Web Linux), functionapp (Aplikasi Fungsi (Tidak Disarankan, Gunakan tugas Azure Functions)), api (Aplikasi API), mobileapp (Aplikasi Seluler). Nilai default: app.

Tentukan jenis aplikasi web yang akan disebarkan.

Catatan: Tentukan Aplikasi Web Linux untuk gambar platform bawaan atau penyebaran gambar kontainer kustom.


appType - Jenis aplikasi
Alias input: WebAppKind. string. Wajib diisi. Nilai yang diizinkan: app (Aplikasi Web), applinux (Aplikasi Web Linux), functionapp (Aplikasi Fungsi), api (Aplikasi API), mobileapp (Aplikasi Seluler). Nilai default: app.

Tentukan jenis aplikasi web yang akan disebarkan.

Catatan: Tentukan Aplikasi Web Linux untuk gambar platform bawaan atau penyebaran gambar kontainer kustom.


WebAppName - nama App Service
string. Wajib diisi.

Tentukan nama Azure App Service yang ada. Layanan aplikasi berdasarkan jenis aplikasi yang dipilih hanya akan dicantumkan saat menggunakan tugas asisten.


DeployToSlotFlag - Menyebarkan ke slot
boolean. Opsional. Gunakan saat WebAppKind != "". Nilai default: false.

Gunakan opsi ini untuk menyebarkan ke slot yang ada selain slot Produksi. Jika opsi ini tidak dipilih, maka Azure App Service akan disebarkan ke slot Produksi.


ResourceGroupName - Grup sumber daya
string. Diperlukan saat DeployToSlotFlag = true.

Tentukan grup Sumber Daya Azure yang berisi Azure App Service yang ditentukan di atas.


SlotName - Slot
string. Diperlukan saat DeployToSlotFlag = true.

Tentukan slot yang ada selain slot Produksi.


ImageSource - Sumber Gambar
string. Opsional. Gunakan saat WebAppKind = applinux || WebAppKind = linux. Nilai yang diizinkan: Registry (Container Registry), Builtin (Gambar Bawaan). Nilai default: Registry.

App Service di Linux menawarkan dua opsi berbeda untuk menerbitkan aplikasi Anda:

Penyebaran gambar kustom atau penyebaran aplikasi dengan gambar platform bawaan.


AzureContainerRegistry - Registri
string. Diperlukan saat ImageSource = AzureContainerRegistry.

Nama domain tingkat atas yang unik secara global untuk registri spesifik Anda.

Catatan: Nama gambar yang sepenuhnya memenuhi syarat akan memiliki format: <registry>/<repository>:.<tag> Misalnya, myregistry.azurecr.io/nginx:latest.


AzureContainerRegistryLoginServer - Nama Server Masuk Registri
string. Opsional. Gunakan saat ImageSource = invalidimagesource.

Tentukan nama server masuk registri kontainer Azure.


AzureContainerRegistryImage - Gambar
string. Diperlukan saat ImageSource = AzureContainerRegistry.

Nama repositori tempat gambar kontainer disimpan.

Catatan: Nama gambar yang sepenuhnya memenuhi syarat akan memiliki format: <registry>/<repository>:.<tag> Misalnya, myregistry.azurecr.io/nginx:.latest


AzureContainerRegistryTag - Tag
string. Opsional. Gunakan saat ImageSource = AzureContainerRegistry.

Ini adalah mekanisme yang digunakan registri untuk memberi gambar Docker versi.

Catatan: Nama gambar yang sepenuhnya memenuhi syarat akan memiliki format: <registry>/<repository>:.<tag> Misalnya, myregistry.azurecr.io/nginx:.latest


DockerRepositoryAccess - Akses Repositori
string. Diperlukan saat ImageSource = invalidImage. Nilai yang diizinkan: private, public. Nilai default: public.

Tentukan akses repositori Docker.


dockerRegistryConnection - Koneksi Registri
Alias input: RegistryConnectedServiceName. string. Diperlukan saat DockerRepositoryAccess = private || ImageSource = PrivateRegistry.

Tentukan koneksi registri.


PrivateRegistryImage - Gambar
string. Diperlukan saat ImageSource = PrivateRegistry.

Nama repositori tempat gambar kontainer disimpan.

Catatan: Nama gambar yang sepenuhnya memenuhi syarat akan memiliki format: <registry><repository>:<tag>. Misalnya, myregistry.azurecr.io/nginx:.latest


PrivateRegistryTag - Tag
string. Opsional. Gunakan saat ImageSource = PrivateRegistry.

Tag adalah mekanisme yang digunakan registri untuk memberi gambar Docker versi.

Catatan: Nama gambar yang sepenuhnya memenuhi syarat akan memiliki format: '<registry>/<repository>:<tag>'. Misalnya, myregistry.azurecr.io/nginx:.latest


DockerNamespace - Registri atau Namespace
string. Diperlukan saat WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Nama domain tingkat atas yang unik secara global untuk registri atau namespace khusus Anda.

Catatan: Nama gambar yang sepenuhnya memenuhi syarat akan memiliki format: <registry or namespace>/<repository>:.<tag> Misalnya, myregistry.azurecr.io/nginx:.latest


DockerRepository - Gambar
string. Diperlukan saat WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Nama repositori tempat gambar kontainer disimpan.

Catatan: Nama gambar yang sepenuhnya memenuhi syarat akan memiliki format: '<registry or namespace>/<repository>:.<tag> Misalnya, myregistry.azurecr.io/nginx:.latest


DockerImageTag - Tag
string. Pilihan. Gunakan saat WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Ini adalah mekanisme yang digunakan registri untuk memberi gambar Docker versi.

Catatan: Nama gambar yang sepenuhnya memenuhi syarat akan memiliki format: '<registry or namespace>/<repository>:<tag>'. Misalnya, myregistry.azurecr.io/nginx:.latest


VirtualApplication - Aplikasi virtual
string. Pilihan. Gunakan saat WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

Tentukan nama Aplikasi Virtual yang telah dikonfigurasi dalam portal Azure. Opsi ini tidak diperlukan untuk penyebaran ke akar App Service.


Package - Paket atau folder
string. Diperlukan saat WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Nilai default: $(System.DefaultWorkingDirectory)/**/*.zip.

Jalur file ke paket atau folder yang berisi konten layanan aplikasi yang dihasilkan oleh MSBuild atau file zip atau perang terkompresi.

Variabel adalah Build dan Release. Kartubebas didukung.

Misalnya, $(System.DefaultWorkingDirectory)/\*\*/\*.zip atau $(System.DefaultWorkingDirectory)/\*\*/\*.war.


packageForLinux - Paket atau folder
Alias input: BuiltinLinuxPackage. string. Diperlukan saat WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Nilai default: $(System.DefaultWorkingDirectory)/**/*.zip.

Jalur file ke paket atau folder yang berisi konten layanan aplikasi yang dihasilkan oleh MSBuild atau file zip atau perang terkompresi.

Variabel adalah Build dan Release. Kartubebas didukung.

Misalnya, $(System.DefaultWorkingDirectory)/\*\*/\*.zip atau $(System.DefaultWorkingDirectory)/\*\*/\*.war.


RuntimeStack - Tumpukan Runtime
string. Diperlukan saat WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin.

Tentukan kerangka kerja dan versi.


StartupCommand - Perintah startup
string. Opsional. Gunakan saat WebAppKind = applinux || WebAppKind = linux.

Tentukan perintah startup.


WebAppUri - URL App Service
string. Pilihan. Gunakan saat WebAppKind != "".

Tentukan nama untuk variabel output yang dihasilkan untuk URL Azure App Service. Variabel dapat digunakan dalam tugas berikutnya.


ScriptType - Jenis skrip penyebaran
string. Pilihan. Gunakan saat WebAppKind != "". Nilai yang diizinkan: Inline Script, File Path (Jalur File Skrip).

Menyesuaikan penyebaran dengan menyediakan skrip yang akan berjalan pada layanan Azure App setelah tugas berhasil menyelesaikan penyebaran . Misalnya, ini dapat memulihkan paket untuk aplikasi Node, PHP, dan Python. Pelajari selengkapnya tentang Penyebaran Azure App Service.


InlineScript - Skrip Sebaris
string. Diperlukan saat ScriptType == Inline Script && WebAppKind != "". Nilai default: :: You can provide your deployment commands here. One command per line..


ScriptPath - Jalur skrip penyebaran
string. Diperlukan saat ScriptType == File Path && WebAppKind != "".


GenerateWebConfig - Hasilkan Web.config
boolean. Pilihan. Gunakan saat WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Nilai default: false.

Standar Web.config akan dihasilkan dan disebarkan ke Azure App Service jika aplikasi tidak memilikinya. Nilai dalam dapat diedit web.config dan bervariasi berdasarkan kerangka kerja aplikasi. Misalnya, untuk node.js aplikasi, web.config akan memiliki file startup dan iis_node nilai modul. Pelajari selengkapnya tentang Penyebaran Azure App Service.


WebConfigParameters - parameterWeb.config
string. Diperlukan saat GenerateWebConfig == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war.

Mengedit nilai seperti file startup dalam file yang dihasilkan web.config . Fitur edit ini hanya untuk yang dihasilkan web.config. Pelajari selengkapnya tentang Penyebaran Azure App Service.


AppSettings - Pengaturan aplikasi
string.

Mengedit pengaturan aplikasi aplikasi web mengikuti sintaks -nilai kunci . Nilai yang berisi spasi harus diapit dalam tanda kutip ganda. Contoh: -Port 5000-WEBSITE_TIME_ZONE-RequestTimeout 5000"Eastern Standard Time".


ConfigurationSettings - Pengaturan konfigurasi
string.

Mengedit pengaturan konfigurasi aplikasi web dengan mengikuti nilai sintaks -key . Nilai yang berisi spasi harus diapit dalam tanda kutip ganda.

Contoh: -phpVersion 5.6-linuxFxVersion: node|6.11.


TakeAppOfflineFlag - Ambil Aplikasi Offline
boolean. Opsional. Gunakan saat WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Nilai default: false.

Gunakan opsi ini untuk mengambil Azure App Service offline dengan menempatkan app_offline.htm file di direktori akar App Service sebelum operasi sinkronisasi dimulai. File akan dihapus setelah operasi sinkronisasi berhasil diselesaikan.


UseWebDeploy - Menerbitkan menggunakan Web Deploy
boolean. Pilihan. Gunakan saat WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Nilai default: false.

Publish using Web Deploy opsi hanya didukung saat menggunakan agen Windows. Pada platform lain, tugas bergantung pada REST API Kudu untuk menyebarkan Azure App Service, dan opsi berikut tidak didukung.


SetParametersFile - File SetParameters
string. Pilihan. Gunakan saat UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

Lokasi file yang akan SetParameters.xml digunakan.


RemoveAdditionalFilesFlag - Menghapus file tambahan di tujuan
boolean. Pilihan. Gunakan saat UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Nilai default: false.

Gunakan opsi ini untuk menghapus file pada Azure App Service yang tidak memiliki file yang cocok dalam paket atau folder App Service.

Catatan: Ini juga akan menghapus semua file yang terkait dengan ekstensi apa pun yang diinstal pada Azure App Service ini. Untuk mencegah hal ini, pilih kotak Exclude files from App_Data folder centang.


ExcludeFilesFromAppDataFlag - Mengecualikan file dari folder App_Data
boolean. Opsional. Gunakan saat UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Nilai default: false.

Gunakan opsi ini untuk mencegah file dalam App_Data folder disebarkan ke/dihapus dari Azure App Service.


AdditionalArguments - Argumen tambahan
string. Pilihan. Gunakan saat UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

Argumen Web Deploy tambahan mengikuti sintaks -key:value.

Ini akan diterapkan saat menyebarkan Azure App Service. Contoh: -disableLink:AppPoolExtension-disableLink:ContentExtension.

Lihat contoh lainnya dari Pengaturan Operasi Penyebaran Web.


RenameFilesFlag - Mengganti nama file yang dikunci
boolean. Pilihan. Gunakan saat UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Nilai default: false.

Gunakan opsi ini untuk mengaktifkan bendera MSDEPLOY_RENAME_LOCKED_FILES=1 msdeploy di pengaturan aplikasi Azure App Service. Opsi ini memungkinkan msdeploy untuk mengganti nama file terkunci yang dikunci selama penyebaran aplikasi.


enableXmlTransform - Transformasi XML
Alias input: XmlTransformation. boolean. Pilihan. Gunakan saat WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Nilai default: false.

Transformasi konfigurasi akan dijalankan untuk *.Release.config dan *.<EnvironmentName>.config pada *.config file.

Transformasi konfigurasi akan dijalankan sebelum Substitusi Variabel.

Transformasi XML hanya didukung untuk platform Windows.


enableXmlVariableSubstitution - Substitusi variabel XML
Alias input: XmlVariableSubstitution. boolean. Pilihan. Gunakan saat WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Nilai default: false.

Variabel yang ditentukan dalam alur build atau rilis akan dicocokkan dengan key atau name entri di appSettingsbagian , applicationSettings, dan connectionStrings dari file konfigurasi apa pun dan parameters.xml. Substitusi Variabel dijalankan setelah konfigurasi berubah.

Catatan: Jika variabel yang sama ditentukan dalam alur rilis dan di lingkungan, variabel lingkungan akan menggantikan variabel alur rilis.


JSONFiles - Substitusi variabel JSON
string. Pilihan. Gunakan saat WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war.

Menyediakan daftar file JSON yang dipisahkan baris baru untuk menggantikan nilai variabel. Nama file harus disediakan relatif terhadap folder akar.

Untuk mengganti variabel JSON yang berlapis atau hierarkis, tentukan menggunakan JSONPath ekspresi.

Misalnya, untuk mengganti nilai ConnectionString dalam sampel di bawah ini, Anda perlu menentukan variabel seperti Data.DefaultConnection.ConnectionString dalam alur build/rilis (atau lingkungan alur rilis).

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

Penggantian Variabel dijalankan setelah transformasi konfigurasi.

Catatan: variabel alur dikecualikan dalam substitusi.


Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugas mereka. Untuk informasi selengkapnya, lihat Opsi kontrol dan properti tugas umum.

Variabel output

Tidak ada.

Keterangan

Ada versi yang lebih baru dari tugas ini yang tersedia. Untuk informasi selengkapnya, lihat AzureRmWebAppDeployment@4.

Pemecahan Masalah

Saya tidak dapat Menyebarkan Web ke Azure App Service saya menggunakan autentikasi Microsoft Entra ID dari agen Windows saya

Tugas penyebaran Azure App Service mendukung menyambungkan ke Microsoft Azure dengan koneksi layanan ARM menggunakan Microsoft Entra ID, kecuali ada tiga kondisi berikut:

  • Anda menggunakan format paket Web Deploy pada agen Windows
  • Agen Anda berjalan dengan versi msdeploy.exe yang lebih lama (misalnya saat menggunakan gambar agen yang dihosting windows-2019 )
  • Autentikasi dasar dinonaktifkan untuk Azure App Service Anda

Jika ketiga kondisi ini ada, Anda akan menerima kesalahan seperti 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.

Untuk mengatasi masalah ini, Anda dapat memilih dari opsi berikut, dalam urutan preferensi.

  1. Perbarui gambar agen. Jika Anda menggunakan agen yang dihosting, pindahkan dari windows-2019 ke windows-2022 (atau windows-latest). Jika Anda menggunakan agen yang dihost sendiri, instal Visual Studio 2022 di agen untuk mendapatkan versi msdeploy.exeyang lebih baru.
  2. Jika Anda bergantung pada gambar agen yang lebih lama dan tidak dapat memperbarui agen untuk alur Anda, pertimbangkan untuk membagi pekerjaan sehingga Azure App Service menyebarkan tugas berjalan pada windows-2022 (atau windows-terbaru).
  3. Jika opsi ini tidak memungkinkan, Anda dapat mengaktifkan autentikasi dasar untuk Azure App Service Anda.

Persyaratan

Persyaratan Deskripsi
Jenis alur YAML, Build klasik, Rilis klasik
Berjalan pada Agen, DeploymentGroup
Permintaan Tidak ada
Kemampuan Tugas ini tidak memenuhi tuntutan untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah Apa pun
Variabel yang dapat diatur Apa pun
Versi agen 2.104.1 atau lebih tinggi
Kategori tugas Sebarkan