Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Use essa tarefa para implantar um site ou aplicativo Web usando a Implantação da Web.
Importante
Essa tarefa só funciona com pipelines clássicos. Use a implantação de aplicativo Web do IIS usando o WinRM – Visual Studio Marketplace .
Sintaxe
# IIS web app deploy v0
# Deploy a website or web application using Web Deploy.
- task: IISWebAppDeploymentOnMachineGroup@0
inputs:
WebSiteName: # string. Required. Website Name.
#VirtualApplication: # string. Virtual Application.
Package: '$(System.DefaultWorkingDirectory)\**\*.zip' # string. Required. Package or Folder. Default: $(System.DefaultWorkingDirectory)\**\*.zip.
# Advanced Deployment Options
#SetParametersFile: # string. SetParameters File.
#RemoveAdditionalFilesFlag: false # boolean. Remove Additional Files at Destination. Default: false.
#ExcludeFilesFromAppDataFlag: false # boolean. Exclude Files from the App_Data Folder. Default: false.
#TakeAppOfflineFlag: false # boolean. Take App Offline. Default: false.
#AdditionalArguments: # string. Additional Arguments.
# File Transforms & Variable Substitution Options
#XmlTransformation: false # boolean. XML transformation. Default: false.
#XmlVariableSubstitution: false # boolean. XML variable substitution. Default: false.
#JSONFiles: # string. JSON variable substitution.
Entradas
WebSiteName
-
Nome do site
string. Obrigatório
Especifica o nome de um site existente nos computadores do grupo de computadores.
VirtualApplication
-
Aplicativo Virtual
string.
Especifica o nome de um aplicativo virtual do Azure existente nas máquinas de destino.
Package
-
Pacote ou pasta
string. Obrigatório Valor padrão: $(System.DefaultWorkingDirectory)\**\*.zip.
Especifica o caminho do arquivo para o pacote ou pasta gerado pelo MSBuild ou para um arquivo de arquivo compactado. Há suporte para variáveis ( | versão de build) e curingas.
SetParametersFile
-
de arquivo SetParameters
string.
Especifica o caminho para o SetParameters.xml arquivo a ser usado.
RemoveAdditionalFilesFlag
-
Remover arquivos adicionais no destino
boolean. Valor padrão: false.
Se definido como true, exclui arquivos no Aplicativo Web que não têm arquivos correspondentes no pacote ZIP do aplicativo Web.
ExcludeFilesFromAppDataFlag
-
Excluir arquivos da pasta App_Data
boolean. Valor padrão: false.
Se definido como true, isso impede que arquivos na App_Data pasta sejam implantados no Aplicativo Web.
TakeAppOfflineFlag
-
Ficar offline do aplicativo
boolean. Valor padrão: false.
Seleciona a opção de colocar o Aplicativo Web offline colocando um app_offline.htm arquivo em seu diretório raiz antes do início da operação de sincronização. O arquivo é removido automaticamente depois que a operação de sincronização é concluída com êxito.
AdditionalArguments
-
Argumentos adicionais
string.
Especifica argumentos adicionais de Implantação da Web a serem usados ao implantar o Aplicativo Web do Azure. Por exemplo, -disableLink:AppPoolExtension ou -disableLink:ContentExtension.
Para obter uma lista completa de argumentos com suporte, consulte Configurações de Operação de Implantação da Web.
XmlTransformation
-
de transformação XML
boolean. Valor padrão: false.
Executa transformações XML e *.Release.config*.<EnvironmentName>.config arquivos no correspondente *.config file. Essas transformações são aplicadas antes da substituição de variável. As transformações XML têm suporte apenas no Windows.
XmlVariableSubstitution
-
de substituição de variável XML
boolean. Valor padrão: false.
Especifica as variáveis definidas no pipeline de build ou lançamento. Essas variáveis são correspondidas com as key entradas ou name entradas no appSettingsarquivo applicationSettingsde configuração e connectionStrings seções de qualquer arquivo de configuração e parameters.xml. A substituição de variável é executada após transformações de configuração.
Observação
Se as mesmas variáveis forem definidas no pipeline de lançamento e no ambiente, as variáveis de ambiente terão precedência sobre as variáveis de pipeline de versão.
JSONFiles
-
de substituição de variável JSON
string.
Especifica uma lista separada por nova linha de arquivos JSON para substituição de variável. Os nomes de arquivo devem ser relativos à pasta raiz.
Para substituir variáveis JSON aninhadas ou hierárquicas, use expressões JSONPath. Por exemplo, para substituir o valor do ConnectionString exemplo abaixo, defina uma variável como Data.DefaultConnection.ConnectionString no pipeline de build ou versão (ou no estágio do pipeline de lançamento).
{
"Data": {
"DefaultConnection": {
"ConnectionString": "Server=(localdb)\SQLEXPRESS;Database=MyDB;Trusted_Connection=True"
}
}
}
A substituição de variável é executada após as transformações de configuração e as variáveis de pipeline são excluídas da substituição.
Opções de controle de tarefa
Todas as tarefas têm opções de controle além das suas entradas de tarefas. Para obter mais informações, consulte as opções de controle e as propriedades comuns da tarefa.
Variáveis de saída
Nenhum.
Observações
Use essa tarefa para implantar um site ou aplicativo Web usando WebDeploy.
Exemplos
Requisitos
| Requisito | Descrição |
|---|---|
| Tipos de pipeline | Versão clássica |
| Execuções em | Agent, DeploymentGroup |
| Demandas | Nenhum |
| Capacidades | Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho. |
| restrições de comando | Qualquer |
| Variáveis configuráveis | Qualquer |
| Versão do agente | 2.104.1 ou superior |
| Categoria de tarefa | Implantar |