AzureRmWebAppDeployment@3: Azure App Service v3-Task bereitstellen

Artikel
07/02/2024

Verwenden Sie diese Aufgabe, um eine Azure App Service einer Web-, Mobil- oder API-App mithilfe von Docker, Java, .NET, .NET Core, Node.js, PHP, Python oder Ruby bereitzustellen.

Hinweis

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

Aktualisieren Sie Azure-App Services unter Windows, Web-App unter Linux mit integrierten Images oder Docker-Containern, ASP.NET, .NET Core, PHP, Python oder Node.js basierenden Webanwendungen, Funktions-Apps, mobilen Apps, API-Anwendungen und Webaufträgen mithilfe von Web Deploy/Kudu REST-APIs.

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.

# Azure App Service Deploy v3
# Update Azure App Services on Windows, Web App on Linux with built-in images or Docker containers, ASP.NET, .NET Core, PHP, Python or Node.js based Web applications, Function Apps, Mobile Apps, API applications, Web Jobs using Web Deploy / Kudu REST APIs.
- 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.

Eingaben

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, Verwenden Azure Functions Task)), 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 einer vorhandenen Azure App Service an. App-Dienste, die auf dem ausgewählten App-Typ basieren, werden nur aufgeführt, wenn sie den Task Assistent.

DeployToSlotFlag - Bereitstellen im Slot
boolean. Optional. Verwenden Sie , wenn WebAppKind != "". Standardwert. false.

Verwenden Sie diese Option, um die Bereitstellung in einem anderen Slot als dem Produktionsslot zu verwenden. Wenn diese Option nicht ausgewählt ist, wird die Azure App Service im Produktionsslot bereitgestellt.

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

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

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

Geben Sie einen anderen slot als den Produktionsslot an.

ImageSource - Bildquelle
string. Optional. Verwenden Sie , wenn WebAppKind = applinux || WebAppKind = linux. Zulässige Werte: Registry (Container Registry), Builtin (integriertes Image). Standardwert. Registry.

App Service für Linux bietet zwei verschiedene Optionen zum Veröffentlichen Ihrer Anwendung:

Benutzerdefinierte Imagebereitstellung oder App-Bereitstellung mit einem integrierten Plattformimage.

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

Ein global eindeutiger Domänenname der obersten Ebene für Ihre spezifische Registrierung.

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

AzureContainerRegistryLoginServer - Name des Registrierungsanmeldungsservers
string. Optional. Verwenden Sie , wenn ImageSource = invalidimagesource.

Geben Sie einen Namen des Anmeldeservers für die Azure-Containerregistrierung an.

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

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

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

AzureContainerRegistryTag - Etikett
string. Optional. Verwenden Sie , wenn ImageSource = AzureContainerRegistry.

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

Hinweis: Ein vollqualifizierter Bildname hat das Format : <registry><repository>/<tag>. Beispielmyregistry.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 werden.

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

PrivateRegistryTag - Etikett
string. Optional. Verwenden Sie , wenn ImageSource = PrivateRegistry.

Tags sind der Mechanismus, den Registrierungen verwenden, um Docker-Images eine Version zu geben.

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

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

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

Hinweis: Ein vollqualifizierter Bildname hat das Format : <registry or namespace><repository>/<tag>. Beispielmyregistry.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 werden.

Hinweis: Ein vollqualifizierter Bildname weist das Format auf: '<registry or namespace>/<repository>:<tag>. Beispielmyregistry.azurecr.io/nginx: :.latest

DockerImageTag - Etikett
string. Optional. Verwenden Sie , wenn WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

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

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

VirtualApplication - Virtuelle Anwendung
string. Optional. Verwenden Sie , 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 zu einem Ordner mit App Service-Inhalten, die von MSBuild oder einer komprimierten ZIP- oder War-Datei generiert wurden.

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

Zum 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 zu einem Ordner mit App Service-Inhalten, die von MSBuild oder einer komprimierten ZIP- oder War-Datei generiert wurden.

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

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

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

Geben Sie das Framework und die Version an.

StartupCommand - Startbefehl
string. Optional. Verwenden Sie , wenn WebAppKind = applinux || WebAppKind = linux.

Geben Sie den Startbefehl an.

WebAppUri - App Service URL
string. Optional. Verwenden Sie , 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 Aufgaben verwendet werden.

ScriptType - Bereitstellungsskripttyp
string. Optional. Verwenden Sie , 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 Bereitstellung.

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 von Web.config
boolean. Optional. Verwenden Sie , wenn WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Standardwert. false.

Ein Standard Web.config wird generiert und für Azure App Service bereitgestellt, wenn die Anwendung keinen hat. Die Werte in web.config können bearbeitet werden und variieren je nach Anwendungsframework. Für die node.js Anwendung web.config werden beispielsweise Startdatei- und iis_node Modulwerte verwendet. Erfahren Sie mehr über Azure App Service Bereitstellung.

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 gilt nur für das generierte web.config. Erfahren Sie mehr über Azure App Service Bereitstellung.

AppSettings - App-Einstellungen
string.

