AzureRmWebAppDeployment@2: tarea Implementación de Azure App Service v2

Artículo
2025-03-24

Use esta tarea para actualizar Azure App Service mediante Web Deploy/API rest de Kudu.

Sintaxis

# Azure App Service deploy v2
# Update Azure App Service using Web Deploy / Kudu REST APIs.
- task: AzureRmWebAppDeployment@2
  inputs:
    ConnectedServiceName: # string. Required. Azure Subscription. 
    WebAppName: # string. Required. App Service name. 
    #DeployToSlotFlag: false # boolean. Deploy to slot. Default: false.
    #ResourceGroupName: # string. Required when DeployToSlotFlag = true. Resource group. 
    #SlotName: # string. Required when DeployToSlotFlag = true. Slot. 
    #VirtualApplication: # string. Virtual Application. 
    Package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or Folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
  # Output
    #WebAppUri: # string. App Service URL. 
  # Additional Deployment Options
    #UseWebDeploy: true # boolean. Publish using Web Deploy. Default: true.
    #SetParametersFile: # string. Optional. Use when UseWebDeploy == true. SetParameters File. 
    #RemoveAdditionalFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true. Remove Additional Files at Destination. Default: false.
    #ExcludeFilesFromAppDataFlag: false # boolean. Optional. Use when UseWebDeploy == true. Exclude Files from the App_Data Folder. Default: false.
    #AdditionalArguments: # string. Optional. Use when UseWebDeploy == true. Additional Arguments. 
    #TakeAppOfflineFlag: false # boolean. Take App Offline. Default: false.

Entradas

ConnectedServiceName - de suscripción de Azure
string. Obligatorio.

Especifique la suscripción de Azure Resource Manager para la implementación.

WebAppName - nombre de App Service
string. Obligatorio.

Especifique el nombre de una instancia de Azure App Service existente.

DeployToSlotFlag - Implementación en ranuras
boolean. Valor predeterminado: false.

Use esta opción para implementar en una ranura existente distinta de la ranura producción.

del grupo de recursos de ResourceGroupName -
string. Obligatorio cuando DeployToSlotFlag = true.

Especifique el grupo de recursos de Azure que contiene azure App Service especificado anteriormente.

de ranura de
string. Obligatorio cuando DeployToSlotFlag = true.

Especifique una ranura existente que no sea la ranura producción.

VirtualApplication - aplicación virtual
string.

Especifique el nombre de la aplicación virtual que se ha configurado en Azure Portal. La opción no es necesaria para las implementaciones en la raíz de App Service.

Package - paquete o carpeta
string. Obligatorio. Valor predeterminado: $(System.DefaultWorkingDirectory)/**/*.zip.

Ruta de acceso de carpeta o archivo al paquete o carpeta de App Service. Las variables incluyen build y release. se admiten caracteres comodín.

Por ejemplo: $(System.DefaultWorkingDirectory)/\*\*/\*.zip.

WebAppUri - dirección URL de App Service
string.

Especifique un nombre para la variable de salida que se genera para la dirección URL de App Service. La variable se puede usar en tareas posteriores.

UseWebDeploy - Publicar mediante web Deploy
boolean. Valor predeterminado: true.

Publish using web deploy opciones solo se admiten cuando se usa un agente de Windows. En otras plataformas, la tarea se basa en API rest de Kudu para implementar App Service y no se admiten las siguientes opciones.

archivo SetParameters de SetParametersFile -
string. Opcional. Use cuando UseWebDeploy == true.

Especifique la ubicación del archivo SetParameters.xml que se va a usar.

RemoveAdditionalFilesFlag - quitar archivos adicionales en el de destino
boolean. Opcional. Use cuando UseWebDeploy == true. Valor predeterminado: false.

Use esta opción para eliminar archivos en Azure App Service que no tengan archivos coincidentes en el paquete o carpeta de App Service.

ExcludeFilesFromAppDataFlag - excluir archivos de la carpeta de App_Data
boolean. Opcional. Use cuando UseWebDeploy == true. Valor predeterminado: false.

Excluya los archivos de la carpeta App_Data de la implementación en Azure App Service.

AdditionalArguments - argumentos adicionales
string. Opcional. Use cuando UseWebDeploy == true.

Argumentos adicionales de Web Deploy siguiendo la sintaxis -key:value.

Se aplicarán al implementar Azure App Service. Ejemplo: -disableLink:AppPoolExtension-disableLink:ContentExtension.

Obtenga más información sobre configuración de la operación Web Deploy.

TakeAppOfflineFlag - desconectar la aplicación
boolean. Valor predeterminado: false.

Use esta opción para desconectar Azure App Service colocando un archivo app_offline.htm en el directorio raíz de App Service antes de que comience la operación de sincronización. El archivo se quitará después de que la operación de sincronización se complete correctamente.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, consulte Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente
demandas	Ninguno
funcionalidades de	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos	Cualquiera
variables settable	Cualquiera
Versión del agente	1.102.0 o superior
Categoría de tarea	Desplegar

Compartir a través de