Compartir a través de


IISWebAppDeploymentOnMachineGroup@0: tarea de implementación de la aplicación web de IIS v0

Use esta tarea para implementar un sitio web o una aplicación web mediante Web Deploy.

Importante

Esta tarea solo funciona con canalizaciones clásicas. Use la implementación de aplicaciones web de IIS mediante WinRM - Visual Studio Marketplace en su lugar.

Sintaxis

# IIS web app deploy v0
# Deploy a website or web application using Web Deploy.
- task: IISWebAppDeploymentOnMachineGroup@0
  inputs:
    WebSiteName: # string. Required. Website Name. 
    #VirtualApplication: # string. Virtual Application. 
    Package: '$(System.DefaultWorkingDirectory)\**\*.zip' # string. Required. Package or Folder. Default: $(System.DefaultWorkingDirectory)\**\*.zip.
  # Advanced Deployment Options
    #SetParametersFile: # string. SetParameters File. 
    #RemoveAdditionalFilesFlag: false # boolean. Remove Additional Files at Destination. Default: false.
    #ExcludeFilesFromAppDataFlag: false # boolean. Exclude Files from the App_Data Folder. Default: false.
    #TakeAppOfflineFlag: false # boolean. Take App Offline. Default: false.
    #AdditionalArguments: # string. Additional Arguments. 
  # File Transforms & Variable Substitution Options
    #XmlTransformation: false # boolean. XML transformation. Default: false.
    #XmlVariableSubstitution: false # boolean. XML variable substitution. Default: false.
    #JSONFiles: # string. JSON variable substitution.

Entradas

WebSiteName - Nombre del sitio web
string. Obligatorio.

Especifica el nombre de un sitio web existente en las máquinas del grupo de máquinas.


VirtualApplication - Aplicación virtual
string.

Especifica el nombre de una aplicación virtual de Azure existente en las máquinas de destino.


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

Especifica la ruta de acceso del archivo al paquete o carpeta generado por MSBuild o a un archivo de archivo comprimido. Se admiten variables ( versión | de compilación) y caracteres comodín.


SetParametersFile - Archivo SetParameters
string.

Especifica la ruta de acceso al SetParameters.xml archivo que se va a usar.


RemoveAdditionalFilesFlag - Quitar archivos adicionales en el destino
boolean. Valor predeterminado: false.

Si se establece trueen , elimina los archivos de la aplicación web que no tienen archivos coincidentes en el paquete ZIP de aplicación web.


ExcludeFilesFromAppDataFlag - Excluir archivos de la carpeta App_Data
boolean. Valor predeterminado: false.

Si se establece trueen , esto impide que los archivos de la App_Data carpeta se implementen en la aplicación web.


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

Selecciona la opción para desconectar la aplicación web colocando un app_offline.htm archivo en su directorio raíz antes de que comience la operación de sincronización. El archivo se quita automáticamente después de que la operación de sincronización se complete correctamente.


AdditionalArguments - Argumentos adicionales
string.

Especifica argumentos adicionales de Web Deploy que se usarán al implementar la aplicación web de Azure. Por ejemplo, -disableLink:AppPoolExtension o -disableLink:ContentExtension.

Para obtener una lista completa de los argumentos admitidos, consulte Configuración de operación de implementación web.


XmlTransformation - de transformación XML
boolean. Valor predeterminado: false.

Ejecuta transformaciones XML para *.Release.config los archivos y *.<EnvironmentName>.config en el objeto correspondiente *.config file. Estas transformaciones se aplican antes de la sustitución de variables. Las transformaciones XML solo se admiten en Windows.


XmlVariableSubstitution - de sustitución de variables XML
boolean. Valor predeterminado: false.

Especifica las variables definidas en la canalización de compilación o versión. Estas variables se comparan con las key entradas o name de las appSettingssecciones , applicationSettingsy connectionStrings de cualquier archivo de configuración y parameters.xml. La sustitución de variables se realiza después de las transformaciones de configuración.

Nota:

Si se definen las mismas variables tanto en la canalización de versión como en el entorno, las variables de entorno tendrán prioridad sobre las variables de canalización de versión.


JSONFiles - de sustitución de variables JSON
string.

Especifica una nueva lista separada por líneas de archivos JSON para la sustitución de variables. Los nombres de archivo deben ser relativos a la carpeta raíz.

Para sustituir variables JSON anidadas o jerárquicas, use expresiones JSONPath. Por ejemplo, para reemplazar el valor de ConnectionString en el ejemplo siguiente, defina una variable como Data.DefaultConnection.ConnectionString en la canalización de compilación o versión (o en la fase de la canalización de versión).

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

La sustitución de variables se ejecuta después de las transformaciones de configuración y las variables de canalización se excluyen de la sustitución.


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, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Observaciones

Use esta tarea para implementar un sitio web o una aplicación web mediante WebDeploy.

Ejemplos

Requisitos

Requisito Descripción
Tipos de canalización Versión clásica
Se ejecuta en Agente, DeploymentGroup
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 2.104.1 o superior
Categoría de tarea Desplegar