AzureRmWebAppDeployment@3 - Serviço de Aplicações do Azure implementar tarefa v3

Artigo
07/02/2024

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.

Atualize os Serviços Aplicação Azure AD no Windows, a Aplicação Web no Linux com imagens incorporadas ou contentores docker, ASP.NET, .NET Core, PHP, Python ou aplicações Web baseadas em Node.js, Aplicações de Funções, Aplicações Móveis, aplicações API e Tarefas Web com APIs REST De Implementação Web/Kudu.

Syntax

# Azure App Service deploy v3
# 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@3
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    appType: 'app' # 'app' | 'applinux' | 'functionapp' | 'api' | 'mobileapp'. Alias: WebAppKind. Required. App type. Default: app.
    WebAppName: # string. Required. App Service name. 
    #DeployToSlotFlag: false # boolean. Optional. Use when WebAppKind != "". Deploy to slot. Default: false.
    #ResourceGroupName: # string. Required when DeployToSlotFlag = true. Resource group. 
    #SlotName: # string. Required when DeployToSlotFlag = true. Slot. 
    #ImageSource: 'Registry' # 'Registry' | 'Builtin'. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Image Source. Default: Registry.
    #AzureContainerRegistry: # string. Required when ImageSource = AzureContainerRegistry. Registry. 
    #AzureContainerRegistryLoginServer: # string. Optional. Use when ImageSource = invalidimagesource. Registry Login Server Name. 
    #AzureContainerRegistryImage: # string. Required when ImageSource = AzureContainerRegistry. Image. 
    #AzureContainerRegistryTag: # string. Optional. Use when ImageSource = AzureContainerRegistry. Tag. 
    #DockerRepositoryAccess: 'public' # 'private' | 'public'. Required when ImageSource = invalidImage. Repository Access. Default: public.
    #dockerRegistryConnection: # string. Alias: RegistryConnectedServiceName. Required when DockerRepositoryAccess = private || ImageSource = PrivateRegistry. Registry Connection. 
    #PrivateRegistryImage: # string. Required when ImageSource = PrivateRegistry. Image. 
    #PrivateRegistryTag: # string. Optional. Use when ImageSource = PrivateRegistry. Tag. 
    #DockerNamespace: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Registry or Namespace. 
    #DockerRepository: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Image. 
    #DockerImageTag: # string. Optional. Use when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Tag. 
    #VirtualApplication: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Virtual application. 
    #Package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required when WebAppKind != linux && WebAppKind != applinux &&  WebAppKind != "". Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Alias: BuiltinLinuxPackage. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #RuntimeStack: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Runtime Stack. 
    #StartupCommand: # string. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Startup command. 
  # Output
    #WebAppUri: # string. Optional. Use when WebAppKind != "". App Service URL. 
  # Post Deployment Action
    #ScriptType: # 'Inline Script' | 'File Path'. Optional. Use when WebAppKind != "". Deployment script type. 
    #InlineScript: ':: You can provide your deployment commands here. One command per line.' # string. Required when ScriptType == Inline Script && WebAppKind != "". Inline Script. Default: :: You can provide your deployment commands here. One command per line..
    #ScriptPath: # string. Required when ScriptType == File Path && WebAppKind != "". Deployment script path. 
  # File Transforms & Variable Substitution Options
    #GenerateWebConfig: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Generate Web.config. Default: false.
    #WebConfigParameters: # string. Required when GenerateWebConfig == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Web.config parameters. 
    #enableXmlTransform: false # boolean. Alias: XmlTransformation. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML transformation. Default: false.
    #enableXmlVariableSubstitution: false # boolean. Alias: XmlVariableSubstitution. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML variable substitution. Default: false.
    #JSONFiles: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. JSON variable substitution. 
  # Application and Configuration Settings
    #AppSettings: # string. App settings. 
    #ConfigurationSettings: # string. Configuration settings. 
  # Additional Deployment Options
    #TakeAppOfflineFlag: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Take App Offline. Default: false.
    #UseWebDeploy: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Publish using Web Deploy. Default: false.
    #SetParametersFile: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". SetParameters file. 
    #RemoveAdditionalFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Remove additional files at destination. Default: false.
    #ExcludeFilesFromAppDataFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Exclude files from the App_Data folder. Default: false.
    #AdditionalArguments: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Additional arguments. 
    #RenameFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Rename locked files. Default: false.

