AzureRmWebAppDeployment@4 - Serviço de Aplicações do Azure implementar tarefa v4

Utilize esta tarefa para implementar para Serviço de Aplicações do Azure uma aplicação Web, móvel ou API com Docker, Java, .NET, .NET Core, Node.js, PHP, Python ou Ruby.

Nota

Utilize AzureFunctionApp@1 para implementar aplicações Funções do Azure.

Syntax

# Azure App Service deploy v4
# Deploy to Azure App Service a web, mobile, or API app using Docker, Java, .NET, .NET Core, Node.js, PHP, Python, or Ruby.
- task: AzureRmWebAppDeployment@4
  inputs:
    ConnectionType: 'AzureRM' # 'AzureRM' | 'PublishProfile'. Required. Connection type. Default: AzureRM.
    azureSubscription: # string. Alias: ConnectedServiceName. Required when ConnectionType = AzureRM. Azure subscription. 
    #PublishProfilePath: '$(System.DefaultWorkingDirectory)/**/*.pubxml' # string. Required when ConnectionType = PublishProfile. Publish profile path. Default: $(System.DefaultWorkingDirectory)/**/*.pubxml.
    #PublishProfilePassword: # string. Required when ConnectionType = PublishProfile. Publish profile password. 
    appType: 'webApp' # 'webApp' | 'webAppLinux' | 'webAppContainer' | 'webAppHyperVContainer' | 'functionApp' | 'functionAppLinux' | 'functionAppContainer' | 'apiApp' | 'mobileApp'. Alias: WebAppKind. Required when ConnectionType = AzureRM. App Service type. Default: webApp.
    WebAppName: # string. Required when ConnectionType = AzureRM. App Service name. 
    #deployToSlotOrASE: false # boolean. Alias: DeployToSlotOrASEFlag. Optional. Use when ConnectionType = AzureRM && WebAppKind != "". Deploy to Slot or App Service Environment. Default: false.
    #ResourceGroupName: # string. Required when DeployToSlotOrASEFlag = true. Resource group. 
    #SlotName: 'production' # string. Required when DeployToSlotOrASEFlag = true. Slot. Default: production.
    #DockerNamespace: # string. Required when WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = webAppHyperVContainer. Registry or Namespace. 
    #DockerRepository: # string. Required when WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = webAppHyperVContainer. Image. 
    #DockerImageTag: # string. Optional. Use when WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = webAppHyperVContainer. Tag. 
    #VirtualApplication: # string. Optional. Use when WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != functionApp && webAppKind != functionAppLinux && WebAppKind != "". Virtual application. 
    #packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Alias: Package. Required when ConnectionType = PublishProfile || WebAppKind = webApp || WebAppKind = apiApp || WebAppKind = functionApp || WebAppKind = mobileApp || WebAppKind = webAppLinux || webAppKind = functionAppLinux. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #RuntimeStack: # string. Optional. Use when WebAppKind = webAppLinux. Runtime Stack. 
    #RuntimeStackFunction: # 'DOTNET|2.2' | 'DOTNET|3.1' | 'JAVA|8' | 'JAVA|11' | 'NODE|8' | 'NODE|10' | 'NODE|12' | 'NODE|14' | 'PYTHON|3.6' | 'PYTHON|3.7' | 'PYTHON|3.8'. Optional. Use when WebAppKind = functionAppLinux. Runtime Stack. 
    #StartupCommand: # string. Optional. Use when WebAppKind = webAppLinux || WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = functionAppLinux || WebAppKind = webAppHyperVContainer. Startup command. 
  # Post Deployment Action
    #ScriptType: # 'Inline Script' | 'File Path'. Optional. Use when ConnectionType = AzureRM && WebAppKind != "" && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer. Deployment script type. 
    #InlineScript: ':: You can provide your deployment commands here. One command per line.' # string. Required when ScriptType == Inline Script && ConnectionType = AzureRM && WebAppKind != "" && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer. Inline Script. Default: :: You can provide your deployment commands here. One command per line..
    #ScriptPath: # string. Required when ScriptType == File Path && ConnectionType = AzureRM && WebAppKind != "" && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer. Deployment script path. 
  # File Transforms & Variable Substitution Options
    #WebConfigParameters: # string. Optional. Use when WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war. Generate web.config parameters for Python, Node.js, Go and Java apps. 
    #enableXmlTransform: false # boolean. Alias: XmlTransformation. Optional. Use when WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war. XML transformation. Default: false.
    #enableXmlVariableSubstitution: false # boolean. Alias: XmlVariableSubstitution. Optional. Use when WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war. XML variable substitution. Default: false.
    #JSONFiles: # string. Optional. Use when WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war. JSON variable substitution. 
  # Application and Configuration Settings
    #AppSettings: # string. Optional. Use when ConnectionType = AzureRM. App settings. 
    #ConfigurationSettings: # string. Optional. Use when ConnectionType = AzureRM. Configuration settings. 
  # Additional Deployment Options
    #enableCustomDeployment: false # boolean. Alias: UseWebDeploy. Optional. Use when ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Select deployment method. Default: false.
    #DeploymentType: 'webDeploy' # 'webDeploy' | 'zipDeploy' | 'runFromZip'. Required when UseWebDeploy == true && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Deployment method. Default: webDeploy.
    #TakeAppOfflineFlag: true # boolean. Optional. Use when UseWebDeploy == true && DeploymentType != runFromZip && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Take App Offline. Default: true.
    #SetParametersFile: # string. Optional. Use when UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. SetParameters file. 
    #RemoveAdditionalFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Remove additional files at destination. Default: false.
    #ExcludeFilesFromAppDataFlag: true # boolean. Optional. Use when UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Exclude files from the App_Data folder. Default: true.
    #AdditionalArguments: '-retryAttempts:6 -retryInterval:10000' # string. Optional. Use when UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Additional arguments. Default: -retryAttempts:6 -retryInterval:10000.
    #RenameFilesFlag: true # boolean. Optional. Use when UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Rename locked files. Default: true.

