AzureRmWebAppDeployment@2 – Azure App Service Deploy v2-Aufgabe

Artikel
03/24/2025

Verwenden Sie diese Aufgabe, um Azure App Service mithilfe von Web Deploy/Kudu REST-APIszu aktualisieren.

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.

Eingänge

ConnectedServiceName - Azure-Abonnement-
string. Erforderlich.

Geben Sie das Azure Resource Manager-Abonnement für die Bereitstellung an.

WebAppName - App Service-Name
string. Erforderlich.

Geben Sie den Namen eines vorhandenen Azure App Service an.

DeployToSlotFlag - Bereitstellen für Steckplatz-
boolean. Standardwert: false.

Verwenden Sie diese Option, um einen anderen Platz als den Produktionsplatz bereitzustellen.

ResourceGroupName - Ressourcengruppe
string. Erforderlich, wenn DeployToSlotFlag = true.

Geben Sie die Azure-Ressourcengruppe an, die den oben angegebenen Azure App Service enthält.

SlotName - Slot-
string. Erforderlich, wenn DeployToSlotFlag = true.

Geben Sie einen anderen Steckplatz als den Produktionsplatz an.

VirtualApplication - virtual application
string.

Geben Sie den Namen der virtuellen Anwendung an, die im Azure-Portal konfiguriert wurde. Die Option ist für Bereitstellungen im App Service-Stamm nicht erforderlich.

Package - Paket- oder Ordner-
string. Erforderlich. Standardwert: $(System.DefaultWorkingDirectory)/**/*.zip.

Der Ordner oder Dateipfad zum App Service-Paket oder -Ordner. Variablen umfassen Build- und Release-. werden von Wildcards unterstützt.

Beispiel: $(System.DefaultWorkingDirectory)/\*\*/\*.zip.

WebAppUri - App Service-URL
string.

Geben Sie einen Namen für die Ausgabevariable an, die für die URL des App-Diensts generiert wird. Die Variable kann in nachfolgenden Vorgängen verwendet werden.

UseWebDeploy - Veröffentlichen mithilfe von Web Deploy
boolean. Standardwert: true.

Publish using web deploy Optionen werden nur bei Verwendung eines Windows-Agents unterstützt. Auf anderen Plattformen basiert die Aufgabe auf Kudu-REST-APIs zum Bereitstellen des App-Diensts, und die folgenden Optionen werden nicht unterstützt.

SetParametersFile - SetParameters File
string. Wahlfrei. Wird verwendet, wenn UseWebDeploy == true.

Geben Sie den Speicherort der zu verwendenden SetParameters.xml Datei an.

RemoveAdditionalFilesFlag - Entfernen zusätzlicher Dateien am Ziel
boolean. Wahlfrei. Wird verwendet, wenn UseWebDeploy == true. Standardwert: false.

Verwenden Sie diese Option, um Dateien im Azure App Service zu löschen, die keine übereinstimmenden Dateien im App Service-Paket oder -Ordner enthalten.

ExcludeFilesFromAppDataFlag - Dateien aus dem App_Data Ordner ausschließen
boolean. Wahlfrei. Wird verwendet, wenn UseWebDeploy == true. Standardwert: false.

Schließen Sie Dateien im Ordner App_Data von der Bereitstellung im Azure App Service aus.

AdditionalArguments - zusätzliche Argumente
string. Wahlfrei. Wird verwendet, wenn 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.

Erfahren Sie mehr über Web Deploy-Vorgangseinstellungen.

TakeAppOfflineFlag - App offline
boolean. Standardwert: false.

Verwenden Sie diese Option, um den Azure App Service offline zu schalten, indem Sie eine app_offline.htm Datei im Stammverzeichnis des App-Diensts platzieren, bevor der Synchronisierungsvorgang beginnt. Die Datei wird entfernt, nachdem der Synchronisierungsvorgang erfolgreich abgeschlossen wurde.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	1.102.0 oder höher
Vorgangskategorie	Einsetzen

Teilen über