# Azure App Service Deploy v3
# Update Azure App Services on Windows, Web App on Linux with built-in images or Docker containers, ASP.NET, .NET Core, PHP, Python or Node.js based Web applications, Function Apps, Mobile Apps, API applications, Web Jobs using Web Deploy / Kudu REST APIs.
- task: AzureRmWebAppDeployment@3
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    appType: 'app' # 'app' | 'applinux' | 'functionapp' | 'api' | 'mobileapp'. Alias: WebAppKind. Required. App type. Default: app.
    WebAppName: # string. Required. App Service name. 
    #DeployToSlotFlag: false # boolean. Optional. Use when WebAppKind != "". Deploy to slot. Default: false.
    #ResourceGroupName: # string. Required when DeployToSlotFlag = true. Resource group. 
    #SlotName: # string. Required when DeployToSlotFlag = true. Slot. 
    #ImageSource: 'Registry' # 'Registry' | 'Builtin'. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Image Source. Default: Registry.
    #AzureContainerRegistry: # string. Required when ImageSource = AzureContainerRegistry. Registry. 
    #AzureContainerRegistryLoginServer: # string. Optional. Use when ImageSource = invalidimagesource. Registry Login Server Name. 
    #AzureContainerRegistryImage: # string. Required when ImageSource = AzureContainerRegistry. Image. 
    #AzureContainerRegistryTag: # string. Optional. Use when ImageSource = AzureContainerRegistry. Tag. 
    #DockerRepositoryAccess: 'public' # 'private' | 'public'. Required when ImageSource = invalidImage. Repository Access. Default: public.
    #dockerRegistryConnection: # string. Alias: RegistryConnectedServiceName. Required when DockerRepositoryAccess = private || ImageSource = PrivateRegistry. Registry Connection. 
    #PrivateRegistryImage: # string. Required when ImageSource = PrivateRegistry. Image. 
    #PrivateRegistryTag: # string. Optional. Use when ImageSource = PrivateRegistry. Tag. 
    #DockerNamespace: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Registry or Namespace. 
    #DockerRepository: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Image. 
    #DockerImageTag: # string. Optional. Use when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Tag. 
    #VirtualApplication: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Virtual application. 
    #Package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required when WebAppKind != linux && WebAppKind != applinux &&  WebAppKind != "". Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Alias: BuiltinLinuxPackage. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #RuntimeStack: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Runtime Stack. 
    #StartupCommand: # string. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Startup command. 
  # Output
    #WebAppUri: # string. Optional. Use when WebAppKind != "". App Service URL. 
  # Post Deployment Action
    #ScriptType: # 'Inline Script' | 'File Path'. Optional. Use when WebAppKind != "". Deployment script type. 
    #InlineScript: ':: You can provide your deployment commands here. One command per line.' # string. Required when ScriptType == Inline Script && WebAppKind != "". Inline Script. Default: :: You can provide your deployment commands here. One command per line..
    #ScriptPath: # string. Required when ScriptType == File Path && WebAppKind != "". Deployment script path. 
  # File Transforms & Variable Substitution Options
    #GenerateWebConfig: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Generate Web.config. Default: false.
    #WebConfigParameters: # string. Required when GenerateWebConfig == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Web.config parameters. 
    #enableXmlTransform: false # boolean. Alias: XmlTransformation. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML transformation. Default: false.
    #enableXmlVariableSubstitution: false # boolean. Alias: XmlVariableSubstitution. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML variable substitution. Default: false.
    #JSONFiles: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. JSON variable substitution. 
  # Application and Configuration Settings
    #AppSettings: # string. App settings. 
    #ConfigurationSettings: # string. Configuration settings. 
  # Additional Deployment Options
    #TakeAppOfflineFlag: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Take App Offline. Default: false.
    #UseWebDeploy: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Publish using Web Deploy. Default: false.
    #SetParametersFile: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". SetParameters file. 
    #RemoveAdditionalFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Remove additional files at destination. Default: false.
    #ExcludeFilesFromAppDataFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Exclude files from the App_Data folder. Default: false.
    #AdditionalArguments: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Additional arguments. 
    #RenameFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Rename locked files. Default: false.