Entradas

ConnectionType - Tipo de ligação
string. Obrigatório. Valores permitidos: AzureRM (Azure Resource Manager), PublishProfile (Publicar Perfil). Valor predefinido: AzureRM.

Especifique o tipo de ligação de serviço a utilizar para implementar a Aplicação Web.

Especifique Publish Profile para utilizar perfis de Publicação criados pelo Visual Studio.

azureSubscription - Subscrição do Azure
Alias de entrada: ConnectedServiceName. string. Necessário quando ConnectionType = AzureRM.

Especifique a subscrição do Azure Resource Manager para a implementação.

PublishProfilePath - Caminho de publicação do perfil
string. Necessário quando ConnectionType = PublishProfile. Valor predefinido: $(System.DefaultWorkingDirectory)/**/*.pubxml.

O caminho do perfil de publicação criado a partir do Visual Studio.

PublishProfilePassword - Publicar palavra-passe de perfil
string. Necessário quando ConnectionType = PublishProfile.

Recomenda-se armazenar uma palavra-passe numa variável secreta e utilizar essa variável aqui, por exemplo. $(Password).

appType - Serviço de Aplicações tipo
Alias de entrada: WebAppKind. string. Necessário quando ConnectionType = AzureRM. Valores permitidos: webApp (Aplicação Web no Windows), webAppLinux (Aplicação Web no Linux), webAppContainer (Aplicação Web para Contentores (Linux)), webAppHyperVContainer (Aplicação Web para Contentores (Windows)), functionApp (Function App no Windows (Não Recomendado, Utilizar Funções do Azure Tarefa)), functionAppLinux (Aplicação de Funções no Linux (Não Recomendado, Utilizar Funções do Azure Tarefa)), functionAppContainer (Aplicação de Funções para Contentores (Linux) (Não Recomendado, Utilizar Funções do Azure para a Tarefa de contentor)), apiApp (Aplicação API), mobileApp (Aplicação Móvel). Valor predefinido: webApp.

Escolha entre Aplicação Web No Windows, Aplicação Web no Linux, Aplicação Web para Contentores, Aplicação de Funções, Aplicação de Funções no Linux, Aplicação de Funções para Contentores e Aplicação Móvel.

WebAppName - Serviço de Aplicações nome
string. Necessário quando ConnectionType = AzureRM.

Especifique o nome de uma Serviço de Aplicações do Azure existente. Os serviços de aplicações baseados no tipo de aplicação selecionado só serão listados ao utilizar a tarefa assistente.

deployToSlotOrASE - Implementar no Bloco ou Ambiente do Serviço de Aplicações
Alias de entrada: DeployToSlotOrASEFlag. boolean. Opcional. Utilize quando ConnectionType = AzureRM && WebAppKind != "". Valor predefinido: false.

Especifique a opção para implementar num bloco de implementação existente ou num ambiente Serviço de Aplicações do Azure. Para ambos os destinos, a tarefa requer um nome de Grupo de Recursos. Se o destino da implementação for um bloco, por predefinição, a implementação será no bloco Produção . Qualquer outro nome de bloco existente pode ser fornecido. Se o destino de implementação for um ambiente Serviço de Aplicações do Azure, deixe o nome do bloco como Production e especifique apenas o nome do Grupo de Recursos.

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

O nome do Grupo de recursos é necessário quando o destino da implementação é um bloco de implementação ou um Ambiente do Serviço de Aplicações.

Especifique o Grupo de recursos do Azure que contém o Serviço de Aplicações do Azure especificado acima.

SlotName - Ranhura
string. Necessário quando DeployToSlotOrASEFlag = true. Valor predefinido: production.

Especifique um bloco existente que não seja o bloco Produção.

DockerNamespace - Registo ou Espaço de Nomes
string. Necessário quando WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = webAppHyperVContainer.

Um nome de domínio de nível superior globalmente exclusivo para o seu registo ou espaço de nomes específico. Nota: o nome de imagem completamente qualificado será do formato : {registry or namespace}/{repository}:{tag}. Por exemplo, myregistry.azurecr.io/nginx:latest.

DockerRepository - Imagem
string. Necessário quando WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = webAppHyperVContainer.

O nome do repositório onde as imagens de contentor são armazenadas. Nota: o nome de imagem completamente qualificado será do formato : {registry or namespace}/{repository}:{tag}. Por exemplo, myregistry.azurecr.io/nginx:latest.

DockerImageTag - Etiqueta
string. Opcional. Utilize quando WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = webAppHyperVContainer.

As etiquetas são o mecanismo que os registos utilizam para aplicar informações de versão a imagens do Docker. Nota: o nome de imagem completamente qualificado será do formato : {registry or namespace}/{repository}:{tag}. Por exemplo, myregistry.azurecr.io/nginx:latest.

VirtualApplication - Aplicação virtual
string. Opcional. Utilize quando WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != functionApp && webAppKind != functionAppLinux && WebAppKind != "".

Especifique o nome da Aplicação Virtual que foi configurada no portal do Azure. Esta opção não é necessária para implementações na raiz do site. A Aplicação Virtual tem de ter sido configurada antes da implementação do projeto Web.

packageForLinux - Pacote ou pasta
Alias de entrada: Package. string. Necessário quando ConnectionType = PublishProfile || WebAppKind = webApp || WebAppKind = apiApp || WebAppKind = functionApp || WebAppKind = mobileApp || WebAppKind = webAppLinux || webAppKind = functionAppLinux. Valor predefinido: $(System.DefaultWorkingDirectory)/**/*.zip.

