AzureRmWebAppDeployment@2 – Azure App Service Bereitstellen von v2-Aufgaben
Aktualisieren Sie Azure App Service mithilfe von Web Deploy / Kudu REST-APIs.
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.
Eingaben
ConnectedServiceName
- Azure-Abonnement
string
. Erforderlich.
Wählen Sie das Azure-Resource Manager-Abonnement für die Bereitstellung aus.
WebAppName
- App Service Name
string
. Erforderlich.
Geben Sie den Namen eines vorhandenen Azure App Service ein oder wählen Sie ihn aus.
DeployToSlotFlag
- Bereitstellen des Steckplatzes
boolean
. Standardwert. false
.
Wählen Sie die Option aus, um einen anderen Platz als den Produktionsplatz bereitzustellen.
ResourceGroupName
- Ressourcengruppe
string
. Erforderlich, wenn DeployToSlotFlag = true
.
Geben Sie die Azure-Ressourcengruppe ein, die die oben angegebene Azure App Service enthält.
SlotName
- Slot
string
. Erforderlich, wenn DeployToSlotFlag = true
.
Geben Sie einen vorhandenen Platz ein, oder wählen Sie einen anderen Platz als den Produktionsplatz aus.
VirtualApplication
- Virtuelle Anwendung
string
.
Geben Sie den Namen der virtuellen Anwendung an, die im Azure-Portal konfiguriert wurde. Die Option ist für Bereitstellungen für den App Service Stamm nicht erforderlich.
Package
- Paket oder Ordner
string
. Erforderlich. Standardwert. $(System.DefaultWorkingDirectory)/**/*.zip
.
Ordner oder Dateipfad zum App Service Paket oder Ordner. Variablen ( Build | Release), Wildcards werden unterstützt.
Beispielsweise $(System.DefaultWorkingDirectory)/**/*.zip.
WebAppUri
- App Service URL
string
.
Geben Sie einen Namen für die Ausgabevariable an, die für die URL der App Service generiert wird. Die Variable kann in nachfolgenden Vorgängen verbraucht werden.
UseWebDeploy
- Veröffentlichen mithilfe von Web Deploy
boolean
. Standardwert. true
.
Die Verwendung von Webbereitstellungsoptionen wird nur bei Verwendung des Windows-Agents unterstützt. Auf anderen Plattformen basiert die Aufgabe auf Kudu REST-APIs, um die App Service bereitzustellen, und die folgenden Optionen werden nicht unterstützt.
SetParametersFile
- SetParameters-Datei
string
. Optional. Verwenden Sie wann UseWebDeploy == true
.
Optional: Speicherort der zu verwendenden SetParameters.xml-Datei.
RemoveAdditionalFilesFlag
- Entfernen zusätzlicher Dateien am Ziel
boolean
. Optional. Verwenden Sie wann UseWebDeploy == true
. Standardwert. false
.
Wählen Sie die Option aus, Dateien auf dem Azure App Service zu löschen, die keine übereinstimmenden Dateien im App Service-Paket oder Ordner haben.
ExcludeFilesFromAppDataFlag
- Ausschließen von Dateien aus dem ordner App_Data
boolean
. Optional. Verwenden Sie wann UseWebDeploy == true
. Standardwert. false
.
Wählen Sie die Option aus, um Zu verhindern, dass Dateien im App_Data Ordner für die Azure App Service bereitgestellt werden.
AdditionalArguments
- Zusätzliche Argumente
string
. Optional. Verwenden Sie wann UseWebDeploy == true
.
Zusätzliche Web Deploy-Argumente nach der Syntax -key:value.
Diese werden beim Bereitstellen des Azure App Service angewendet. Beispiel: -disableLink:AppPoolExtension -disableLink:ContentExtension.
Weitere Beispiele für Web Deploy-Vorgangseinstellungen finden Sie hier.
TakeAppOfflineFlag
- Offline ausführen
boolean
. Standardwert. false
.
Wählen Sie die Option aus, um die Azure App Service offline zu nehmen, indem Sie eine app_offline.htm Datei im Stammverzeichnis der App Service platzieren, bevor der Synchronisierungsvorgang beginnt. Die Datei wird entfernt, nachdem der Synchronisierungsvorgang erfolgreich abgeschlossen wurde.
Aufgabensteuerungsoptionen
Alle Aufgaben verfügen über Steuerungsoptionen zusätzlich zu ihren Aufgabeneingaben. Weitere Informationen finden Sie unter Steuerelementoptionen und gängige Aufgabeneigenschaften.
Ausgabevariablen
Keine.
Anforderungen
Anforderung | BESCHREIBUNG |
---|---|
Pipelinetypen | YAML, Klassische Build, klassische Version |
Wird ausgeführt auf | Agent |
Forderungen | Keine |
Capabilities | Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag. |
Befehlseinschränkungen | Any |
Settable-Variablen | Any |
Agent-Version | 1.102.0 oder höher |
Aufgabenkategorie | Bereitstellen |