Entradas

azureSubscription - Subscrição do Azure
Alias de entrada: ConnectedServiceName. string. Obrigatório.

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

appType - Tipo de aplicação
Alias de entrada: WebAppKind. string. Obrigatório. Valores permitidos: app (Aplicação Web), applinux (Aplicação Web do Linux), functionapp (Aplicação de Funções (Não Recomendado, Utilizar Funções do Azure Tarefa)), api (Aplicação API), mobileapp (Aplicação Móvel). Valor predefinido: app.

Especifique o tipo de aplicação Web a implementar.

Nota: especifique a Aplicação Web do Linux para imagens de plataforma incorporadas ou implementações de imagens de contentor personalizadas.

appType - Tipo de aplicação
Alias de entrada: WebAppKind. string. Obrigatório. Valores permitidos: app (Aplicação Web), applinux (Aplicação Web do Linux), functionapp (Aplicação de Funções), api (Aplicação API), mobileapp (Aplicação Móvel). Valor predefinido: app.

Especifique o tipo de aplicação Web a implementar.

Nota: especifique a Aplicação Web do Linux para imagens de plataforma incorporadas ou implementações de imagens de contentor personalizadas.

WebAppName - Serviço de Aplicações nome
string. Obrigatório.

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 quando utilizar a tarefa assistente.

DeployToSlotFlag - Implementar no bloco
boolean. Opcional. Utilize quando WebAppKind != "". Valor predefinido: false.

Utilize esta opção para implementar num bloco existente que não seja o bloco Produção. Se esta opção não estiver selecionada, o Serviço de Aplicações do Azure será implementado no bloco 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 Aplicações do Azure especificado acima.

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

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

ImageSource - Origem da Imagem
string. Opcional. Utilize quando WebAppKind = applinux || WebAppKind = linux. Valores permitidos: Registry (Container Registry), Builtin (Imagem Incorporada). Valor predefinido: Registry.

Serviço de Aplicações no Linux oferece duas opções diferentes para publicar a sua aplicação:

Implementação personalizada de imagens ou implementação de aplicações com uma imagem de plataforma incorporada.

AzureContainerRegistry - Registo
string. Necessário quando ImageSource = AzureContainerRegistry.

Um nome de domínio de nível superior globalmente exclusivo para o seu registo específico.

Nota: um nome de imagem completamente qualificado será do formato : <registry>/<repository>:.<tag> Por exemplo, myregistry.azurecr.io/nginx:latest.

AzureContainerRegistryLoginServer - Nome do Servidor de Início de Sessão do Registo
string. Opcional. Utilize quando ImageSource = invalidimagesource.

Especifique um nome de servidor de início de sessão do registo de contentores do Azure.

AzureContainerRegistryImage - Imagem
string. Necessário quando ImageSource = AzureContainerRegistry.

O nome do repositório onde as imagens de contentor são armazenadas.

Nota: um nome de imagem completamente qualificado será do formato : <registry>/<repository>:.<tag> Por exemplo, myregistry.azurecr.io/nginx:latest.

AzureContainerRegistryTag - Etiqueta
string. Opcional. Utilize quando ImageSource = AzureContainerRegistry.

