AzureRmWebAppDeployment@3 – Azure App Service v3-Aufgabe bereitstellen

Artikel
03/24/2025

Verwenden Sie diese Aufgabe, um eine Web-, Mobile- oder API-App mit Docker, Java, .NET, .NET Core, Node.js, PHP, Python oder Ruby in Azure App Service bereitzustellen.

Diese Version der Aufgabe ist veraltet; verwenden Sie AzureRmWebAppDeployment@4, um die neuesten Features wie Workload Identity Federationzu nutzen.

Hinweis

Verwenden Sie AzureFunctionApp@1, um Azure Functions-Apps bereitzustellen.

Verwenden Sie diese Aufgabe, um eine Web-, Mobile- oder API-App mit Docker, Java, .NET, .NET Core, Node.js, PHP, Python oder Ruby in Azure App Service bereitzustellen.

Hinweis

Verwenden Sie AzureFunctionApp@1, um Azure Functions-Apps bereitzustellen.

Syntax

# Azure App Service deploy v3
# Deploy to Azure App Service a web, mobile, or API app using Docker, Java, .NET, .NET Core, Node.js, PHP, Python, or Ruby.
- task: AzureRmWebAppDeployment@3
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    appType: 'app' # 'app' | 'applinux' | 'functionapp' | 'api' | 'mobileapp'. Alias: WebAppKind. Required. App type. Default: app.
    WebAppName: # string. Required. App Service name. 
    #DeployToSlotFlag: false # boolean. Optional. Use when WebAppKind != "". Deploy to slot. Default: false.
    #ResourceGroupName: # string. Required when DeployToSlotFlag = true. Resource group. 
    #SlotName: # string. Required when DeployToSlotFlag = true. Slot. 
    #ImageSource: 'Registry' # 'Registry' | 'Builtin'. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Image Source. Default: Registry.
    #AzureContainerRegistry: # string. Required when ImageSource = AzureContainerRegistry. Registry. 
    #AzureContainerRegistryLoginServer: # string. Optional. Use when ImageSource = invalidimagesource. Registry Login Server Name. 
    #AzureContainerRegistryImage: # string. Required when ImageSource = AzureContainerRegistry. Image. 
    #AzureContainerRegistryTag: # string. Optional. Use when ImageSource = AzureContainerRegistry. Tag. 
    #DockerRepositoryAccess: 'public' # 'private' | 'public'. Required when ImageSource = invalidImage. Repository Access. Default: public.
    #dockerRegistryConnection: # string. Alias: RegistryConnectedServiceName. Required when DockerRepositoryAccess = private || ImageSource = PrivateRegistry. Registry Connection. 
    #PrivateRegistryImage: # string. Required when ImageSource = PrivateRegistry. Image. 
    #PrivateRegistryTag: # string. Optional. Use when ImageSource = PrivateRegistry. Tag. 
    #DockerNamespace: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Registry or Namespace. 
    #DockerRepository: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Image. 
    #DockerImageTag: # string. Optional. Use when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Tag. 
    #VirtualApplication: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Virtual application. 
    #Package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required when WebAppKind != linux && WebAppKind != applinux &&  WebAppKind != "". Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Alias: BuiltinLinuxPackage. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #RuntimeStack: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Runtime Stack. 
    #StartupCommand: # string. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Startup command. 
  # Output
    #WebAppUri: # string. Optional. Use when WebAppKind != "". App Service URL. 
  # Post Deployment Action
    #ScriptType: # 'Inline Script' | 'File Path'. Optional. Use when WebAppKind != "". Deployment script type. 
    #InlineScript: ':: You can provide your deployment commands here. One command per line.' # string. Required when ScriptType == Inline Script && WebAppKind != "". Inline Script. Default: :: You can provide your deployment commands here. One command per line..
    #ScriptPath: # string. Required when ScriptType == File Path && WebAppKind != "". Deployment script path. 
  # File Transforms & Variable Substitution Options
    #GenerateWebConfig: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Generate Web.config. Default: false.
    #WebConfigParameters: # string. Required when GenerateWebConfig == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Web.config parameters. 
    #enableXmlTransform: false # boolean. Alias: XmlTransformation. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML transformation. Default: false.
    #enableXmlVariableSubstitution: false # boolean. Alias: XmlVariableSubstitution. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML variable substitution. Default: false.
    #JSONFiles: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. JSON variable substitution. 
  # Application and Configuration Settings
    #AppSettings: # string. App settings. 
    #ConfigurationSettings: # string. Configuration settings. 
  # Additional Deployment Options
    #TakeAppOfflineFlag: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Take App Offline. Default: false.
    #UseWebDeploy: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Publish using Web Deploy. Default: false.
    #SetParametersFile: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". SetParameters file. 
    #RemoveAdditionalFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Remove additional files at destination. Default: false.
    #ExcludeFilesFromAppDataFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Exclude files from the App_Data folder. Default: false.
    #AdditionalArguments: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Additional arguments. 
    #RenameFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Rename locked files. Default: false.