O caminho do ficheiro para o pacote ou para uma pasta que contenha conteúdos do serviço de aplicações gerados pelo MSBuild ou um ficheiro zip ou war comprimido.

As variáveis são Compilação e Versão. São suportados carateres universais .

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

RuntimeStack - Pilha de Runtime
string. Opcional. Utilize quando WebAppKind = webAppLinux.

Especifique a arquitetura e a versão da Aplicação de Funções no Linux.

RuntimeStackFunction - Pilha de Runtime
string. Opcional. Utilize quando WebAppKind = functionAppLinux. Valores permitidos: DOTNET|2.2 (DOTNET|2.2 (functionapp v2)), DOTNET|3.1 (DOTNET|3.1 (functionapp v3)), JAVA|8 (JAVA|8 (functionapp v2/v3)), JAVA|11 (JAVA|11 (functionapp v3)), NODE|8 (NODE|8 (functionapp v2)), NODE|10 (NODE|10 (functionapp v2/v3)), NODE|12 (NODE|12 (functionapp v3)), NODE|14 (NODE|14 (functionapp v3)), PYTHON|3.6 (PYTHON|3 .6 (functionapp v2/v3)), PYTHON|3.7 (PYTHON|3.7 (functionapp v2/v3)), PYTHON|3.8 (PYTHON|3.8 (functionapp v3)).

Especifique a arquitetura e a versão. Veja a descrição geral das versões de runtime Funções do Azure para obter as versões de runtime suportadas. Os valores antigos como DOCKER|microsoft/azure-functions-* são preteridos. Utilize os novos valores da lista pendente.

StartupCommand - Comando de arranque
string. Opcional. Utilize quando WebAppKind = webAppLinux || WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = functionAppLinux || WebAppKind = webAppHyperVContainer.

Especifique o comando Arranque. Por exemplo:

dotnet exec filename.dll

dotnet filename.dll.

ScriptType - Tipo de script de implementação
string. Opcional. Utilize quando ConnectionType = AzureRM && WebAppKind != "" && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer. Valores permitidos: Inline Script, File Path (Caminho do Ficheiro de Script).

Personaliza a implementação ao fornecer um script que é executado no Serviço de Aplicações do Azure após a implementação com êxito. Escolha o script de implementação inline ou o caminho e o nome de um ficheiro de script. Saiba mais sobre a Implementação do Serviço de Aplicações do Azure.

InlineScript - Inline Script
string. Necessário quando ScriptType == Inline Script && ConnectionType = AzureRM && WebAppKind != "" && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer. Valor predefinido: :: You can provide your deployment commands here. One command per line..

O script a executar. Pode fornecer os comandos de implementação aqui, um comando por linha. Veja o seguinte exemplo.

ScriptPath - Caminho do script de implementação
string. Necessário quando ScriptType == File Path && ConnectionType = AzureRM && WebAppKind != "" && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer.

O caminho e o nome do script a executar.

WebConfigParameters - Gerar parâmetros de web.config para aplicações Python, Node.js, Go e Java
string. Opcional. Utilize quando WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war.

Será gerada e implementada uma norma Web.config para Serviço de Aplicações do Azure se a aplicação não tiver uma. Os valores em web.config podem ser editados e variar consoante a arquitetura da aplicação. Por exemplo, para node.js aplicações, web.config terá um ficheiro de Arranque e iis_node valores do módulo. Esta funcionalidade de edição destina-se apenas à gerada web.config. Saiba mais sobre Serviço de Aplicações do Azure Implementação.

AppSettings - Definições da aplicação
string. Opcional. Utilize quando ConnectionType = AzureRM.

Edita as definições da aplicação Web com a sintaxe -key value. Os valores que contêm espaços têm de estar entre aspas. Exemplos: -Port 5000 -RequestTimeout 5000 e -WEBSITE_TIME_ZONE "Eastern Standard Time". Para fornecer dois ou mais valores chave, os valores de chave têm de ser separados por um espaço. Exemplo: -key1 "Value1" -Key2 "Value2".

ConfigurationSettings - Definições de configuração
string. Opcional. Utilize quando ConnectionType = AzureRM.

Edita as definições de configuração da aplicação Web com a sintaxe -key value. Os valores que contêm espaços têm de estar entre aspas. Exemplo: -phpVersion 5.6 -linuxFxVersion node|6.11.

enableCustomDeployment - Selecionar método de implementação
Alias de entrada: UseWebDeploy. boolean. Opcional. Utilize quando ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Valor predefinido: false.

Se for desmarcada ou falsa, a tarefa deteta automaticamente o melhor método de implementação com base no tipo de aplicação, no formato do pacote e noutros parâmetros. Verifique esta opção na tarefa assistente para ver os métodos de implementação suportados e escolha uma para implementar a sua aplicação.

DeploymentType - Método de implementação
string. Necessário quando UseWebDeploy == true && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Valores permitidos: webDeploy (Web Deploy), zipDeploy (Zip Deploy), runFromZip (Run From Package). Valor predefinido: webDeploy.

Determina o método de implementação da aplicação.

TakeAppOfflineFlag - Tirar a Aplicação Offline
boolean. Opcional. Utilize quando UseWebDeploy == true && DeploymentType != runFromZip && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Valor predefinido: true.

Especifique esta opção para colocar o Serviço de Aplicações do Azure offline ao colocar um app_offline.htm ficheiro no diretório de raiz antes do início da operação de sincronização. O ficheiro será removido após a sincronização ser concluída com êxito.

