AzureRmWebAppDeployment@2 – tarefa Implantar Serviço de Aplicativo do Azure v2

Artigo
01/27/2024

Atualize Serviço de Aplicativo do Azure usando APIs REST de Implantação da Web/Kudu.

Syntax

# 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.

# YAML Syntax is not supported in TFS 2018.
# Use the classic designer to add and configure tasks.
# See the following Inputs section for details on the inputs that this task supports.

Entradas

ConnectedServiceName - Assinatura do Azure
string. Obrigatórios.

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

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

Insira ou selecione o nome de um Serviço de Aplicativo do Azure existente.

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

Selecione a opção para implantar em um slot existente que não seja o slot de produção.

ResourceGroupName - Grupo de recursos
string. Obrigatório quando DeployToSlotFlag = true.

Insira ou selecione o grupo de recursos do Azure que contém o Serviço de Aplicativo do Azure especificado acima.

SlotName - Slot
string. Obrigatório quando DeployToSlotFlag = true.

Insira ou selecione um slot existente que não seja o slot de produção.

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

Package - Pacote ou Pasta
string. Obrigatórios. Valor padrão: $(System.DefaultWorkingDirectory)/**/*.zip.

Caminho de pasta ou arquivo para o pacote ou pasta Serviço de Aplicativo. Variáveis (Versão de Build | ), curingas são compatíveis.
Por exemplo, $(System.DefaultWorkingDirectory)/**/*.zip.

WebAppUri - URL 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 consumida em tarefas subsequentes.

UseWebDeploy - Publicar usando a Implantação da Web
boolean. Valor padrão: true.

A publicação usando opções de implantação na Web só tem suporte ao usar o agente do Windows. Em outras plataformas, a tarefa depende das APIs REST do Kudu para implantar o Serviço de Aplicativo e as opções a seguir não têm suporte.

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

Opcional: local do arquivo SetParameters.xml a ser usado.

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

Selecione a opção para excluir arquivos no Serviço de Aplicativo do Azure que não têm arquivos correspondentes no Serviço de Aplicativo pacote ou pasta.

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

Selecione a opção para impedir que arquivos na pasta App_Data sejam 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.
Elas serão aplicadas ao implantar o Serviço de Aplicativo do Azure. Exemplo: -disableLink:AppPoolExtension -disableLink:ContentExtension.
Para obter mais exemplos de configurações de operação de Implantação da Web, consulte isso.

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

Selecione a 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 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.

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
Execuções em	Agente
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.102.0 ou superior
Categoria da tarefa	Implantar

Compartilhar via