Eingänge

azureSubscription - Azure-Abonnement
Eingabealias: ConnectedServiceName. string. Erforderlich.

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

appType - App-Typ
Eingabealias: WebAppKind. string. Erforderlich. Zulässige Werte: app (Web App), applinux (Linux Web App), functionapp (Funktions-App (Nicht empfohlen, Azure-Funktionen-Aufgabe verwenden)), api (API-App), mobileapp (Mobile App). Standardwert: app.

Geben Sie den Typ der bereitzustellenden Web-App an.

Hinweis: Geben Sie Linux Web App für integrierte Plattformimages oder benutzerdefinierte Containerimagebereitstellungen an.

appType - App-Typ
Eingabealias: WebAppKind. string. Erforderlich. Zulässige Werte: app (Web App), applinux (Linux Web App), functionapp (Funktions-App), api (API-App), mobileapp (Mobile App). Standardwert: app.

Geben Sie den Typ der bereitzustellenden Web-App an.

Hinweis: Geben Sie Linux Web App für integrierte Plattformimages oder benutzerdefinierte Containerimagebereitstellungen an.

WebAppName - App Service-Name
string. Erforderlich.

Geben Sie den Namen eines vorhandenen Azure App Service an. App-Dienste, die auf dem ausgewählten App-Typ basieren, werden nur bei Verwendung des Aufgaben-Assistenten aufgelistet.

DeployToSlotFlag - Bereitstellen für Steckplatz-
boolean. Wahlfrei. Wird verwendet, wenn WebAppKind != "". Standardwert: false.

Verwenden Sie diese Option, um einen anderen Platz als den Produktionsplatz bereitzustellen. Wenn diese Option nicht ausgewählt ist, wird der Azure App Service im Produktionsplatz bereitgestellt.

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.

ImageSource - Bildquelle
string. Wahlfrei. Wird verwendet, wenn WebAppKind = applinux || WebAppKind = linux. Zulässige Werte: Registry (Containerregistrierung), Builtin (integriertes Image). Standardwert: Registry.

App Service unter Linux bietet zwei verschiedene Optionen zum Veröffentlichen Ihrer Anwendung:

Benutzerdefinierte Imagebereitstellung oder App-Bereitstellung mit einem integrierten Plattformimage.

AzureContainerRegistry - Registrierungs-
string. Erforderlich, wenn ImageSource = AzureContainerRegistry.

Ein global eindeutiger Domänenname auf oberster Ebene für Ihre spezifische Registrierung.

Hinweis: Ein vollqualifizierter Bildname hat das Format: <registry>/<repository>:<tag>. Beispiel: myregistry.azurecr.io/nginx:latest.

AzureContainerRegistryLoginServer - Registrierungsanmeldungsservername
string. Wahlfrei. Wird verwendet, wenn ImageSource = invalidimagesource.

Geben Sie einen Azure-Containerregistrierungs-Anmeldeservernamen an.

AzureContainerRegistryImage - Bild-
string. Erforderlich, wenn ImageSource = AzureContainerRegistry.

Der Name des Repositorys, in dem die Containerimages gespeichert sind.

Hinweis: Ein vollqualifizierter Bildname hat das Format: <registry>/<repository>:<tag>. Beispiel: myregistry.azurecr.io/nginx:latest.

AzureContainerRegistryTag - Tag-
string. Wahlfrei. Wird verwendet, wenn ImageSource = AzureContainerRegistry.

Dies ist der Mechanismus, mit dem Die Registrierungen verwenden, um Docker-Images eine Version zu geben.

Hinweis: Ein vollqualifizierter Bildname hat das Format: <registry>/<repository>:<tag>. Beispiel: myregistry.azurecr.io/nginx:latest.

