IISWebAppDeployment@1 – Tarefa V1 de implantação de aplicativo Web do IIS (preterido)
Use essa tarefa para implantar o Aplicativo Web do IIS usando o MSDeploy e, em seguida, criar ou atualizar sites e pools de aplicativos.
Importante
Essa tarefa foi preterida e será desativada em 31 de janeiro de 2024. Use a implantação de aplicativo Web do IIS usando o WinRM – Viual Studio Marketplace.
Use essa tarefa para implantar o Aplicativo Web do IIS usando o MSDeploy e, em seguida, criar ou atualizar sites e pools de aplicativos.
Importante
Essa tarefa foi preterida. Use a implantação de aplicativo Web do IIS usando o WinRM – Viual Studio Marketplace.
Syntax
# 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.
Entradas
EnvironmentName
-
Máquinas
string
. Obrigatórios.
Especifica uma lista separada por vírgulas de endereços IP do computador ou FQDNs, juntamente com portas. A porta padrão é baseada no protocolo selecionado, por exemplo dbserver.fabrikam.com
, ou dbserver_int.fabrikam.com:5986,192.168.12.34:5986
. Você também pode fornecer a variável de saída de outras tarefas, por exemplo $(variableName)
.
AdminUserName
-
Logon de administrador
string
.
Especifica o logon do administrador para os computadores de destino.
AdminPassword
-
Senha
string
.
Especifica a senha de administrador para os computadores de destino. Ele pode aceitar variáveis definidas em definições de build/versão, como $(passwordVariable)
. Você pode marcar o tipo de variável como secret
para protegê-lo.
WinRMProtocol
-
Protocolo
string
. Valores Permitidos: Http
e Https
.
Especifica o protocolo usado para a conexão WinRM com os computadores. O padrão é HTTPS
.
TestCertificate
-
Testar certificado
boolean
. Opcional. Use quando WinRMProtocol = Https
. Valor padrão: true
.
Seleciona a opção de ignorar a validação da autenticidade do certificado do computador por uma autoridade de certificação confiável. O parâmetro é necessário para o protocolo WinRM HTTPS
.
WebDeployPackage
-
Pacote de Implantação da Web
string
. Obrigatórios.
Especifica o local do arquivo zip de Implantação da Web (MSDeploy) nos computadores de destino ou em um caminho UNC como . \\BudgetIT\WebDeploy\WebDeployPackage.zip
O caminho UNC deve estar acessível para a conta de administrador do computador. Também há suporte para variáveis de ambiente, como $env:windir
, $env:systemroot
e $env:windir\FabrikamFibre\Web
.
WebDeployParamFile
-
Arquivo de parâmetro de implantação da Web
string
.
Especifica o local do arquivo de parâmetro nos computadores de destino ou em um caminho UNC. O arquivo de parâmetro é usado para substituir as configurações do aplicativo Web, como o nome do aplicativo Web do IIS ou o banco de dados cadeia de conexão.
OverRideParams
-
Substituir parâmetros
string
.
Os parâmetros especificados aqui substituirão os parâmetros no arquivo zip MSDeploy e no arquivo de parâmetro. Para substituir mais de um parâmetro, use um separador de linha.
Por exemplo, "IIS Web Application Name"="Fabrikam"
ou "ConnectionString"="Server=localhost;Database=Fabrikam;"
.
CreateWebSite
-
Criar ou atualizar site
boolean
. Valor padrão: false
.
Especifica a opção de criar um site ou atualizar um site existente.
WebSiteName
-
Nome do Site
string
. Obrigatório quando CreateWebSite = true
.
Especifica o nome do site do IIS que será criado se ele não existir ou será atualizado se ele já estiver presente no servidor IIS. O nome do site deve ser o mesmo especificado no arquivo de pacote zip de implantação da Web. Se uma configuração de parâmetros de arquivo de parâmetro e substituição também for especificada, o nome do site deverá ser o mesmo que na configuração de parâmetros de substituição.
WebSitePhysicalPath
-
Caminho físico
string
. Obrigatório quando CreateWebSite = true
. Valor padrão: %SystemDrive%\inetpub\wwwroot
.
Especifica o caminho físico em que o conteúdo do site é armazenado. O conteúdo pode residir no computador local ou em um diretório remoto ou compartilhar, como C:\Fabrikam
ou \\ContentShare\Fabrikam
.
WebSitePhysicalPathAuth
-
Autenticação de caminho físico
string
. Obrigatório quando CreateWebSite = true
. Valores permitidos: WebSiteUserPassThrough
(Usuário do Aplicativo (Passagem)), WebSiteWindowsAuth
(Autenticação do Windows). Valor padrão: Application User (Pass-through)
.
Especifica o mecanismo de autenticação para acessar o caminho físico do site.
WebSiteAuthUserName
-
Nome de Usuário
string
. Obrigatório quando WebSitePhysicalPathAuth = WebSiteWindowsAuth
.
Especifica o nome de usuário para acessar o caminho físico do site.
WebSiteAuthUserPassword
-
Senha
string
. Opcional. Use quando WebSitePhysicalPathAuth = WebSiteWindowsAuth
.
Especifica a senha para acessar o caminho físico do site. Se você estiver usando um gMSA, isso não será necessário.
AddBinding
-
Adicionar Associação
boolean
. Opcional. Use quando CreateWebSite = true
. Valor padrão: true
.
Especifica a opção de adicionar associação de porta para o site.
AssignDuplicateBinding
-
Atribuir associação duplicada
boolean
. Opcional. Use quando AddBinding = true
. Valor padrão: false
.
Especifica a opção de adicionar as associações especificadas aqui (mesmo que haja outro site com as mesmas associações). Se houver conflitos de associação, apenas um dos sites será iniciado.
Protocol
-
Protocolo
string
. Obrigatório quando AddBinding = true
. Valores Permitidos: https
e http
. Valor padrão: http
.
Especifica HTTP para o site ter uma associação HTTP ou HTTPS para que o site tenha uma associação SSL (Secure Sockets Layer).
IPAddress
-
Endereço IP
string
. Obrigatório quando AddBinding = true
. Valor padrão: All Unassigned
.
Especifica um endereço IP que os usuários podem usar para acessar o site. Se All Unassigned estiver selecionado, o site responderá às solicitações de todos os endereços IP na porta e ao nome do host opcional especificado para o site. O site não responderá às solicitações se outro site no servidor tiver uma associação na mesma porta, mas com um endereço IP específico.
Port
-
Porta
string
. Obrigatório quando AddBinding = true
. Valor padrão: 80
.
Especifica a porta na qual a Pilha de Protocolo de Transferência de Hipertexto (HTTP.sys) deve monitorar as solicitações feitas a este site.
ServerNameIndication
-
Indicação de nome do servidor necessária
boolean
. Opcional. Use quando Protocol = https
. Valor padrão: false
.
Determina se o site requer a Indicação de Nome de Servidor (SNI). O SNI estende os protocolos SSL e TLS para indicar a qual nome de host o cliente está tentando se conectar. Ele permite que vários sites seguros com certificados diferentes usem o mesmo endereço IP.
HostNameWithOutSNI
-
Nome do host
string
. Opcional. Use quando ServerNameIndication = false
.
Atribui um ou mais nomes de host (ou nomes de domínio) a um computador que usa um único endereço IP. Se um nome de host for especificado, os clientes deverão usar o nome do host em vez do endereço IP para acessar o site.
HostNameWithHttp
-
Nome do host
string
. Opcional. Use quando Protocol = http
.
Atribui um ou mais nomes de host (ou nomes de domínio) a um computador que usa um único endereço IP. Se um nome de host for especificado, os clientes deverão usar o nome do host em vez do endereço IP para acessar o site.
HostNameWithSNI
-
Nome do host
string
. Obrigatório quando ServerNameIndication = true
.
Atribui um ou mais nomes de host (ou nomes de domínio) a um computador que usa um único endereço IP. Se um nome de host for especificado, os clientes deverão usar o nome do host em vez do endereço IP para acessar o site.
SSLCertThumbPrint
-
Impressão digital do certificado SSL
string
. Obrigatório quando Protocol = https
.
Especifica a impressão digital do certificado camada de soquete seguro que o site usará. O certificado já deve estar instalado no computador e estar presente no repositório Pessoal do Computador Local.
CreateAppPool
-
Criar ou atualizar o pool de aplicativos
boolean
. Valor padrão: false
.
Especifica a opção de criar um pool de aplicativos ou atualizar um pool de aplicativos existente.
AppPoolName
-
Nome
string
. Obrigatório quando CreateAppPool = true
.
Especifica o nome do pool de aplicativos do IIS a ser criado ou atualizado. O pool de aplicativos existente será atualizado com as configurações especificadas.
DotNetVersion
-
Versão do .NET
string
. Obrigatório quando CreateAppPool = true
. Valores permitidos: v4.0
, v2.0
, No Managed Code
. Valor padrão: v4.0
.
Especifica a versão do .NET Framework carregada por esse pool de aplicativos. Se os aplicativos atribuídos a esse pool de aplicativos não contiverem código gerenciado, selecione a opção Sem Código Gerenciado na lista.
PipeLineMode
-
Modo de Pipeline Gerenciado
string
. Obrigatório quando CreateAppPool = true
. Valores Permitidos: Integrated
e Classic
. Valor padrão: Integrated
.
O modo de pipeline gerenciado especifica como o IIS processa solicitações de conteúdo gerenciado. Use o modo clássico somente quando os aplicativos no pool de aplicativos não puderem ser executados no modo integrado.
AppPoolIdentity
-
Identidade
string
. Obrigatório quando CreateAppPool = true
. Valores permitidos: ApplicationPoolIdentity
, LocalService
, , NetworkService
LocalSystem
, SpecificUser
(Conta Personalizada). Valor padrão: ApplicationPoolIdentity
.
Configura a conta na qual o processo de trabalho de um pool de aplicativos é executado. Especifique uma das contas de segurança predefinidas ou configure uma conta personalizada.
AppPoolUsername
-
Username
string
. Obrigatório quando AppPoolIdentity = SpecificUser
.
AppPoolPassword
-
Senha
string
. Opcional. Use quando AppPoolIdentity = SpecificUser
.
Se você estiver usando um gMSA, isso não será necessário.
AppCmdCommands
-
Comandos de AppCmd.exe adicionais
string
.
Especifica comandos adicionais AppCmd.exe
para definir as propriedades do site ou do pool de aplicativos. Para mais de um comando, use um separador de linha.
Por exemplo:
<listar pools de aplicativos>
<list sites>
DeployInParallel
-
Implantar em Paralelo
boolean
. Valor padrão: true
.
Se definido como true
, o aplicativo Web será implantado em paralelo nos computadores de destino.
ResourceFilteringMethod
-
Selecionar computadores por
string
. Valores permitidos: machineNames
(Nomes de Máquina), tags
. Valor padrão: machineNames
.
Opcional. Especifica um subconjunto de computadores fornecendo nomes ou marcas de computador.
MachineFilter
-
Implantar em computadores
string
.
Essa entrada só é válida para grupos de computadores e ainda não tem suporte para uma lista simples de computadores ou variáveis de saída.
Especifica uma lista de computadores, como dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34
ou marcas, como Role:DB; OS:Win8.1
. Se várias marcas forem fornecidas, a tarefa será executada em todos os computadores com as marcas especificadas. Para Grupos de Recursos do Azure, especifique o nome da máquina virtual, como ffweb, ffdb
. O padrão executa a tarefa em todos os computadores.
Opções de controle da tarefa
Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.
Variáveis de saída
Nenhum.
Comentários
Importante
Essa tarefa foi preterida. Use a implantação de aplicativo Web do IIS usando o WinRM – Viual Studio Marketplace.
Requisitos
Requisito | Descrição |
---|---|
Tipos de pipeline | YAML, build clássico, versão clássica |
É executado em | Agent, DeploymentGroup |
Demandas | Nenhum |
Funcionalidades | Essa tarefa não atende a nenhuma demanda por tarefas subsequentes no trabalho. |
Restrições de comando | Qualquer |
Variáveis configuráveis | Qualquer |
Versão do agente | 1.91.0 ou superior |
Categoria da tarefa | Implantar |