AzureRmWebAppDeployment@3 – tarefa implantar Serviço de Aplicativo do Azure v3

  • Artigo

Use essa tarefa para implantar em Serviço de Aplicativo do Azure um aplicativo Web, móvel ou de API usando Docker, Java, .NET, .NET Core, Node.js, PHP, Python ou Ruby.

Observação

Use AzureFunctionApp@1 para implantar aplicativos Azure Functions.

Atualize Azure App Services no Windows, aplicativo Web no Linux com imagens internas ou contêineres do Docker, ASP.NET, .NET Core, PHP, Python ou aplicativos Web baseados em Node.js, Aplicativos de Funções, Aplicativos Móveis, aplicativos de API e Trabalhos Web usando APIs REST de Implantação da 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 - Assinatura do Azure
Alias de entrada: ConnectedServiceName. string. Obrigatórios.

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


appType - Tipo de aplicativo
Alias de entrada: WebAppKind. string. Obrigatórios. Valores permitidos: app (Aplicativo Web), applinux (Aplicativo Web do Linux), functionapp (Aplicativo de Funções (Não Recomendado, Usar Azure Functions Tarefa)), api (Aplicativo de API), mobileapp (Aplicativo Móvel). Valor padrão: app.

Especifique o tipo de aplicativo Web a ser implantado.

Observação: especifique o Aplicativo Web do Linux para imagens de plataforma internas ou implantações de imagem de contêiner personalizadas.


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

Especifique o tipo de aplicativo Web a ser implantado.

Observação: especifique o Aplicativo Web do Linux para imagens de plataforma internas ou implantações de imagem de contêiner personalizadas.


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

Especifique o nome de um Serviço de Aplicativo do Azure existente. Os serviços de aplicativo com base no tipo de aplicativo selecionado só serão listados ao usar a tarefa assistente.


DeployToSlotFlag - Implantar no slot
boolean. Opcional. Use quando WebAppKind != "". Valor padrão: false.

Use essa opção para implantar em um slot existente diferente do slot de Produção. Se essa opção não estiver selecionada, o Serviço de Aplicativo do Azure será implantado no slot de Produção.


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

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


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

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


ImageSource - Origem da imagem
string. Opcional. Use quando WebAppKind = applinux || WebAppKind = linux. Valores permitidos: Registry (Registro de Contêiner), Builtin (Imagem Interna). Valor padrão: Registry.

Serviço de Aplicativo no Linux oferece duas opções diferentes para publicar seu aplicativo:

Implantação de imagem personalizada ou implantação de aplicativo com uma imagem de plataforma interna.


AzureContainerRegistry - Registro
string. Obrigatório quando ImageSource = AzureContainerRegistry.

Um nome de domínio de nível superior global exclusivo para seu registro específico.

Observação: um nome de imagem totalmente qualificado será do formato: <registry>/<repository>:.<tag> Por exemplo, myregistry.azurecr.io/nginx:latest.


AzureContainerRegistryLoginServer - Nome do Servidor de Logon do Registro
string. Opcional. Use quando ImageSource = invalidimagesource.

Especifique um nome de servidor de logon do Registro de Contêiner do Azure.


AzureContainerRegistryImage - Imagem
string. Obrigatório quando ImageSource = AzureContainerRegistry.

O nome do repositório em que as imagens de contêiner são armazenadas.

Observação: um nome de imagem totalmente qualificado será do formato: <registry>/<repository>:.<tag> Por exemplo, myregistry.azurecr.io/nginx:latest.


AzureContainerRegistryTag - Tag
string. Opcional. Use quando ImageSource = AzureContainerRegistry.

Esse é o mecanismo que os registros usam para dar uma versão às imagens do Docker.

Observação: um nome de imagem totalmente qualificado será do formato: <registry>/<repository>:.<tag> Por exemplo, myregistry.azurecr.io/nginx:latest.


DockerRepositoryAccess - Acesso ao repositório
string. Obrigatório quando ImageSource = invalidImage. Valores Permitidos: private e public. Valor padrão: public.

Especifique o acesso ao repositório do Docker.


dockerRegistryConnection - Conexão do Registro
Alias de entrada: RegistryConnectedServiceName. string. Obrigatório quando DockerRepositoryAccess = private || ImageSource = PrivateRegistry.

Especifique a conexão do Registro.


PrivateRegistryImage - Imagem
string. Obrigatório quando ImageSource = PrivateRegistry.

O nome do repositório em que as imagens de contêiner são armazenadas.

Observação: um nome de imagem totalmente qualificado será do formato: <registry><repository>:<tag>. Por exemplo, myregistry.azurecr.io/nginx:latest.