SetParametersFile - Ficheiro SetParameters
string. Opcional. Utilize quando UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar.

A localização do SetParameters.xml ficheiro a utilizar.

RemoveAdditionalFilesFlag - Remover ficheiros adicionais no destino
boolean. Opcional. Utilize quando UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Valor predefinido: false.

Especifique "true" para eliminar ficheiros no Serviço de Aplicações do Azure que não tenham ficheiros correspondentes no pacote ou pasta Serviço de Aplicações. Isto também removerá todos os ficheiros relacionados com qualquer extensão instalada neste Serviço de Aplicações do Azure. Para evitar esta situação, selecione a Exclude files from App_Data folder caixa de verificação.

ExcludeFilesFromAppDataFlag - Excluir ficheiros da pasta App_Data
boolean. Opcional. Utilize quando UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Valor predefinido: true.

Especifique a opção para impedir que os ficheiros na App_Data pasta sejam implementados/eliminados do Serviço de Aplicações do Azure.

AdditionalArguments - Argumentos adicionais
string. Opcional. Utilize quando UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Valor predefinido: -retryAttempts:6 -retryInterval:10000.

Argumentos adicionais de Implementação web que seguem a sintaxe -key:value. Estes serão aplicados ao implementar o Serviço de Aplicações do Azure. Exemplos: -disableLink:AppPoolExtension -disableLink:ContentExtension. Saiba mais sobre as Definições de Operação de Implementação da Web.

RenameFilesFlag - Mudar o nome dos ficheiros bloqueados
boolean. Opcional. Utilize quando UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Valor predefinido: true.

Especifique o valor predefinido para ativar o sinalizador MSDEPLOY_RENAME_LOCKED_FILES=1 msdeploy no Serviço de Aplicações do Azure definições da aplicação. Se estiver definida, a opção permite que msdeploy mude o nome dos ficheiros bloqueados durante a implementação da aplicação.

enableXmlTransform - Transformação XML
Alias de entrada: XmlTransformation. boolean. Opcional. Utilize quando WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war. Valor predefinido: false.

As transformações de configuração serão executadas para *.Release.config e *.<EnvironmentName>.config no *.config file. As transformações de configuração são executadas antes da substituição de variáveis. As transformações XML são suportadas apenas para a plataforma Windows.

enableXmlVariableSubstitution - Substituição de variável XML
Alias de entrada: XmlVariableSubstitution. boolean. Opcional. Utilize quando WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war. Valor predefinido: false.

As variáveis definidas no pipeline de compilação ou versão serão correspondidas às entradas de chave ou nome nas configSectionssecções , appSettings, applicationSettingse connectionStrings de qualquer ficheiro e parameters.xml ficheiro de configuração. A substituição de variáveis é executada após transformações de configuração.

