IISWebAppDeploymentOnMachineGroup@0: Iis Web App deploy v0 task
Verwenden Sie diese Aufgabe, um eine Website oder Webanwendung mithilfe von Web Deploy bereitzustellen.
Syntax
# 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.
# 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.
Eingaben
WebSiteName
- Websitename
string
. Erforderlich.
Gibt den Namen einer vorhandenen Website auf den Computergruppencomputern an.
VirtualApplication
- Virtuelle Anwendung
string
.
Gibt den Namen einer bereits vorhandenen virtuellen Azure-Anwendung auf den Zielcomputern an.
Package
- Paket oder Ordner
string
. Erforderlich. Standardwert. $(System.DefaultWorkingDirectory)\**\*.zip
.
Gibt den Dateipfad zum Paket oder Ordner an, der von MSBuild oder einer komprimierten Archivdatei generiert wurde. Variablen ( Build | release) und Wildcards werden unterstützt. Beispiel: $(System.DefaultWorkingDirectory)\**\*.zip
.
SetParametersFile
- SetParameters-Datei
string
.
Optional. Gibt den Speicherort der SetParameters.xml
zu verwendenden Datei an.
RemoveAdditionalFilesFlag
- Entfernen zusätzlicher Dateien am Ziel
boolean
. Standardwert. false
.
Wählt die Option zum Löschen von Dateien in der Web-App aus, die keine übereinstimmenden Dateien im Zip-Paket der Web-App enthalten.
ExcludeFilesFromAppDataFlag
- Ausschließen von Dateien aus dem App_Data Ordner
boolean
. Standardwert. false
.
Wählt die Option aus, um zu verhindern, dass Dateien im App_Data
Ordner in der Web-App bereitgestellt werden.
TakeAppOfflineFlag
- Offline schalten der App
boolean
. Standardwert. false
.
Wählt die Option aus, die Web-App offline zu schalten, indem eine app_offline.htm
Datei im Stammverzeichnis der Web-App abgelegt wird, bevor der Synchronisierungsvorgang beginnt. Die Datei wird entfernt, nachdem der Synchronisierungsvorgang erfolgreich abgeschlossen wurde.
AdditionalArguments
- Zusätzliche Argumente
string
.
Gibt zusätzliche Web Deploy-Argumente an, die beim Bereitstellen der Azure-Web-App angewendet werden. Zum Beispiel: -disableLink:AppPoolExtension
oder -disableLink:ContentExtension
.
Eine Liste mit Web Deploy-Argumenten finden Sie unter WebBereitstellungsvorgangseinstellungen.
XmlTransformation
- XML-Transformation
boolean
. Standardwert. false
.
Gibt die Konfigurationstransformationen an, die für *.Release.config
und *.<EnvironmentName>.config
für *.config file
ausgeführt werden. Konfigurationstransformationen werden vor der Variablenersetzung ausgeführt. XML-Transformationen werden nur unter Windows unterstützt.
XmlVariableSubstitution
- Ersetzung von XML-Variablen
boolean
. Standardwert. false
.
Gibt die variablen an, die in der Build- oder Releasepipeline definiert sind. Diese Variablen werden mit den key
Einträgen oder name
in den Abschnitten appSettings, applicationSettings und connectionStrings jeder Konfigurationsdatei und parameters.xml
abgeglichen. Variablenersetzung wird nach Konfigurationstransformationen ausgeführt.
Hinweis: Wenn dieselben Variablen in der Releasepipeline und in der Umgebung definiert sind, ersetzen die Umgebungsvariablen die Releasepipelinevariablen.
JSONFiles
- JSON-Variablenersetzung
string
.
Gibt eine neue zeilentrennte Liste von JSON-Dateien an, um die Variablenwerte zu ersetzen. Dateinamen müssen relativ zum Stammordner sein.
Um JSON-Variablen zu ersetzen, die geschachtelt oder hierarchisch sind, geben Sie sie mithilfe von JSONPath-Ausdrücken an. Um beispielsweise den Wert von ConnectionString
im folgenden Beispiel zu ersetzen, müssen Sie eine Variable wie Data.DefaultConnection.ConnectionString
in der Build- oder Releasepipeline (oder in der Phase der Releasepipeline) definieren.
{
"Data": {
"DefaultConnection": {
"ConnectionString": "Server=(localdb)\SQLEXPRESS;Database=MyDB;Trusted_Connection=True"
}
}
}
Variablenersetzung wird nach Konfigurationstransformationen ausgeführt.
Hinweis: Pipelinevariablen werden bei der Ersetzung ausgeschlossen.
Optionen für die Vorgangskontrolle
Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.
Ausgabevariablen
Keine.
Bemerkungen
Verwenden Sie diese Aufgabe, um eine Website oder Web-App mithilfe von WebDeploy bereitzustellen.
Anforderungen
Anforderung | BESCHREIBUNG |
---|---|
Pipelinetypen | Klassische Version |
Wird ausgeführt auf | Agent, DeploymentGroup |
Forderungen | Keine |
Capabilities | Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag. |
Befehlseinschränkungen | Any |
Einstellbare Variablen | Any |
Agent-Version | 2.104.1 oder höher |
Aufgabenkategorie | Bereitstellen |
Anforderung | BESCHREIBUNG |
---|---|
Pipelinetypen | Klassische Version |
Wird ausgeführt auf | DeploymentGroup |
Forderungen | Keine |
Capabilities | Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag. |
Befehlseinschränkungen | Any |
Einstellbare Variablen | Any |
Agent-Version | 2.104.1 oder höher |
Aufgabenkategorie | Bereitstellen |