DockerRepositoryAccess - Repositoryzugriff
string. Erforderlich, wenn ImageSource = invalidImage. Zulässige Werte: private, public. Standardwert: public.

Geben Sie den Docker-Repositoryzugriff an.

dockerRegistryConnection - Registrierungsverbindung
Eingabealias: RegistryConnectedServiceName. string. Erforderlich, wenn DockerRepositoryAccess = private || ImageSource = PrivateRegistry.

Geben Sie die Registrierungsverbindung an.

PrivateRegistryImage - Bild-
string. Erforderlich, wenn ImageSource = PrivateRegistry.

Der Name des Repositorys, in dem die Containerimages gespeichert sind.

Hinweis: Ein vollqualifizierter Bildname hat das Format: <registry><repository>:<tag>. Beispiel: myregistry.azurecr.io/nginx:latest.

PrivateRegistryTag - Tag-
string. Wahlfrei. Wird verwendet, wenn ImageSource = PrivateRegistry.

Tags sind der Mechanismus, mit dem Registrierungen Docker-Images eine Version zugeben.

Hinweis: Ein vollqualifizierter Bildname hat das Format : '<registry>/<repository>:<tag>'. Beispiel: myregistry.azurecr.io/nginx:latest.

DockerNamespace - Registrierungs- oder Namespace-
string. Erforderlich, wenn WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Ein global eindeutiger Domänenname auf oberster Ebene für Ihre spezifische Registrierung oder Ihren Namespace.

Hinweis: Ein vollqualifizierter Bildname hat das Format: <registry or namespace>/<repository>:<tag>. Beispiel: myregistry.azurecr.io/nginx:latest.

DockerRepository - Bild-
string. Erforderlich, wenn WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Der Name des Repositorys, in dem die Containerimages gespeichert sind.

Hinweis: Ein vollqualifizierter Bildname hat das Format : '<registry or namespace>/<repository>:<tag>. Beispiel: myregistry.azurecr.io/nginx:latest.

DockerImageTag - Tag-
string. Wahlfrei. Wird verwendet, wenn WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Dies ist der Mechanismus, mit dem Die Registrierungen verwenden, um Docker-Images eine Version zu geben.

Hinweis: Ein vollqualifizierter Bildname hat das Format : '<registry or namespace>/<repository>:<tag>'. Beispiel: myregistry.azurecr.io/nginx:latest.

VirtualApplication - virtuelle Anwendung
string. Wahlfrei. Wird verwendet, wenn WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

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, wenn WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Standardwert: $(System.DefaultWorkingDirectory)/**/*.zip.

Der Dateipfad zum Paket oder einen Ordner mit App-Dienstinhalten, die von MSBuild oder einer komprimierten ZIP- oder War-Datei generiert werden.

Variablen sind Build und Release. werden von Wildcards unterstützt.

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

packageForLinux - Paket- oder Ordner-
Eingabealias: BuiltinLinuxPackage. string. Erforderlich, wenn WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Standardwert: $(System.DefaultWorkingDirectory)/**/*.zip.

Der Dateipfad zum Paket oder einen Ordner mit App-Dienstinhalten, die von MSBuild oder einer komprimierten ZIP- oder War-Datei generiert werden.

Variablen sind Build und Release. werden von Wildcards unterstützt.

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

RuntimeStack - Runtime Stack
string. Erforderlich, wenn WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin.

Geben Sie das Framework und die Version an.

StartupCommand - Startbefehl
string. Wahlfrei. Wird verwendet, wenn WebAppKind = applinux || WebAppKind = linux.

Geben Sie den Startbefehl an.

WebAppUri - App Service-URL
string. Wahlfrei. Wird verwendet, wenn WebAppKind != "".

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

ScriptType - Bereitstellungsskripttyp
string. Wahlfrei. Wird verwendet, wenn WebAppKind != "". Zulässige Werte: Inline Script, File Path (Skriptdateipfad).

Passt die Bereitstellung an, indem ein Skript bereitgestellt wird, das auf dem Azure App-Dienst ausgeführt wird, nachdem die Aufgabe die Bereitstellung erfolgreich abgeschlossen hat. Dies kann beispielsweise Pakete für Node-, PHP- und Python-Anwendungen wiederherstellen. Erfahren Sie mehr über Azure App Service Deployment.

InlineScript - Inlineskript-
string. Erforderlich, wenn ScriptType == Inline Script && WebAppKind != "". Standardwert: :: You can provide your deployment commands here. One command per line..