Este é o mecanismo que os registos utilizam para dar uma versão às imagens do Docker.

Nota: um nome de imagem completamente qualificado será do formato : <registry>/<repository>:.<tag> Por exemplo, myregistry.azurecr.io/nginx:latest.

DockerRepositoryAccess - Acesso ao Repositório
string. Necessário quando ImageSource = invalidImage. Valores permitidos: private, public. Valor predefinido: public.

Especifique o acesso ao repositório do Docker.

dockerRegistryConnection - Ligação de Registo
Alias de entrada: RegistryConnectedServiceName. string. Necessário quando DockerRepositoryAccess = private || ImageSource = PrivateRegistry.

Especifique a ligação do registo.

PrivateRegistryImage - Imagem
string. Necessário quando ImageSource = PrivateRegistry.

O nome do repositório onde as imagens de contentor são armazenadas.

Nota: um nome de imagem completamente qualificado será do formato : <registry><repository>:<tag>. Por exemplo, myregistry.azurecr.io/nginx:latest.

PrivateRegistryTag - Etiqueta
string. Opcional. Utilize quando ImageSource = PrivateRegistry.

As etiquetas são o mecanismo que os registos utilizam para dar uma versão às imagens do Docker.

Nota: um nome de imagem completamente qualificado será do formato : "<registry>/<repository>:<tag>". Por exemplo, myregistry.azurecr.io/nginx:latest.

DockerNamespace - Registo ou Espaço de Nomes
string. Necessário quando WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Um nome de domínio de nível superior globalmente exclusivo para o seu registo ou espaço de nomes específico.

Nota: um 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 != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

O nome do repositório onde as imagens de contentor são armazenadas.

Nota: um 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 != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Este é o mecanismo que os registos utilizam para dar uma versão às imagens do Docker.

Nota: um 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 != linux && WebAppKind != applinux && WebAppKind != "".

Especifique o nome da Aplicação Virtual que foi configurada no portal do Azure. A opção não é necessária para implementações na raiz Serviço de Aplicações.

Package - Pacote ou pasta
string. Necessário quando WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valor predefinido: $(System.DefaultWorkingDirectory)/**/*.zip.

O caminho do ficheiro para o pacote ou uma pasta que contém 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. Os carateres universais são suportados.

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

packageForLinux - Pacote ou pasta
Alias de entrada: BuiltinLinuxPackage. string. Necessário quando WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Valor predefinido: $(System.DefaultWorkingDirectory)/**/*.zip.

O caminho do ficheiro para o pacote ou uma pasta que contém 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. Os carateres universais são suportados.

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

RuntimeStack - Pilha de Runtime
string. Necessário quando WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin.

Especifique a arquitetura e a versão.

StartupCommand - Comando de arranque
string. Opcional. Utilize quando WebAppKind = applinux || WebAppKind = linux.

Especifique o comando de arranque.

WebAppUri - URL do Serviço de Aplicações
string. Opcional. Utilize quando WebAppKind != "".

Especifique um nome para a variável de saída que é gerada para o URL do Serviço de Aplicações do Azure. A variável pode ser utilizada em tarefas subsequentes.

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

Personaliza a implementação ao fornecer um script que será executado no serviço Aplicação Azure AD assim que a tarefa tiver concluído a implementação com êxito. Por exemplo, isto pode restaurar pacotes para aplicações Node, PHP e Python. Saiba mais sobre Serviço de Aplicações do Azure Implementação.

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

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

GenerateWebConfig - Gerar Web.config
boolean. Opcional. Utilize quando WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Valor predefinido: false.

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 a aplicação node.js , web.config terá valores de ficheiro de arranque e iis_node módulo. Saiba mais sobre Serviço de Aplicações do Azure Implementação.

WebConfigParameters - parâmetros deWeb.config
string. Necessário quando GenerateWebConfig == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war.

Edita valores como ficheiros de arranque no ficheiro gerado web.config . 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.