Se as mesmas variáveis forem definidas no pipeline de versão e na fase, as variáveis de fase irão substituir as variáveis do pipeline de versão. Saiba mais sobre [substituição de variáveis XML]](/azure/devops/pipelines/tasks/transforms-variable-substitution#xml-variable-substitution).

JSONFiles - Substituição de variável JSON
string. Opcional. Utilize quando WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war.

Fornece uma lista separada por novas linhas de ficheiros JSON para substituir os valores da variável. Os nomes dos ficheiros têm de ser relativos à pasta raiz. Para substituir as variáveis JSON aninhadas ou hierárquicas, especifique-as com JSONPath expressões. Por exemplo, para substituir o valor de ConnectionString no exemplo abaixo, defina uma variável com o nome Data.DefaultConnection.ConnectionString na fase de pipeline de compilação ou versão (ou pipelines de versão).

{
  "Data": {
    "DefaultConnection": {
      "ConnectionString": "Server=(localdb)\SQLEXPRESS;Database=MyDB;Trusted_Connection=True"
    }
  }
}

Uma substituição de variável é executada após transformações de configuração. Nota: as variáveis de pipeline de compilação e versão são excluídas da substituição. Saiba mais sobre a substituição de variáveis JSON.

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Esta tarefa define as seguintes variáveis de saída, que pode consumir em passos, tarefas e fases a jusante.

AppServiceApplicationUrl
URL da aplicação do Serviço de Aplicações selecionado.

Observações

• Pré-requisitos para a tarefa
• Notas de utilização
• Métodos de implementação
• Resolução de problemas
• FAQs

Utilize esta tarefa para implementar num intervalo de Serviços aplicacionais no Azure. A tarefa funciona em agentes de várias plataformas com Windows, Linux ou Mac e utiliza várias tecnologias de implementação subjacentes diferentes.

A tarefa funciona para aplicações Web baseadas em ASP.NET, ASP.NET Core, PHP, Java, Python, Go e Node.js.

A tarefa pode ser utilizada para implementar num intervalo de Serviços Aplicação Azure AD, como:

• Aplicações Web no Windows e linux
• Aplicações Web para Contentores
• Aplicações de Funções no Windows e linux
• Aplicações de Funções para Contentores
• WebJobs
• Aplicações configuradas em Ambientes de Serviço de Aplicações do Azure

Pré-requisitos da tarefa

Os seguintes pré-requisitos têm de ser configurados nos computadores de destino para que a tarefa funcione corretamente.

• Serviço de Aplicações instância. A tarefa é utilizada para implementar um projeto de Aplicação Web ou um projeto de Função do Azure numa instância de Serviço de Aplicações do Azure existente, que tem de existir antes de a tarefa ser executada. A instância Serviço de Aplicações pode ser criada a partir do portal do Azure e configurada aí. Em alternativa, a tarefa Azure PowerShell pode ser utilizada para executar scripts do PowerShell do AzureRM para aprovisionar e configurar a Aplicação Web.

• Subscrição do Azure. Para implementar no Azure, uma subscrição do Azure tem de estar ligada ao pipeline. A tarefa não funciona com a ligação de serviço Clássico do Azure e não listará estas ligações nas definições da tarefa.

Notas de utilização

• A tarefa funciona apenas com as APIs do Azure Resource Manager.
• Para ignorar erros de SSL, defina uma variável com o nome VSTS_ARM_REST_IGNORE_SSL_ERRORS com valor true no pipeline. Se estiver a implementar num bloco configurado para troca automática, a troca falhará, a menos que defina SCM_SKIP_SSL_VALIDATION ou SCM_SKIP_ASE_SSL_VALIDATION para 1 nas definições de configuração dos serviços de aplicações.
• Para aplicações .NET direcionadas para a Aplicação Web no Windows, evite a falha de implementação com o erro ERROR_FILE_IN_USE ao garantir que Mudar o nome dos ficheiros bloqueados e colocar as definições da Aplicação Offline ativadas. Para uma implementação sem tempo de inatividade, utilize a opção de troca de blocos.
• Ao implementar num Serviço de Aplicações que tenha o Application Insights configurado e tiver ativado Remover ficheiros adicionais no destino, certifique-se de que também ativa Excluir ficheiros da pasta App_Data para manter a extensão do Application Insights num estado seguro. Isto é necessário porque a tarefa Web contínua do Application Insights está instalada na pasta App_Data.

Métodos de implementação

Estão disponíveis vários métodos de implementação nesta tarefa. O Web Deploy (msdeploy.exe) é a predefinição. Para alterar a opção de implementação, expanda Opções de Implementação Adicionais e ative Selecionar método de implementação para escolher entre opções de implementação adicionais baseadas em pacotes.

Com base no tipo de Serviço de Aplicações do Azure e agente, a tarefa escolhe uma tecnologia de implementação adequada. As diferentes tecnologias de implementação utilizadas pela tarefa são:

• Web Deploy
• Kudu REST APIs
• Container Registry
• Implementação do Zip
• Executar a partir do Pacote
• Implementação de Guerra

Por predefinição, a tarefa tenta selecionar a tecnologia de implementação adequada com base no tipo de pacote de entrada, Serviço de Aplicações tipo e sistema operativo do agente.

Deteção Automática de Lógica

Para agentes baseados no Windows.

Serviço de Aplicações tipo	Tipo de pacote	Método de Implementação
WebApp no Linux ou Aplicação de Funções no Linux	Guerra de Pastas/Zip/jar	Implementar o Zip War Deploy
WebApp para Contentores (Linux) ou Aplicação de Funções para Contentores (Linux)	Atualizar as Definições da aplicação	ND
WebApp no Windows, Aplicação de Funções no Windows, Aplicação API ou Aplicação Móvel	Tipo de pacote War Jar MsBuild ou implementar na Pasta de aplicações virtuais/Zip	Implementação war zip deploy web deploy if postDeploymentScript == true, Zip Deploy else, Run From Package

Em agentes não Windows (para qualquer tipo de Serviço de Aplicações), a tarefa depende das APIs REST do Kudu para implementar a aplicação.

Web Deploy

A Implementação Web (msdeploy.exe) pode ser utilizada para implementar uma Aplicação Web no Windows ou uma Aplicação de Funções no Serviço de Aplicações do Azure utilizando um agente do Windows. O Web Deploy é rico em funcionalidades e oferece opções como:

• Mudar o nome dos ficheiros bloqueados: Mude o nome de qualquer ficheiro que ainda esteja a ser utilizado pelo servidor Web ao ativar o sinalizador MSDEPLOY\_RENAME\_LOCKED\_FILES=1 msdeploy nas definições de Serviço de Aplicações do Azure. Esta opção, se definida, permite ao msdeploy mudar o nome dos ficheiros bloqueados durante a implementação da aplicação.

• Remover ficheiros adicionais no destino: Elimina ficheiros na Serviço de Aplicações do Azure que não têm ficheiros correspondentes no pacote ou pasta de artefactos Serviço de Aplicações que está a ser implementado.

• Excluir ficheiros da pasta App_Data: Impedir que os ficheiros na pasta App_Data (na pasta/pacote de artefactos que está a ser implementado) sejam implementados no Serviço de Aplicações do Azure

• Argumentos adicionais de Implementação Web: Argumentos que serão aplicados ao implementar o Serviço de Aplicações do Azure. Exemplo: -disableLink:AppPoolExtension -disableLink:ContentExtension. Para obter mais exemplos de definições de operação de Implementação Web, veja Definições da Operação de Implementação Web.

Instale o Web Deploy no agente a partir do Web Deploy 3.6. O Web Deploy 3.5 tem de ser instalado sem o suporte de SQL agrupado. Não é necessário escolher definições personalizadas ao instalar o Web Deploy. O Web Deploy está instalado em C:/Program Files (x86)/IIS/Microsoft Web Deploy V3.

Kudu REST APIs

As APIs REST do Kudu funcionam em agentes de automatização do Windows e do Linux quando o destino é uma Aplicação Web no Windows, aplicação Web no Linux (origem incorporada) ou a Aplicação de Funções. A tarefa utiliza o Kudu para copiar ficheiros para o serviço Aplicação Azure AD.

Container Registry

Funciona em agentes de automatização do Windows e do Linux quando o destino é uma Aplicação Web para Contentores. A tarefa atualiza a aplicação ao definir o registo de contentor, o repositório, o nome da imagem e as informações de etiqueta adequados. Também pode utilizar a tarefa para transmitir um comando de arranque para a imagem de contentor.

Implementação do Zip

Espera um pacote de implementação .zip e implementa o conteúdo do ficheiro na pasta wwwroot do Serviço de Aplicações ou da Function App no Azure. Esta opção substitui todos os conteúdos existentes na pasta wwwroot . Para obter mais informações, veja Implementação zip para Funções do Azure.

Executar a partir do Pacote

Espera o mesmo pacote de implementação que o Zip Deploy. No entanto, em vez de implementar ficheiros na pasta wwwroot , todo o pacote é montado pelo runtime das Funções e os ficheiros na pasta wwwroot tornam-se só de leitura. Para mais informações, veja Executar as suas Funções do Azure a partir de um ficheiro de pacote.

Implementação de Guerra

Espera um pacote de implementação .war e implementa o conteúdo do ficheiro na pasta wwwroot ou na pasta webapps do Serviço de Aplicações no Azure.

Resolução de problemas

Não consigo Implementar na Web no meu Serviço de Aplicações do Azure através da autenticação Microsoft Entra ID do meu agente do Windows

A tarefa de implementação Serviço de Aplicações do Azure suporta a ligação ao Microsoft Azure com uma ligação de serviço ARM através de Microsoft Entra ID, a menos que estejam presentes as três condições seguintes:

• Está a utilizar o formato de pacote Web Deploy num agente do Windows
• O agente está a ser executado com uma versão mais antiga do msdeploy.exe (por exemplo, ao utilizar a imagem do agente alojado do Windows-2019 )
• A autenticação básica está desativada para a sua Serviço de Aplicações do Azure

Se estas três condições estiverem presentes, receberá um erro como App Service is configured to not use basic authentication. This requires Web Deploy msdeploy.exe version 7.1.7225.2108 or higher. You need a version of Visual Studio that includes an updated version of msdeploy.exe. For more information, visit https://aka.ms/azdo-webapp-msdeploy.

Para resolver este problema, pode escolher entre as seguintes opções, por ordem de preferência.

1. Atualize a imagem do agente. Se estiver a utilizar agentes alojados, mude do windows-2019 para o windows-2022 (ou windows-latest). Se estiver a utilizar agentes autoalojados, instale o Visual Studio 2022 no agente para obter uma versão mais recente do msdeploy.exe.
2. Se estiver dependente de uma imagem de agente mais antiga e não conseguir atualizar o agente para o pipeline, considere dividir a tarefa para que o Serviço de Aplicações do Azure a tarefa de implementação seja executada no windows-2022 (ou windows-latest).
3. Se nenhuma destas opções for possível, pode ativar a autenticação básica para a sua Serviço de Aplicações do Azure.

Erro: Não foi possível obter o token de acesso para o Azure. Verifique se o Principal de Serviço utilizado é válido e não expirou.

A tarefa utiliza o principal de serviço na ligação de serviço para autenticar com o Azure. Se o principal de serviço tiver expirado ou não tiver permissões para o Serviço de Aplicações, a tarefa falhará com este erro. Verifique a validade do principal de serviço utilizado e se este está presente no registo da aplicação. Para obter mais informações, veja Utilizar o controlo de acesso baseado em funções para gerir o acesso aos recursos da subscrição do Azure. Esta mensagem de blogue também contém mais informações sobre a utilização da autenticação do principal de serviço.

Erro SSL

Se quiser utilizar um certificado no Serviço de Aplicações, o certificado tem de ser assinado por uma autoridade de certificação fidedigna. Se a sua aplicação Web der erros de validação do certificado, é provável que esteja a utilizar um certificado autoassinado. Defina uma variável com o nome VSTS_ARM_REST_IGNORE_SSL_ERRORS para o valor true no pipeline de compilação ou versão para resolver o erro.

Uma versão fica pendente durante muito tempo e falha

Este problema pode ser o resultado de uma capacidade insuficiente no seu plano de Serviço de Aplicações. Para resolver este problema, pode aumentar verticalmente a instância Serviço de Aplicações para aumentar a CPU, a RAM e o espaço em disco disponíveis ou tentar com um plano de Serviço de Aplicações diferente.

Códigos de erro 5xx

Se estiver a ver um erro de 5xx , verifique o estado do seu serviço do Azure.

A Função do Azure deixou subitamente de funcionar

Funções do Azure podem deixar subitamente de funcionar se já passar mais de um ano desde a última implementação. Se implementar com "RunFromPackage" em "deploymentMethod", é gerada uma SAS com uma data de expiração de 1 ano e definida como o valor de "WEBSITE_RUN_FROM_PACKAGE" na configuração da aplicação. Funções do Azure utiliza esta SAS para referenciar o ficheiro de pacote para execução de funções, pelo que, se a SAS tiver expirado, a função não será executada. Para resolver este problema, implemente novamente para gerar uma SAS com uma data de expiração de um ano.

Erro: Nenhum pacote encontrado com o padrão especificado

Verifique se o pacote mencionado na tarefa se encontra publicado como um artefacto na compilação ou numa fase anterior e transferido na tarefa atual.

Erro: a opção Publicar com a implementação zip não é suportada para o tipo de pacote msBuild

Os pacotes Web criados através da tarefa MSBuild (com argumentos predefinidos) têm uma estrutura de pasta aninhada que só pode ser implementada corretamente pela Implementação Web. A opção de implementação publicar para zip não pode ser utilizada para implementar esses pacotes. Para converter a estrutura de empacotamento, siga estes passos:

1. Na tarefa Criar solução, altere os Argumentos MSBuild para /p:DeployOnBuild=true /p:DeployDefaultTarget=WebPublish /p:WebPublishMethod=FileSystem /p:DeleteExistingFiles=True /p:publishUrl="$(System.DefaultWorkingDirectory)\\WebAppContent":

   

2. Adicione uma tarefa Arquivo e altere os valores da seguinte forma:

   1. Altere a pasta ou ficheiro raiz para arquivar para$(System.DefaultWorkingDirectory)\\WebAppContent.

   2. Desmarque a caixa de verificação Nome da pasta raiz de pré-final para arquivar caminhos :

      

A implementação de aplicações Web no Windows é concluída com êxito, mas a aplicação não está a funcionar

Isto pode dever-se ao facto de web.config não estar presente na sua aplicação. Pode adicionar um ficheiro web.config à sua origem ou gerar automaticamente um com as Opções de Transformações de Ficheiros e Substituição de Variáveis da tarefa.

• Clique na tarefa e aceda a Gerar parâmetros de web.config para aplicações Python, Node.js, Go e Java.

  

• Clique no botão Mais Gerar parâmetros de web.config para aplicações Python, Node.js, Go e Java para editar os parâmetros.

  

• Selecione o tipo de aplicação no menu pendente.

• Clique em OK. Isto irá preencher web.config parâmetros necessários para gerar web.config.

Nota

Esta secção foi preterida e foi substituída pela tarefa de Transformação de Ficheiros .

ERROR_FILE_IN_USE

Ao implementar aplicações .NET na Aplicação Web no Windows, a implementação pode falhar com o código de erro ERROR_FILE_IN_USE. Para resolver o erro, certifique-se de que Mudar o nome dos ficheiros bloqueados e que as opções Tirar Aplicação Offline estão ativadas na tarefa. Para implementações sem tempo de inatividade, utilize a troca de blocos.

Também pode utilizar o método de implementação Executar a partir do Pacote para evitar o bloqueio de recursos.

Erro de Implementação Web

Se estiver a utilizar a implementação Web para implementar a aplicação, em alguns cenários de erro, a Implementação Web apresentará um código de erro no registo. Para resolver um erro de implementação Web, veja Códigos de erro de Implementação Web.

A implementação de aplicações Web no Ambiente do Serviço de Aplicações (ASE) não está a funcionar

• Confirme que o agente de compilação do Azure DevOps está na mesma VNET (a sub-rede pode ser diferente) que a Balanceador de Carga Interna (ILB) do ASE. Isto permitirá ao agente solicitar código do Azure DevOps e implementar no ASE.
• Se estiver a utilizar o Azure DevOps, o agente não precisa de estar acessível a partir da Internet, mas apenas precisa de acesso de saída para ligar ao Serviço de DevOps do Azure.
• Se estiver a utilizar o TFS/Azure DevOps Server implementado num Rede Virtual, o agente pode estar completamente isolado.
• O agente de compilação tem de ser configurado com a configuração de DNS da Aplicação Web em que precisa de implementar. Uma vez que os recursos privados no Rede Virtual não têm entradas no DNS do Azure, isto tem de ser adicionado ao ficheiro de anfitriões no computador do agente.
• Se for utilizado um certificado autoassinado para a configuração do ASE, a opção -allowUntrusted tem de ser definida na tarefa de implementação do MSDeploy. Também é recomendado definir a variável VSTS_ARM_REST_IGNORE_SSL_ERRORS como verdadeira. Se for utilizado um certificado de uma autoridade de certificação para a configuração do ASE, tal não deve ser necessário. Se estiver a implementar num bloco configurado para troca automática, a troca falhará, a menos que defina SCM_SKIP_SSL_VALIDATION ou SCM_SKIP_ASE_SSL_VALIDATION para 1 nas definições de configuração dos serviços de aplicações.

FAQs

Qual é a diferença entre as AzureWebApp tarefas e AzureRmWebAppDeployment ?

A tarefa da Aplicação Web do Azure (AzureWebApp) é a forma mais simples de implementar numa Aplicação Web do Azure. Por predefinição, a implementação ocorre na aplicação raiz na Aplicação Web do Azure.

A tarefa implementar Serviço de Aplicações do Azure (AzureRmWebAppDeployment) pode processar cenários mais personalizados, tais como:

• Modifique as definições de configuração dentro de pacotes Web e ficheiros de parâmetros XML.
• Implemente com a Implementação Web, se estiver habituado ao processo de implementação do IIS.
• Implementar em aplicações virtuais.
• Implemente noutros tipos de aplicações, como Aplicações de contentor, Aplicações de funções, WebJobs ou API e aplicações móveis.

Nota

As transformações de ficheiros e a substituição de variáveis também são suportadas pela tarefa de Transformação de Ficheiros separada para utilização nos Pipelines do Azure. Pode utilizar a tarefa Transformação de Ficheiros para aplicar transformações de ficheiros e substituições de variáveis em quaisquer ficheiros de configuração e parâmetros.

Como devo configurar a minha ligação de serviço?

Esta tarefa requer uma ligação de serviço do Azure Resource Manager.

Como devo configurar a implementação de tarefas Web com o Application Insights?

Quando estiver a implementar num Serviço de Aplicações, se tiver o Application Insights configurado e tiver ativado Remove additional files at destinationo , também tem de ativar Exclude files from the App_Data folder. Ativar esta opção mantém a extensão do Application Insights num estado seguro. Este passo é necessário porque o WebJob contínuo do Application Insights está instalado na pasta App_Data.

Como devo configurar o meu agente se estiver atrás de um proxy enquanto estou a implementar no Serviço de Aplicações?

Se o agente autoalojado precisar de um proxy Web, pode informar o agente sobre o proxy durante a configuração. Fazê-lo permite que o agente se ligue aos Pipelines do Azure ou Azure DevOps Server através do proxy. Saiba mais sobre como executar um agente autoalojado atrás de um proxy Web.

Exemplos

• Implementar num tipo de aplicação específico
• Implementar no contentor linux da Aplicação Web do Azure
• Implementar uma aplicação Web num windows Serviço de Aplicações em blocos de implementação
• Script de pós-implementação de exemplo

Implementar num tipo de aplicação específico

Para implementar num tipo de aplicação específico, defina appType para qualquer um dos seguintes valores aceites: webApp (Aplicação Web no Windows), webAppLinux (Aplicação Web no Linux), webAppContainer (Aplicação Web para Contentores - Linux), functionApp (Aplicação de Funções no Windows), functionAppLinux (Aplicação de Funções no Linux), functionAppContainer (Aplicação de Funções para Contentores - Linux), apiApp (Aplicação API) mobileApp (Aplicação Móvel). Se não for mencionado, webApp é considerado o valor predefinido.

Para ativar quaisquer opções de implementação avançadas, adicione o parâmetro enableCustomDeployment: true e inclua os seguintes parâmetros, conforme necessário.

# deploymentMethod: 'runFromPackage' # supports zipDeploy as well
    # appOffline: boolean    # Not applicable for 'runFromPackage'
    # setParametersFile: string
    # removeAdditionalFilesFlag: boolean
    # additionalArguments: string

Implementar no contentor linux da Aplicação Web do Azure

O exemplo YAML seguinte é implementado num contentor da Aplicação Web do Azure (Linux).

pool:
  vmImage: ubuntu-latest

variables:
  azureSubscriptionEndpoint: Contoso
  DockerNamespace: contoso.azurecr.io
  DockerRepository: aspnetcore
  WebAppName: containersdemoapp

steps:

- task: AzureRMWebAppDeployment@4
  displayName: Azure App Service Deploy
  inputs:
    appType: webAppContainer
    ConnectedServiceName: $(azureSubscriptionEndpoint)
    WebAppName: $(WebAppName)
    DockerNamespace: $(DockerNamespace)
    DockerRepository: $(DockerRepository)
    DockerImageTag: $(Build.BuildId)

Implementar uma aplicação Web num windows Serviço de Aplicações em blocos de implementação

O exemplo seguinte implementa uma aplicação Web numa Serviço de Aplicações do Windows em blocos de implementação.

pool:
  vmImage: 'windows-latest'

variables:
  solution: '**/*.sln'
  buildPlatform: 'Any CPU'
  buildConfiguration: 'Release'

stages:
 - stage: DeployDevStage
    displayName: 'Deploy App to Dev Slot'
    jobs:
      - job:  DeployApp
        displayName: 'Deploy App'
        steps:
        - task: DownloadPipelineArtifact@2
          inputs:
            buildType: 'current'
            artifactName: 'drop'
            targetPath: '$(System.DefaultWorkingDirectory)'
        - task: AzureRmWebAppDeployment@4
          inputs:
            ConnectionType: 'AzureRM'
            azureSubscription: 'Fabrikam Azure Subscription - PartsUnlimited'
            appType: 'webApp'
            WebAppName: 'partsunlimited'
            deployToSlotOrASE: true
            ResourceGroupName: 'rgPartsUnlimited'
            SlotName: 'Dev'
            packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip'

  - stage: DeployStagingStage
    displayName: 'Deploy App to Staging Slot'
    dependsOn: DeployDevStage
    jobs:
      - job:  DeployApp
        displayName: 'Deploy App'
        steps:
        - task: DownloadPipelineArtifact@2
          inputs:
            buildType: 'current'
            artifactName: 'drop'
            targetPath: '$(System.DefaultWorkingDirectory)'
        - task: AzureRmWebAppDeployment@4
          inputs:
            appType: webApp
            ConnectionType: AzureRM            
            ConnectedServiceName: 'Fabrikam Azure Subscription - PartsUnlimited'
            ResourceGroupName: 'rgPartsUnlimited'
            WebAppName: 'partsunlimited'
            Package: '$(System.DefaultWorkingDirectory)/**/*.zip'
            deployToSlotOrASE: true
            SlotName: 'staging'

Script de pós-implementação de exemplo

A tarefa fornece uma opção para personalizar a implementação ao fornecer um script que será executado no Serviço de Aplicações do Azure depois de os artefactos da aplicação terem sido copiados com êxito para o Serviço de Aplicações. Pode optar por fornecer um script de implementação inline ou o caminho e o nome de um ficheiro de script na pasta de artefactos.

Isto é muito útil quando quer restaurar as dependências da aplicação diretamente no Serviço de Aplicações. Restaurar pacotes para aplicações Node, PHP e Python ajuda a evitar tempos limite quando a dependência da aplicação resulta na cópia de um artefacto grande do agente para o Serviço de Aplicações do Azure.

Um exemplo de um script de implementação é:

@echo off
if NOT exist requirements.txt (
 echo No Requirements.txt found.
 EXIT /b 0
)
if NOT exist "$(PYTHON_EXT)/python.exe" (
 echo Python extension not available >&2
 EXIT /b 1
)
echo Installing dependencies
call "$(PYTHON_EXT)/python.exe" -m pip install -U setuptools
if %errorlevel% NEQ 0 (
 echo Failed to install setuptools >&2
 EXIT /b 1
)
call "$(PYTHON_EXT)/python.exe" -m pip install -r requirements.txt
if %errorlevel% NEQ 0 (
 echo Failed to install dependencies>&2
 EXIT /b 1
)

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica, Versão clássica
É executado em	Agent, DeploymentGroup
Exigências	Nenhuma
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos	Qualquer
Variáveis de definição	Qualquer
Versão do agente	2.104.1 ou superior
Categoria da tarefa	Implementar

Ver também

• Esta tarefa é open source no GitHub. Comentários e contribuições são bem-vindos.