Bearbeitet Web-App-Anwendungseinstellungen nach dem Syntaxschlüsselwert . Werte, die Leerzeichen enthalten, müssen in doppelte Anführungszeichen gesetzt werden. Beispiele: -Port 5000-RequestTimeout 5000-WEBSITE_TIME_ZONE"Eastern Standard Time".

ConfigurationSettings - Konfigurationseinstellungen
string.

Bearbeitet Web-App-Konfigurationseinstellungen gemäß dem Syntaxwert -key . Werte, die Leerzeichen enthalten, müssen in doppelte Anführungszeichen gesetzt werden.

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

TakeAppOfflineFlag - Offline schalten der App
boolean. Optional. Verwenden Sie , wenn WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Standardwert. false.

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

UseWebDeploy - Veröffentlichen mithilfe von Web Deploy
boolean. Optional. Verwenden Sie , 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, um die Azure App Service bereitzustellen, und die folgenden Optionen werden nicht unterstützt.

SetParametersFile - SetParameters-Datei
string. Optional. Verwenden Sie , wenn UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

Der Speicherort der SetParameters.xml zu verwendenden Datei.

RemoveAdditionalFilesFlag - Entfernen zusätzlicher Dateien am Ziel
boolean. Optional. Verwenden Sie , wenn UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Standardwert. false.

Verwenden Sie diese Option, um Dateien auf dem 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 sich auf eine erweiterung beziehen, die auf dieser Azure App Service installiert ist. Aktivieren Sie das Kontrollkästchen, um dies Exclude files from App_Data folder zu verhindern.

ExcludeFilesFromAppDataFlag - Ausschließen von Dateien aus dem ordner App_Data
boolean. Optional. Verwenden Sie , wenn UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Standardwert. false.

Verwenden Sie diese Option, um zu verhindern, dass Dateien im App_Data Ordner im Azure App Service bereitgestellt bzw. gelöscht werden.

AdditionalArguments - Zusätzliche Argumente
string. Optional. Verwenden Sie , wenn UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

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

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

Weitere Beispiele für Webbereitstellungsvorgangseinstellungen.

RenameFilesFlag - Umbenennen gesperrter Dateien
boolean. Optional. Verwenden Sie , wenn UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Standardwert. false.

Verwenden Sie diese Option, um das msdeploy-Flag MSDEPLOY_RENAME_LOCKED_FILES=1 in Azure App Service Anwendungseinstellungen zu aktivieren. Die Option ermöglicht msdeploy, gesperrte Dateien, die während der App-Bereitstellung gesperrt sind, umzubenennen.

enableXmlTransform - XML-Transformation
Eingabealias: XmlTransformation. boolean. Optional. Verwenden Sie , wenn WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Standardwert. false.

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

Konfigurationstransformationen werden vor der Variablenersetzung ausgeführt.

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

enableXmlVariableSubstitution - Ersetzung von XML-Variablen
Eingabealias: XmlVariableSubstitution. boolean. Optional. Verwenden Sie , wenn WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Standardwert. false.

Variablen, die in der Build- oder Releasepipeline definiert sind, werden mit den key Einträgen oder name in den appSettingsAbschnitten , 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, ersetzen die Umgebungsvariablen die Releasepipelinevariablen.

JSONFiles - JSON-Variablenersetzung
string. Optional. Verwenden Sie , wenn WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war.

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

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-/Releasepipeline (oder der Umgebung 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.

Hinweise

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

Problembehandlung

Ich kann keine Webbereitstellung für meine Azure App Service mit Microsoft Entra ID Authentifizierung über meinen Windows-Agent ausführen.

Der Azure App Service Bereitstellungstask unterstützt das Herstellen einer Verbindung mit Microsoft Azure über eine ARM-Dienstverbindung über Microsoft Entra ID, es sei denn, die folgenden drei Bedingungen sind vorhanden:

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

Wenn diese drei Bedingungen vorliegen, 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 in der Reihenfolge ihrer Präferenzen auswählen.

Aktualisieren Sie das Agentimage. Wenn Sie gehostete Agents verwenden, wechseln Sie von windows-2019 zu Windows-2022 (oder windows-latest). Wenn Sie selbstgehostete Agents verwenden, installieren Sie Visual Studio 2022 auf dem Agent, um eine neuere Version von msdeploy.exezu erhalten.
Wenn Sie von einem älteren Agent-Image abhängig sind und den Agent für Ihre Pipeline nicht aktualisieren können, sollten Sie in Erwägung ziehen, den Auftrag aufzuteilen, damit der Azure App Service Bereitstellungstask unter Windows-2022 (oder windows-latest) ausgeführt wird.
Wenn keine dieser Optionen möglich ist, können Sie die Standardauthentifizierung für Ihre Azure App Service aktivieren.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, 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

Freigeben über

AzureRmWebAppDeployment@3: Azure App Service v3-Task bereitstellen

Syntax

Eingaben

Optionen für die Vorgangskontrolle

Ausgabevariablen

Hinweise

Problembehandlung

Ich kann keine Webbereitstellung für meine Azure App Service mit Microsoft Entra ID Authentifizierung über meinen Windows-Agent ausführen.

Anforderungen

Feedback

Zusätzliche Ressourcen