AzureRmWebAppDeployment@2: tarea implementar v2 de Azure App Service

Artículo
01/27/2024

Actualice Azure App Service mediante las API REST de Web Deploy y Kudu.

Syntax

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

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

Entradas

ConnectedServiceName - Suscripción de Azure
string. Obligatorio.

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

WebAppName - nombre de App Service
string. Obligatorio.

Escriba o seleccione el nombre de un Azure App Service existente.

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

Seleccione la opción para implementar en una ranura existente que no sea la ranura producción.

ResourceGroupName - Grupo de recursos
string. Obligatorio cuando DeployToSlotFlag = true.

Escriba o seleccione el grupo de recursos de Azure que contiene el Azure App Service especificado anteriormente.

SlotName - Ranura
string. Obligatorio cuando DeployToSlotFlag = true.

Escriba o seleccione 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 el 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 App Service. Se admiten variables (versión de compilación | ), 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 del App Service. La variable se puede consumir en tareas posteriores.

UseWebDeploy - Publicación mediante Web Deploy
boolean. Valor predeterminado: true.

La publicación mediante opciones de implementación web solo se admite cuando se usa el agente de Windows. En otras plataformas, la tarea se basa en las API REST de Kudu para implementar el App Service y no se admiten las siguientes opciones.

SetParametersFile - Archivo SetParameters
string. Opcional. Use cuando UseWebDeploy == true.

Opcional: ubicación del archivo SetParameters.xml que se va a usar.

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

Seleccione la opción para eliminar archivos en el Azure App Service que no tengan archivos coincidentes en el paquete o la carpeta App Service.

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

Seleccione la opción para evitar que los archivos de la carpeta App_Data se implementen en el Azure App Service.

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

Argumentos adicionales de Web Deploy después de la sintaxis -key:value.
Se aplicarán al implementar el Azure App Service. Ejemplo: -disableLink:AppPoolExtension -disableLink:ContentExtension.
Para obtener más ejemplos de configuración de operaciones de Web Deploy, consulte esto.

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

Seleccione la opción para desconectar el Azure App Service colocando un archivo app_offline.htm en el directorio raíz del 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 tareas. Para obtener más información, vea 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
Peticiones	Ninguno
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	1.102.0 o posterior
Categoría de la tarea:	Implementación

Compartir vía