Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 true
en , 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 true
en , 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 appSettings
secciones , applicationSettings
y 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 |