PrivateRegistryTag - Tag
string. Opcional. Use quando ImageSource = PrivateRegistry.

As marcas são o mecanismo que os registros usam para dar uma versão às imagens do Docker.

Observação: um nome de imagem totalmente qualificado será do formato: '<registry>/<repository>:<tag>'. Por exemplo, myregistry.azurecr.io/nginx:latest.


DockerNamespace - Registro ou Namespace
string. Obrigatório quando WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Um nome de domínio de nível superior global exclusivo para seu registro ou namespace específico.

Observação: um nome de imagem totalmente qualificado será do formato: <registry or namespace>/<repository>:.<tag> Por exemplo, myregistry.azurecr.io/nginx:latest.


DockerRepository - Imagem
string. Obrigatório quando WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

O nome do repositório em que as imagens de contêiner são armazenadas.

Observação: um nome de imagem totalmente qualificado será do formato: '<registry or namespace>/<repository>:.<tag> Por exemplo, myregistry.azurecr.io/nginx:latest.


DockerImageTag - Tag
string. Opcional. Use quando WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Esse é o mecanismo que os registros usam para dar uma versão às imagens do Docker.

Observação: um nome de imagem totalmente qualificado será do formato: '<registry or namespace>/<repository>:<tag>'. Por exemplo, myregistry.azurecr.io/nginx:latest.


VirtualApplication - Aplicativo virtual
string. Opcional. Use quando WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

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ório quando WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valor padrão: $(System.DefaultWorkingDirectory)/**/*.zip.

O caminho do arquivo para o pacote ou uma pasta que contém o conteúdo do serviço de aplicativo gerado pelo MSBuild ou um arquivo zip compactado ou war.

As variáveis são Build e Release. Há suporte para curingas .

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


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

O caminho do arquivo para o pacote ou uma pasta que contém o conteúdo do serviço de aplicativo gerado pelo MSBuild ou um arquivo zip compactado ou war.

As variáveis são Build e Release. Há suporte para curingas .

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


RuntimeStack - Pilha de runtime
string. Obrigatório quando WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin.

Especifique a estrutura e a versão.


StartupCommand - Comando de inicialização
string. Opcional. Use quando WebAppKind = applinux || WebAppKind = linux.

Especifique o comando de inicialização.


WebAppUri - URL do Serviço de Aplicativo
string. Opcional. Use quando WebAppKind != "".

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


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

Personaliza a implantação fornecendo um script que será executado no serviço Azure App depois que a tarefa tiver concluído a implantação com êxito. Por exemplo, isso pode restaurar pacotes para aplicativos Node, PHP e Python. Saiba mais sobre Serviço de Aplicativo do Azure Implantação.


InlineScript - Script embutido
string. Obrigatório quando ScriptType == Inline Script && WebAppKind != "". Valor padrão: :: You can provide your deployment commands here. One command per line..


ScriptPath - Caminho do script de implantação
string. Obrigatório quando ScriptType == File Path && WebAppKind != "".


GenerateWebConfig - Gerar Web.config
boolean. Opcional. Use quando WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Valor padrão: false.

Um padrão Web.config será gerado e implantado em Serviço de Aplicativo do Azure se o aplicativo não tiver um. Os valores em web.config podem ser editados e variam de acordo com a estrutura do aplicativo. Por exemplo, para o node.js aplicativo, web.config terá valores de arquivo de inicialização e iis_node módulo. Saiba mais sobre Serviço de Aplicativo do Azure Implantação.


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

Edita valores como arquivos de inicialização no arquivo gerado web.config . Esse recurso de edição é apenas para o gerado web.config. Saiba mais sobre Serviço de Aplicativo do Azure Implantação.


AppSettings - Configurações do aplicativo
string.

Edita as configurações do aplicativo Web seguindo a sintaxe -key value . Os valores que contêm espaços devem ser colocados entre aspas duplas. Exemplos: -Port 5000-RequestTimeout 5000-WEBSITE_TIME_ZONE"Eastern Standard Time".


ConfigurationSettings - Configurações
string.

Edita as configurações de aplicativo Web seguindo o valor da sintaxe -key . Os valores que contêm espaços devem ser colocados entre aspas duplas.

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


TakeAppOfflineFlag - Tirar o aplicativo offline
boolean. Opcional. Use quando WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valor padrão: false.

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


UseWebDeploy - Publicar usando a Implantação da Web
boolean. Opcional. Use quando WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valor padrão: false.

Publish using Web Deploy há suporte apenas para opções ao usar o agente do Windows. Em outras plataformas, a tarefa depende das APIs REST do Kudu para implantar o Serviço de Aplicativo do Azure e as opções a seguir não têm suporte.


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

