IISWebAppDeploymentOnMachineGroup@0 - Tâche de déploiement d’application web IIS v0

Utilisez cette tâche pour déployer un site web ou une application web à l’aide de Web Deploy.

Syntaxe

# 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.

Entrées

WebSiteName - Nom du site web
string. Obligatoire.

Spécifie le nom d’un site web existant sur les machines du groupe d’ordinateurs.

VirtualApplication - Application virtuelle
string.

Spécifie le nom d’une application Azure Virtual déjà existante sur les machines cibles.

Package - Package ou dossier
string. Obligatoire. Valeur par défaut : $(System.DefaultWorkingDirectory)\**\*.zip.

Spécifie le chemin du fichier vers le package ou le dossier généré par MSBuild ou un fichier d’archive compressé. Les variables ( Build | Release) et les caractères génériques sont pris en charge. Par exemple : $(System.DefaultWorkingDirectory)\**\*.zip.

SetParametersFile - Fichier SetParameters
string.

facultatif. Spécifie l’emplacement du SetParameters.xml fichier à utiliser.

RemoveAdditionalFilesFlag - Supprimer des fichiers supplémentaires à la destination
boolean. Valeur par défaut : false.

Sélectionne l’option permettant de supprimer les fichiers sur l’application web qui n’ont aucun fichier correspondant dans le package zip d’application web.

ExcludeFilesFromAppDataFlag - Exclure des fichiers du dossier App_Data
boolean. Valeur par défaut : false.

Sélectionne l’option permettant d’empêcher le déploiement des fichiers dans le App_Data dossier sur l’application web.

TakeAppOfflineFlag - Mise hors connexion de l’application
boolean. Valeur par défaut : false.

Sélectionne l’option permettant de mettre l’application web hors connexion en plaçant un app_offline.htm fichier dans le répertoire racine de l’application web avant le début de l’opération de synchronisation. Le fichier sera supprimé une fois l’opération de synchronisation terminée.

AdditionalArguments - Arguments supplémentaires
string.

Spécifie des arguments Web Deploy supplémentaires qui sont appliqués lors du déploiement de l’application web Azure. Par exemple, -disableLink:AppPoolExtension ou -disableLink:ContentExtension.

Pour obtenir la liste des arguments Web Deploy, consultez Paramètres de l’opération Web Deploy.

XmlTransformation - Transformation XML
boolean. Valeur par défaut : false.

Spécifie les transformations de configuration exécutées pour *.Release.config et *.<EnvironmentName>.config sur .*.config file Les transformations de configuration sont exécutées avant la substitution de variable. Les transformations XML sont uniquement prises en charge sur Windows.

XmlVariableSubstitution - Substitution de variable XML
boolean. Valeur par défaut : false.

Spécifie les variables définies dans le pipeline de build ou de mise en production. Ces variables sont mises en correspondance avec les key entrées ou name dans les sections appSettings, applicationSettings et connectionStrings de tout fichier de configuration et parameters.xml. La substitution de variable est exécutée après les transformations de configuration.

Note: Si les mêmes variables sont définies dans le pipeline de mise en production et dans l’environnement, les variables d’environnement remplacent les variables de pipeline de mise en production.

JSONFiles - Substitution de variable JSON
string.

Spécifie une nouvelle liste de fichiers JSON séparés par des lignes pour remplacer les valeurs de variable. Les noms de fichiers doivent être relatifs au dossier racine.

Pour remplacer les variables JSON imbriquées ou hiérarchiques, spécifiez-les avec des expressions JSONPath. Par exemple, pour remplacer la valeur de ConnectionString dans l’exemple ci-dessous, vous devez définir une variable comme Data.DefaultConnection.ConnectionString dans le pipeline de build ou de mise en production (ou à l’étape du pipeline de mise en production).

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

La substitution de variable est exécutée après les transformations de configuration.

Note: Les variables de pipeline sont exclues en substitution.

Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Notes

Utilisez cette tâche pour déployer un site web ou une application web à l’aide de WebDeploy.

Configuration requise

Condition requise	Description
Types de pipelines	Version classique
S’exécute sur	Agent, DeploymentGroup
Demandes	Aucun
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commande	Quelconque
Variables paramétrables	Quelconque
Version de l’agent	2.104.1 ou version ultérieure
Catégorie de la tâche	Déployer