Edita as definições da aplicação Web seguindo a sintaxe -key value . Os valores que contêm espaços devem estar entre aspas. Exemplos: -Port 5000-RequestTimeout 5000-WEBSITE_TIME_ZONE"Eastern Standard Time".

ConfigurationSettings - Definições de configuração
string.

Edita as definições de configuração da aplicação Web seguindo o valor da sintaxe -key . Os valores que contêm espaços devem estar entre aspas.

Exemplos: -phpVersion 5.6-linuxFxVersion: node|6.11.

TakeAppOfflineFlag - Tirar a Aplicação Offline
boolean. Opcional. Utilize quando WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valor predefinido: false.

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

UseWebDeploy - Publicar com a Implementação Web
boolean. Opcional. Utilize quando WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valor predefinido: false.

Publish using Web Deploy as opções são suportadas apenas ao utilizar o agente do Windows. Noutras plataformas, a tarefa depende das APIs REST do Kudu para implementar o Serviço de Aplicações do Azure e as seguintes opções não são suportadas.

SetParametersFile - Ficheiro SetParameters
string. Opcional. Utilize quando UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

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

RemoveAdditionalFilesFlag - Remover ficheiros adicionais no destino
boolean. Opcional. Utilize quando UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valor predefinido: false.

Utilize esta opção para eliminar ficheiros no Serviço de Aplicações do Azure que não têm ficheiros correspondentes no pacote ou pasta Serviço de Aplicações.

Nota: esta ação 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 && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valor predefinido: false.

Utilize esta 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 && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

Os argumentos adicionais de Implementação Web a seguir à sintaxe -key:value.

Estas serão aplicadas ao implementar a Serviço de Aplicações do Azure. Exemplos: -disableLink:AppPoolExtension-disableLink:ContentExtension.

Veja mais exemplos de Definições de Operação de Implementação web.

RenameFilesFlag - Mudar o nome dos ficheiros bloqueados
boolean. Opcional. Utilize quando UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valor predefinido: false.

Utilize esta opção para ativar o sinalizador MSDEPLOY_RENAME_LOCKED_FILES=1 msdeploy nas definições da aplicação Serviço de Aplicações do Azure. A opção permite ao msdeploy mudar 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 != linux && WebAppKind != applinux && WebAppKind != "" && 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 serã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áveis XML
Alias de entrada: XmlVariableSubstitution. boolean. Opcional. Utilize quando WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Valor predefinido: false.

As variáveis definidas no pipeline de compilação ou versão serão correspondidas key às entradas ou name nas appSettingssecções , applicationSettingse connectionStrings de qualquer ficheiro de configuração e parameters.xml. A Substituição de Variáveis é executada após a transformação da configuração.

Nota: se as mesmas variáveis estiverem definidas no pipeline de versão e no ambiente, as variáveis de ambiente substituirão as variáveis do pipeline de versão.

JSONFiles - Substituição de variáveis JSON
string. Opcional. Utilize quando WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war.

Fornece uma nova lista separada por linhas de ficheiros JSON para substituir os valores das variáveis. Os nomes dos ficheiros devem ser fornecidos relativamente à 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, tem de definir uma variável como Data.DefaultConnection.ConnectionString no pipeline de compilação/versão (ou no ambiente do pipeline de versão).

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

A Substituição de Variáveis é executada após a transformação da configuração.

Nota: as variáveis de pipeline são excluídas na substituição.

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

Nenhum.

Observações

Existe uma versão mais recente desta tarefa disponível. Para obter mais informações, veja AzureRmWebAppDeployment@4.

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.

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

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	Implementação

Partilhar via

AzureRmWebAppDeployment@3 - Serviço de Aplicações do Azure implementar tarefa v3

Syntax

Entradas

Opções de controlo de tarefas

Variáveis de saída

Observações

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

Requisitos

Comentários

Recursos adicionais