O local do arquivo a SetParameters.xml ser usado.


RemoveAdditionalFilesFlag - Remover arquivos adicionais no destino
boolean. Opcional. Use quando UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". 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 Serviço de Aplicativo.

Observação: isso também removerá todos os arquivos relacionados a qualquer extensão instalada neste Serviço de Aplicativo do Azure. Para evitar isso, marque a Exclude files from App_Data folder caixa de seleção.


ExcludeFilesFromAppDataFlag - Excluir arquivos da pasta App_Data
boolean. Opcional. Use quando UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valor padrão: false.

Use essa opção para impedir que arquivos App_Data na pasta sejam implantados/excluídos do Serviço de Aplicativo do Azure.


AdditionalArguments - Argumentos adicionais
string. Opcional. Use quando UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

Os 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. Exemplos: -disableLink:AppPoolExtension-disableLink:ContentExtension.

Veja mais exemplos de Configurações de Operação de Implantação da Web.


RenameFilesFlag - Renomear arquivos bloqueados
boolean. Opcional. Use quando UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valor padrão: false.

Use essa opção para habilitar o sinalizador MSDEPLOY_RENAME_LOCKED_FILES=1 msdeploy em Serviço de Aplicativo do Azure configurações do aplicativo. A opção permite que msdeploy renomeie arquivos bloqueados bloqueados durante a implantação do aplicativo.


enableXmlTransform - Transformação XML
Alias de entrada: XmlTransformation. boolean. Opcional. Use quando WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Valor padrão: 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 variável.

As transformações XML têm suporte apenas para a plataforma Windows.


enableXmlVariableSubstitution - Substituição de variável XML
Alias de entrada: XmlVariableSubstitution. boolean. Opcional. Use quando WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Valor padrão: false.

As variáveis definidas no pipeline de build ou de lançamento serão correspondidas às key entradas ou name nas appSettingsseções , applicationSettingse connectionStrings de qualquer arquivo de configuração e parameters.xml. A substituição de variável é executada após transformações de configuração.

Observação: se as mesmas variáveis forem definidas no pipeline de lançamento e no ambiente, as variáveis de ambiente substituirão as variáveis de pipeline de lançamento.


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

Fornece uma nova lista separada por linhas de arquivos JSON para substituir os valores de variável. Os nomes de arquivos devem ser fornecidos em relação à pasta raiz.

Para substituir variáveis JSON aninhadas ou hierárquicas, especifique-as usando JSONPath expressões.

Por exemplo, para substituir o valor de ConnectionString no exemplo abaixo, você precisa definir uma variável como Data.DefaultConnection.ConnectionString no pipeline de build/lançamento (ou no ambiente do pipeline de lançamento).

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

A substituição de variável é executada após transformações de configuração.

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


Opções de controle da 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.

Comentários

Há uma versão mais recente dessa tarefa disponível. Para obter mais informações, consulte AzureRmWebAppDeployment@4.

Solução de problemas

Não consigo implantar na Web no meu Serviço de Aplicativo do Azure usando Microsoft Entra ID autenticação do meu agente do Windows

A tarefa de implantação Serviço de Aplicativo do Azure dá suporte à conexão com o Microsoft Azure com uma conexão de serviço arm usando Microsoft Entra ID, a menos que as três seguintes condições estejam presentes:

  • Você está usando o formato de pacote de implantação da Web em um agente do Windows
  • Seu agente está em execução com uma versão mais antiga do msdeploy.exe (por exemplo, ao usar a imagem do agente hospedado windows-2019 )
  • A autenticação básica está desabilitada para seu Serviço de Aplicativo do Azure

Se essas três condições estiverem presentes, você 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 resolve esse problema, você pode escolher entre as opções a seguir, em ordem de preferência.

  1. Atualize a imagem do agente. Se você estiver usando agentes hospedados, mova do windows-2019 para o windows-2022 (ou windows-latest). Se você estiver usando agentes auto-hospedados, instale o Visual Studio 2022 no agente para obter uma versão mais recente do msdeploy.exe.
  2. Se você depende de uma imagem de agente mais antiga e não pode atualizar o agente para seu pipeline, considere dividir o trabalho para que a tarefa de implantação do Serviço de Aplicativo do Azure seja executada no windows-2022 (ou windows-latest).
  3. Se nenhuma dessas opções for possível, você poderá habilitar a autenticação básica para seu Serviço de Aplicativo do Azure.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Executa em Agent, DeploymentGroup
Demandas Nenhum
Funcionalidades Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 2.104.1 ou superior
Categoria da tarefa Implantar