ScriptPath - Pfad des Bereitstellungsskripts
string. Erforderlich, wenn ScriptType == File Path && WebAppKind != "".

GenerateWebConfig - generieren Web.config
boolean. Wahlfrei. Wird verwendet, wenn WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Standardwert: false.

Ein Standard-Web.config wird generiert und in Azure App Service bereitgestellt, wenn die Anwendung nicht über eine verfügt. Die Werte in web.config können bearbeitet und je nach Anwendungsframework variieren. Für die node.js Anwendung verfügt web.config z. B. über Startdatei und iis_node Modulwerte. Erfahren Sie mehr über Azure App Service Deployment.

WebConfigParameters - Web.config Parameter
string. Erforderlich, wenn GenerateWebConfig == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war.

Bearbeitet Werte wie Startdateien in der generierten web.config Datei. Dieses Bearbeitungsfeature ist nur für die generierte web.configvorgesehen. Erfahren Sie mehr über Azure App Service Deployment.

AppSettings - App-Einstellungen
string.

Bearbeitet web app-Anwendungseinstellungen nach der Syntax -key Werts. Werte, die Leerzeichen enthalten, sollten in doppelte Anführungszeichen eingeschlossen werden. Beispiele: -Port 5000-RequestTimeout 5000-WEBSITE_TIME_ZONE"Eastern Standard Time".

ConfigurationSettings - Konfigurationseinstellungen
string.

Bearbeitet Web App-Konfigurationseinstellungen nach der Syntax -key Werts. Werte, die Leerzeichen enthalten, sollten in doppelte Anführungszeichen eingeschlossen werden.

Beispiele: -phpVersion 5.6-linuxFxVersion: node|6.11.

TakeAppOfflineFlag - App offline
boolean. Wahlfrei. Wird verwendet, wenn WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". 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.

UseWebDeploy - Veröffentlichen mithilfe von Web Deploy
boolean. Wahlfrei. Wird verwendet, wenn WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Standardwert: false.

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

SetParametersFile - SetParameters-Datei
string. Wahlfrei. Wird verwendet, wenn UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

Der Speicherort der zu verwendenden SetParameters.xml Datei.

RemoveAdditionalFilesFlag - Entfernen zusätzlicher Dateien am Ziel-
boolean. Wahlfrei. Wird verwendet, wenn UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". 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.

Hinweis: Dadurch werden auch alle Dateien entfernt, die mit jeder Erweiterung verbunden sind, die auf diesem Azure App Service installiert ist. Um dies zu verhindern, aktivieren Sie das Kontrollkästchen Exclude files from App_Data folder.

ExcludeFilesFromAppDataFlag - Dateien aus dem App_Data Ordner ausschließen
boolean. Wahlfrei. Wird verwendet, wenn UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Standardwert: false.

Verwenden Sie diese Option, um zu verhindern, dass Dateien im ordner App_Data aus dem Azure App Service bereitgestellt/gelöscht werden.

AdditionalArguments - Zusätzliche Argumente
string. Wahlfrei. Wird verwendet, wenn UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

Die zusätzlichen Web Deploy-Argumente nach der Syntax -key:value.

Diese werden beim Bereitstellen des Azure App Service angewendet. Beispiele: -disableLink:AppPoolExtension-disableLink:ContentExtension.

Weitere Beispiele für Web Deploy Operation Settings.

RenameFilesFlag - Gesperrte Dateien umbenennen
boolean. Wahlfrei. Wird verwendet, wenn UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Standardwert: false.

Verwenden Sie diese Option, um das Msdeploy-Flag MSDEPLOY_RENAME_LOCKED_FILES=1 in den Azure App Service-Anwendungseinstellungen zu aktivieren. Mit der Option kann msdeploy gesperrte Dateien umbenennen, die während der App-Bereitstellung gesperrt sind.

enableXmlTransform - XML-Transformation
Eingabealias: XmlTransformation. boolean. Wahlfrei. Wird verwendet, wenn WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Standardwert: false.

Die Konfigurationstransformationen werden für *.Release.config und *.<EnvironmentName>.config für die *.config fileausgeführt.

Konfigurationstransformationen werden vor der Variablenersetzung ausgeführt.

XML-Transformationen werden nur für windows-Plattform unterstützt.

