IISWebAppDeployment@1 - Tugas penyebaran Aplikasi Web IIS (Tidak Digunakan Lagi) v1
Gunakan tugas ini untuk menyebarkan IIS Web App menggunakan MSDeploy, lalu buat atau perbarui situs web dan kumpulan aplikasi.
Penting
Tugas ini tidak digunakan lagi dan akan dihentikan 31 Januari 2024. Gunakan penyebaran aplikasi web IIS menggunakan WinRM - Viual Studio Marketplace.
Gunakan tugas ini untuk menyebarkan IIS Web App menggunakan MSDeploy, lalu buat atau perbarui situs web dan kumpulan aplikasi.
Penting
Tugas ini tidak digunakan lagi. Gunakan penyebaran aplikasi web IIS menggunakan WinRM - Viual Studio Marketplace.
Sintaks
# IIS Web App deployment (Deprecated) v1
# Deploy using MSDeploy, then create/update websites and app pools.
- task: IISWebAppDeployment@1
inputs:
EnvironmentName: # string. Required. Machines.
#AdminUserName: # string. Admin Login.
#AdminPassword: # string. Password.
#WinRMProtocol: # 'Http' | 'Https'. Protocol.
#TestCertificate: true # boolean. Optional. Use when WinRMProtocol = Https. Test Certificate. Default: true.
# Deployment
WebDeployPackage: # string. Required. Web Deploy Package.
#WebDeployParamFile: # string. Web Deploy Parameter File.
#OverRideParams: # string. Override Parameters.
# Website
#CreateWebSite: false # boolean. Create or Update Website. Default: false.
#WebSiteName: # string. Required when CreateWebSite = true. Website Name.
#WebSitePhysicalPath: '%SystemDrive%\inetpub\wwwroot' # string. Required when CreateWebSite = true. Physical Path. Default: %SystemDrive%\inetpub\wwwroot.
#WebSitePhysicalPathAuth: 'Application User (Pass-through)' # 'WebSiteUserPassThrough' | 'WebSiteWindowsAuth'. Required when CreateWebSite = true. Physical Path Authentication. Default: Application User (Pass-through).
#WebSiteAuthUserName: # string. Required when WebSitePhysicalPathAuth = WebSiteWindowsAuth. User Name.
#WebSiteAuthUserPassword: # string. Optional. Use when WebSitePhysicalPathAuth = WebSiteWindowsAuth. Password.
#AddBinding: true # boolean. Optional. Use when CreateWebSite = true. Add Binding. Default: true.
#AssignDuplicateBinding: false # boolean. Optional. Use when AddBinding = true. Assign Duplicate Binding. Default: false.
Protocol: 'http' # 'https' | 'http'. Required when AddBinding = true. Protocol. Default: http.
IPAddress: 'All Unassigned' # string. Required when AddBinding = true. IP Address. Default: All Unassigned.
Port: '80' # string. Required when AddBinding = true. Port. Default: 80.
#ServerNameIndication: false # boolean. Optional. Use when Protocol = https. Server Name Indication Required. Default: false.
#HostNameWithOutSNI: # string. Optional. Use when ServerNameIndication = false. Host Name.
#HostNameWithHttp: # string. Optional. Use when Protocol = http. Host Name.
#HostNameWithSNI: # string. Required when ServerNameIndication = true. Host Name.
#SSLCertThumbPrint: # string. Required when Protocol = https. SSL Certificate Thumb Print.
# Application Pool
#CreateAppPool: false # boolean. Create or Update Application Pool. Default: false.
#AppPoolName: # string. Required when CreateAppPool = true. Name.
#DotNetVersion: 'v4.0' # 'v4.0' | 'v2.0' | 'No Managed Code'. Required when CreateAppPool = true. .NET Version. Default: v4.0.
#PipeLineMode: 'Integrated' # 'Integrated' | 'Classic'. Required when CreateAppPool = true. Managed Pipeline Mode. Default: Integrated.
#AppPoolIdentity: 'ApplicationPoolIdentity' # 'ApplicationPoolIdentity' | 'LocalService' | 'LocalSystem' | 'NetworkService' | 'SpecificUser'. Required when CreateAppPool = true. Identity. Default: ApplicationPoolIdentity.
#AppPoolUsername: # string. Required when AppPoolIdentity = SpecificUser. Username.
#AppPoolPassword: # string. Optional. Use when AppPoolIdentity = SpecificUser. Password.
# Advanced
#AppCmdCommands: # string. Additional AppCmd.exe Commands.
#DeployInParallel: true # boolean. Deploy in Parallel. Default: true.
#ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
#MachineFilter: # string. Deploy to Machines.
# IIS Web App deployment (Deprecated) v1
# Deploy by MSDeploy, create/update website & app pools.
- task: IISWebAppDeployment@1
inputs:
EnvironmentName: # string. Required. Machines.
#AdminUserName: # string. Admin Login.
#AdminPassword: # string. Password.
#WinRMProtocol: # 'Http' | 'Https'. Protocol.
#TestCertificate: true # boolean. Optional. Use when WinRMProtocol = Https. Test Certificate. Default: true.
# Deployment
WebDeployPackage: # string. Required. Web Deploy Package.
#WebDeployParamFile: # string. Web Deploy Parameter File.
#OverRideParams: # string. Override Parameters.
# Website
#CreateWebSite: false # boolean. Create or Update Website. Default: false.
#WebSiteName: # string. Required when CreateWebSite = true. Website Name.
#WebSitePhysicalPath: '%SystemDrive%\inetpub\wwwroot' # string. Required when CreateWebSite = true. Physical Path. Default: %SystemDrive%\inetpub\wwwroot.
#WebSitePhysicalPathAuth: 'Application User (Pass-through)' # 'WebSiteUserPassThrough' | 'WebSiteWindowsAuth'. Required when CreateWebSite = true. Physical Path Authentication. Default: Application User (Pass-through).
#WebSiteAuthUserName: # string. Required when WebSitePhysicalPathAuth = WebSiteWindowsAuth. User Name.
#WebSiteAuthUserPassword: # string. Optional. Use when WebSitePhysicalPathAuth = WebSiteWindowsAuth. Password.
#AddBinding: true # boolean. Optional. Use when CreateWebSite = true. Add Binding. Default: true.
#AssignDuplicateBinding: false # boolean. Optional. Use when AddBinding = true. Assign Duplicate Binding. Default: false.
Protocol: 'http' # 'https' | 'http'. Required when AddBinding = true. Protocol. Default: http.
IPAddress: 'All Unassigned' # string. Required when AddBinding = true. IP Address. Default: All Unassigned.
Port: '80' # string. Required when AddBinding = true. Port. Default: 80.
#ServerNameIndication: false # boolean. Optional. Use when Protocol = https. Server Name Indication Required. Default: false.
#HostNameWithOutSNI: # string. Optional. Use when ServerNameIndication = false. Host Name.
#HostNameWithHttp: # string. Optional. Use when Protocol = http. Host Name.
#HostNameWithSNI: # string. Required when ServerNameIndication = true. Host Name.
#SSLCertThumbPrint: # string. Required when Protocol = https. SSL Certificate Thumb Print.
# Application Pool
#CreateAppPool: false # boolean. Create or Update Application Pool. Default: false.
#AppPoolName: # string. Required when CreateAppPool = true. Name.
#DotNetVersion: 'v4.0' # 'v4.0' | 'v2.0' | 'No Managed Code'. Required when CreateAppPool = true. .NET Version. Default: v4.0.
#PipeLineMode: 'Integrated' # 'Integrated' | 'Classic'. Required when CreateAppPool = true. Managed Pipeline Mode. Default: Integrated.
#AppPoolIdentity: 'ApplicationPoolIdentity' # 'ApplicationPoolIdentity' | 'LocalService' | 'LocalSystem' | 'NetworkService' | 'SpecificUser'. Required when CreateAppPool = true. Identity. Default: ApplicationPoolIdentity.
#AppPoolUsername: # string. Required when AppPoolIdentity = SpecificUser. Username.
#AppPoolPassword: # string. Optional. Use when AppPoolIdentity = SpecificUser. Password.
# Advanced
#AppCmdCommands: # string. Additional AppCmd.exe Commands.
#DeployInParallel: true # boolean. Deploy in Parallel. Default: true.
#ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
#MachineFilter: # string. Deploy to Machines.
Input
EnvironmentName
-
Mesin
string
. Wajib diisi.
Menentukan daftar alamat IP komputer atau FQDN yang dipisahkan koma, bersama dengan port. Port default didasarkan pada protokol yang dipilih, misalnya dbserver.fabrikam.com
atau dbserver_int.fabrikam.com:5986,192.168.12.34:5986
. Anda juga dapat memberikan variabel output tugas lain, misalnya $(variableName)
.
AdminUserName
-
Admin Masuk
string
.
Menentukan login administrator untuk komputer target.
AdminPassword
-
Password
string
.
Menentukan kata sandi administrator untuk komputer target. Ini dapat menerima variabel yang ditentukan dalam definisi build/rilis, seperti $(passwordVariable)
. Anda dapat menandai jenis variabel sebagai secret
untuk mengamankannya.
WinRMProtocol
-
Protokol
string
. Nilai yang diizinkan: Http
, Https
.
Menentukan protokol yang digunakan untuk koneksi WinRM dengan komputer. Default adalah HTTPS
.
TestCertificate
-
Uji Sertifikat
boolean
. Pilihan. Gunakan saat WinRMProtocol = Https
. Nilai default: true
.
Memilih opsi untuk melewati validasi keaslian sertifikat mesin oleh otoritas sertifikasi tepercaya. Parameter diperlukan untuk protokol WinRM HTTPS
.
WebDeployPackage
-
Paket Penyebaran Web
string
. Wajib diisi.
Menentukan lokasi file zip Web Deploy (MSDeploy) pada komputer target atau pada jalur UNC seperti, \\BudgetIT\WebDeploy\WebDeployPackage.zip
. Jalur UNC harus dapat diakses oleh akun administrator komputer. Variabel lingkungan juga didukung, seperti $env:windir
, , $env:systemroot
dan $env:windir\FabrikamFibre\Web
.
WebDeployParamFile
-
File Parameter Penyebaran Web
string
.
Menentukan lokasi file parameter pada komputer target atau pada jalur UNC. File parameter digunakan untuk mengambil alih pengaturan konfigurasi aplikasi Web, seperti nama aplikasi Web IIS atau string koneksi database.
OverRideParams
-
Mengesampingkan Parameter
string
.
Parameter yang ditentukan di sini akan mengambil alih parameter dalam file zip MSDeploy dan file parameter. Untuk mengambil alih lebih dari satu parameter, gunakan pemisah baris.
Misalnya, "IIS Web Application Name"="Fabrikam"
atau "ConnectionString"="Server=localhost;Database=Fabrikam;"
.
CreateWebSite
-
Membuat atau Memperbarui Situs Web
boolean
. Nilai default: false
.
Menentukan opsi untuk membuat situs web atau memperbarui situs web yang sudah ada.
WebSiteName
-
Nama Situs Web
string
. Diperlukan saat CreateWebSite = true
.
Menentukan nama situs web IIS yang akan dibuat jika tidak ada, atau akan diperbarui jika sudah ada di server IIS. Nama situs web harus sama dengan yang ditentukan dalam file paket zip penyebaran web. Jika pengaturan parameter file parameter dan ambil alih parameter juga ditentukan, maka nama situs web harus sama dengan yang ada di pengaturan parameter penimpaan.
WebSitePhysicalPath
-
Jalur Fisik
string
. Diperlukan saat CreateWebSite = true
. Nilai default: %SystemDrive%\inetpub\wwwroot
.
Menentukan jalur fisik tempat konten situs web disimpan. Konten dapat berada di komputer lokal atau di direktori jarak jauh atau berbagi, seperti C:\Fabrikam
atau \\ContentShare\Fabrikam
.
WebSitePhysicalPathAuth
-
Autentikasi Jalur Fisik
string
. Diperlukan saat CreateWebSite = true
. Nilai yang diizinkan: WebSiteUserPassThrough
(Pengguna Aplikasi (Pass-through)), WebSiteWindowsAuth
(Autentikasi Windows). Nilai default: Application User (Pass-through)
.
Menentukan mekanisme autentikasi untuk mengakses jalur fisik situs web.
WebSiteAuthUserName
-
Nama Pengguna
string
. Diperlukan saat WebSitePhysicalPathAuth = WebSiteWindowsAuth
.
Menentukan nama pengguna untuk mengakses jalur fisik situs web.
WebSiteAuthUserPassword
-
Password
string
. Pilihan. Gunakan saat WebSitePhysicalPathAuth = WebSiteWindowsAuth
.
Menentukan kata sandi untuk mengakses jalur fisik situs web. Jika Anda menggunakan gMSA, ini tidak diperlukan.
AddBinding
-
Tambahkan Pengikatan
boolean
. Pilihan. Gunakan saat CreateWebSite = true
. Nilai default: true
.
Menentukan opsi untuk menambahkan pengikatan port untuk situs web.
AssignDuplicateBinding
-
Menetapkan Pengikatan Duplikat
boolean
. Pilihan. Gunakan saat AddBinding = true
. Nilai default: false
.
Menentukan opsi untuk menambahkan pengikatan yang ditentukan di sini (bahkan jika ada situs web lain dengan pengikatan yang sama). Jika ada konflik pengikatan, hanya salah satu situs web yang akan dimulai.
Protocol
-
Protokol
string
. Diperlukan saat AddBinding = true
. Nilai yang diizinkan: https
, http
. Nilai default: http
.
Menentukan HTTP agar situs web memiliki pengikatan HTTP atau HTTPS agar situs web memiliki pengikatan Secure Sockets Layer (SSL).
IPAddress
-
Alamat IP
string
. Diperlukan saat AddBinding = true
. Nilai default: All Unassigned
.
Menentukan alamat IP yang dapat digunakan pengguna untuk mengakses situs web. Jika Semua Tidak Ditetapkan dipilih, situs akan merespons permintaan untuk semua alamat IP pada port dan nama host opsional yang ditentukan untuk situs. Situs tidak akan merespons permintaan jika situs lain di server memiliki pengikatan pada port yang sama tetapi dengan alamat IP tertentu.
Port
-
Port
string
. Diperlukan saat AddBinding = true
. Nilai default: 80
.
Menentukan port tempat Hypertext Transfer Protocol Stack (HTTP.sys) harus memantau permintaan yang dibuat ke situs web ini.
ServerNameIndication
-
Indikasi Nama Server Diperlukan
boolean
. Pilihan. Gunakan saat Protocol = https
. Nilai default: false
.
Menentukan apakah situs web memerlukan Indikasi Nama Server (SNI). SNI memperluas protokol SSL dan TLS untuk menunjukkan nama host apa yang coba disambungkan oleh klien. Ini memungkinkan beberapa situs web aman dengan sertifikat yang berbeda untuk menggunakan alamat IP yang sama.
HostNameWithOutSNI
-
Nama Host
string
. Opsional. Gunakan saat ServerNameIndication = false
.
Menetapkan satu atau beberapa nama host (atau nama domain) ke komputer yang menggunakan satu alamat IP. Jika nama host ditentukan, maka klien harus menggunakan nama host alih-alih alamat IP untuk mengakses situs web.
HostNameWithHttp
-
Nama Host
string
. Pilihan. Gunakan saat Protocol = http
.
Menetapkan satu atau beberapa nama host (atau nama domain) ke komputer yang menggunakan satu alamat IP. Jika nama host ditentukan, maka klien harus menggunakan nama host alih-alih alamat IP untuk mengakses situs web.
HostNameWithSNI
-
Nama Host
string
. Diperlukan saat ServerNameIndication = true
.
Menetapkan satu atau beberapa nama host (atau nama domain) ke komputer yang menggunakan satu alamat IP. Jika nama host ditentukan, maka klien harus menggunakan nama host alih-alih alamat IP untuk mengakses situs web.
SSLCertThumbPrint
-
Cetak Jempol Sertifikat SSL
string
. Diperlukan saat Protocol = https
.
Menentukan thumb-print sertifikat Secure Socket Layer yang akan digunakan situs web. Sertifikat harus sudah diinstal pada komputer dan ada di bawah penyimpanan Pribadi Komputer Lokal.
CreateAppPool
-
Membuat atau Memperbarui Kumpulan Aplikasi
boolean
. Nilai default: false
.
Menentukan opsi untuk membuat kumpulan aplikasi atau memperbarui kumpulan aplikasi yang ada.
AppPoolName
-
Nama
string
. Diperlukan saat CreateAppPool = true
.
Menentukan nama kumpulan aplikasi IIS untuk dibuat atau diperbarui. Kumpulan aplikasi yang ada akan diperbarui dengan pengaturan yang ditentukan.
DotNetVersion
-
Versi .NET
string
. Diperlukan saat CreateAppPool = true
. Nilai yang diizinkan: v4.0
, v2.0
, dan No Managed Code
. Nilai default: v4.0
.
Menentukan versi .NET Framework yang dimuat oleh kumpulan aplikasi ini. Jika aplikasi yang ditetapkan ke kumpulan aplikasi ini tidak berisi kode terkelola, pilih opsi Tanpa Kode Terkelola dari daftar.
PipeLineMode
-
Mode Alur Terkelola
string
. Diperlukan saat CreateAppPool = true
. Nilai yang diizinkan: Integrated
, Classic
. Nilai default: Integrated
.
Mode alur terkelola menentukan cara IIS memproses permintaan untuk konten terkelola. Gunakan mode klasik hanya ketika aplikasi di kumpulan aplikasi tidak dapat berjalan dalam mode terintegrasi.
AppPoolIdentity
-
Identitas
string
. Diperlukan saat CreateAppPool = true
. Nilai yang diizinkan: ApplicationPoolIdentity
, , LocalService
LocalSystem
, NetworkService
, SpecificUser
(Akun Kustom). Nilai default: ApplicationPoolIdentity
.
Mengonfigurasi akun tempat proses pekerja kumpulan aplikasi berjalan. Tentukan salah satu akun keamanan yang telah ditentukan sebelumnya, atau konfigurasikan akun kustom.
AppPoolUsername
-
Username
string
. Diperlukan saat AppPoolIdentity = SpecificUser
.
AppPoolPassword
-
Password
string
. Pilihan. Gunakan saat AppPoolIdentity = SpecificUser
.
Jika Anda menggunakan gMSA, ini tidak diperlukan.
AppCmdCommands
-
Perintah AppCmd.exe Tambahan
string
.
Menentukan perintah tambahan AppCmd.exe
untuk mengatur properti kumpulan situs web atau aplikasi. Untuk lebih dari satu perintah, gunakan pemisah baris.
Contohnya:
<daftar kumpulan aplikasi>
<situs daftar>
DeployInParallel
-
Menyebarkan secara Paralel
boolean
. Nilai default: true
.
Jika diatur ke true
, aplikasi Web disebarkan secara paralel pada komputer target.
ResourceFilteringMethod
-
Pilih Mesin Menurut
string
. Nilai yang diizinkan: machineNames
(Nama Mesin), tags
. Nilai default: machineNames
.
Pilihan. Menentukan subset komputer dengan memberikan nama atau tag komputer.
MachineFilter
-
Menyebarkan ke Mesin
string
.
Input ini hanya berlaku untuk grup mesin dan belum didukung untuk daftar datar komputer atau variabel output.
Menentukan daftar komputer, seperti dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34
atau tag, seperti Role:DB; OS:Win8.1
. Jika beberapa tag disediakan, tugas akan berjalan di semua komputer dengan tag yang ditentukan. Untuk Grup Sumber Daya Azure, tentukan nama komputer virtual, seperti ffweb, ffdb
. Default menjalankan tugas di semua komputer.
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
Penting
Tugas ini tidak digunakan lagi. Gunakan penyebaran aplikasi web IIS menggunakan WinRM - Viual Studio Marketplace.
Persyaratan
Persyaratan | Deskripsi |
---|---|
Jenis alur | YAML, Build klasik, Rilis klasik |
Berjalan pada | Agen, DeploymentGroup |
Permintaan | Tidak ada |
Kemampuan | Tugas ini tidak memenuhi tuntutan apa pun untuk tugas berikutnya dalam pekerjaan. |
Pembatasan perintah | Apa pun |
Variabel yang dapat diatur | Apa pun |
Versi agen | 1.91.0 atau lebih tinggi |
Kategori tugas | Sebarkan |