Partilhar via


AzureRmWebAppDeployment@2 - Tarefa Azure App Service Deploy v2

Use esta tarefa para atualizar o Serviço de Aplicativo do Azure usando Web Deploy/Kudu REST APIs.

Sintaxe

# Azure App Service deploy v2
# Update Azure App Service using Web Deploy / Kudu REST APIs.
- task: AzureRmWebAppDeployment@2
  inputs:
    ConnectedServiceName: # string. Required. Azure Subscription. 
    WebAppName: # string. Required. App Service name. 
    #DeployToSlotFlag: false # boolean. Deploy to slot. Default: false.
    #ResourceGroupName: # string. Required when DeployToSlotFlag = true. Resource group. 
    #SlotName: # string. Required when DeployToSlotFlag = true. Slot. 
    #VirtualApplication: # string. Virtual Application. 
    Package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or Folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
  # Output
    #WebAppUri: # string. App Service URL. 
  # Additional Deployment Options
    #UseWebDeploy: true # boolean. Publish using Web Deploy. Default: true.
    #SetParametersFile: # string. Optional. Use when UseWebDeploy == true. SetParameters File. 
    #RemoveAdditionalFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true. Remove Additional Files at Destination. Default: false.
    #ExcludeFilesFromAppDataFlag: false # boolean. Optional. Use when UseWebDeploy == true. Exclude Files from the App_Data Folder. Default: false.
    #AdditionalArguments: # string. Optional. Use when UseWebDeploy == true. Additional Arguments. 
    #TakeAppOfflineFlag: false # boolean. Take App Offline. Default: false.

Insumos

ConnectedServiceName - Subscrição do Azure
string. Obrigatório.

Especifique a assinatura do Azure Resource Manager para a implantação.


WebAppName - nome do Serviço de Aplicativo
string. Obrigatório.

Especifique o nome de um Serviço de Aplicativo do Azure existente.


DeployToSlotFlag - Implantar no slot
boolean. Valor padrão: false.

Use essa opção para implantar em um slot existente diferente do slot de produção.


ResourceGroupName - Grupo de recursos
string. Necessário quando DeployToSlotFlag = true.

Especifique o grupo de Recursos do Azure que contém o Serviço de Aplicativo do Azure especificado acima.


SlotName - Slot
string. Necessário quando DeployToSlotFlag = true.

Especifique um slot existente diferente do slot Produção.


VirtualApplication - de aplicativos virtuais
string.

Especifique o nome do Aplicativo Virtual que foi configurado no portal do Azure. A opção não é necessária para implantações na raiz do Serviço de Aplicativo.


Package - de Pacotes ou Pastas
string. Obrigatório. Valor padrão: $(System.DefaultWorkingDirectory)/**/*.zip.

A pasta ou o caminho do arquivo para o pacote ou pasta do Serviço de Aplicativo. As variáveis incluem Build e Release. curingas são suportados.

Por exemplo, $(System.DefaultWorkingDirectory)/\*\*/\*.zip.


WebAppUri - URL do Serviço de Aplicativo
string.

Especifique um nome para a variável de saída gerada para a URL do Serviço de Aplicativo. A variável pode ser usada em tarefas subsequentes.


UseWebDeploy - Publicar usando o Web Deploy
boolean. Valor padrão: true.

Publish using web deploy opções são suportadas apenas ao usar um agente do Windows. Em outras plataformas, a tarefa depende de APIs REST do Kudu implantar o Serviço de Aplicativo, e as opções a seguir não são suportadas.


SetParametersFile - Arquivo SetParameters
string. Opcional. Use quando UseWebDeploy == true.

Especifique o local do arquivo de SetParameters.xml a ser usado.


RemoveAdditionalFilesFlag - Remover arquivos adicionais no de destino
boolean. Opcional. Use quando UseWebDeploy == true. Valor padrão: false.

Use essa opção para excluir arquivos no Serviço de Aplicativo do Azure que não tenham arquivos correspondentes no pacote ou pasta do Serviço de Aplicativo.


ExcludeFilesFromAppDataFlag - Excluir arquivos da pasta App_Data
boolean. Opcional. Use quando UseWebDeploy == true. Valor padrão: false.

Exclua arquivos na pasta App_Data de serem implantados no Serviço de Aplicativo do Azure.


AdditionalArguments - Argumentos adicionais
string. Opcional. Use quando UseWebDeploy == true.

Argumentos adicionais de implantação da Web seguindo a sintaxe -key:value.

Eles serão aplicados ao implantar o Serviço de Aplicativo do Azure. Exemplo: -disableLink:AppPoolExtension-disableLink:ContentExtension.

Saiba mais sobre configurações de operação do Web Deploy.


TakeAppOfflineFlag - colocar o aplicativo offline
boolean. Valor padrão: false.

Use essa opção para colocar o Serviço de Aplicativo do Azure offline colocando um arquivo de app_offline.htm no diretório raiz do Serviço de Aplicativo antes do início da operação de sincronização. O arquivo será removido depois que a operação de sincronização for concluída com êxito.


Opções de controlo de tarefas

Todas as tarefas têm opções de controle, além de suas entradas de tarefas. Para obter mais informações, consulte Opções de controle de e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Requerimentos

Requisito Descrição
Tipos de pipeline YAML, Construção clássica, Versão clássica
Funciona em Agente
Exigências Nenhum
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 1.102.0 ou superior
Categoria de tarefa Desplegar