enableXmlVariableSubstitution - XML-Variablenersetzung
Eingabealias: XmlVariableSubstitution. boolean. Wahlfrei. Wird verwendet, wenn WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Standardwert: false.

Variablen, die in der Build- oder Releasepipeline definiert sind, werden mit den Einträgen key oder name in den Abschnitten appSettings, applicationSettingsund connectionStrings jeder Konfigurationsdatei und parameters.xmlabgeglichen. Variablenersetzung wird nach Konfigurationstransformationen ausgeführt.

Hinweis: Wenn dieselben Variablen in der Releasepipeline und in der Umgebung definiert sind, werden die Versionspipelinevariablen durch die Umgebungsvariablen ersetzt.

JSONFiles - JSON-Variablenersetzung
string. Wahlfrei. Wird verwendet, wenn WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war.

Stellt eine neue zeilentrennte Liste von JSON-Dateien bereit, um die Variablenwerte zu ersetzen. Dateinamen werden relativ zum Stammordner bereitgestellt.

Wenn Sie JSON-Variablen ersetzen möchten, die geschachtelt oder hierarchisch sind, geben Sie diese mithilfe JSONPath Ausdrücke an.

Um beispielsweise den Wert von ConnectionString im folgenden Beispiel zu ersetzen, müssen Sie eine Variable als Data.DefaultConnection.ConnectionString in der Build-/Releasepipeline (oder in der Umgebung der Releasepipeline) definieren.

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

Die Variable Substitution wird nach Konfigurationstransformationen ausgeführt.

Hinweis: Pipelinevariablen werden bei der Ersetzung ausgeschlossen.

Aufgabensteuerungsoptionen

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

Ausgabevariablen

Keiner.

Bemerkungen

Es ist eine neuere Version dieser Aufgabe verfügbar. Weitere Informationen finden Sie unter AzureRmWebAppDeployment@4.

Problembehandlung

Ich kann die Webbereitstellung für meinen Azure App Service nicht mithilfe der Microsoft Entra ID-Authentifizierung von meinem Windows-Agent ausführen.

Die Azure App Service-Bereitstellungsaufgabe unterstützt die Verbindung mit Microsoft Azure mit einer ARM-Dienstverbindung mithilfe der Microsoft Entra-ID, es sei denn, die folgenden drei Bedingungen sind vorhanden:

Sie verwenden das Web Deploy-Paketformat auf einem Windows-Agent.
Ihr Agent wird mit einer älteren Version von msdeploy.exe ausgeführt (z. B. bei Verwendung des windows-2019 gehosteten Agentimages)
Die Standardauthentifizierung ist für Ihren Azure App Service deaktiviert.

Wenn diese drei Bedingungen vorhanden sind, erhalten Sie eine Fehlermeldung wie App Service is configured to not use basic authentication. This requires Web Deploy msdeploy.exe version 7.1.7225.2108 or higher. You need a version of Visual Studio that includes an updated version of msdeploy.exe. For more information, visit https://aka.ms/azdo-webapp-msdeploy.

Um dieses Problem zu beheben, können Sie aus den folgenden Optionen wählen, in der Reihenfolge der Voreinstellung.

Aktualisieren Sie das Agentimage. Wenn Sie gehostete Agents verwenden, wechseln Sie von windows-2019- zu windows-2022- (oder windows-latest). Wenn Sie selbst gehostete Agents verwenden, installieren Sie Visual Studio 2022 auf dem Agent, um eine neuere Version von msdeploy.exezu erhalten.
Wenn Sie von einem älteren Agentimage abhängig sind und den Agent für Ihre Pipeline nicht aktualisieren können, sollten Sie den Auftrag aufteilen, sodass die Bereitstellungsaufgabe von Azure App Service auf windows-2022 (oder windows-latest) ausgeführt wird.
Wenn keine dieser Optionen möglich ist, können Sie standardauthentifizierung für Ihren Azure App Service aktivieren.

Anforderungen

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

Freigeben über

AzureRmWebAppDeployment@3 – Azure App Service v3-Aufgabe bereitstellen

Syntax

Eingänge

Aufgabensteuerungsoptionen

Ausgabevariablen

Bemerkungen

Problembehandlung

Ich kann die Webbereitstellung für meinen Azure App Service nicht mithilfe der Microsoft Entra ID-Authentifizierung von meinem Windows-Agent ausführen.

Anforderungen

Feedback

Zusätzliche Ressourcen