Compartilhar via


AzureRmWebAppDeployment@2 – Tarefa implantar o Serviço de Aplicativo do Azure v2

Use esta tarefa para atualizar o Serviço de Aplicativo do Azure usando a Implantação da Web/APIs REST do Kudu.

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.

Entradas

ConnectedServiceName - assinatura 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.


de slot do
string. Necessário quando DeployToSlotFlag = true.

Especifique um slot existente diferente do slot de produção.


de Aplicativo Virtual VirtualApplication -
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.


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

O caminho da pasta ou do arquivo para o pacote ou pasta do Serviço de Aplicativo. As variáveis incluem de build e de versão. caracteres curinga têm suporte.

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


de URL do Serviço de Aplicativo WebAppUri -
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 de Implantação da Web
boolean. Valor padrão: true.

Publish using web deploy opções têm suporte somente ao usar um agente do Windows. Em outras plataformas, a tarefa se baseia em APIs REST do Kudu para implantar o Serviço de Aplicativo e as opções a seguir não têm suporte.


SetParametersFile - de arquivo SetParameters
string. Opcional. Use quando UseWebDeploy == true.

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


RemoveAdditionalFilesFlag - remover arquivos adicionais no 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 têm arquivos correspondentes no pacote ou pasta do Serviço de Aplicativo.


ExcludeFilesFromAppDataFlag - Excluir Arquivos do da Pasta App_Data
boolean. Opcional. Use quando UseWebDeploy == true. Valor padrão: false.

Exclua os 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 após a sintaxe -key:value.

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

Saiba mais sobre configurações de operação de implantação da Web.


TakeAppOfflineFlag - levar 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 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 após a conclusão da operação de sincronização com êxito.


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 de e as propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agente
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente 1.102.0 ou superior
Categoria de tarefa Implantar