AzureRmWebAppDeployment@2 - Azure App Service Deploy v2-taak

Artikel
03/24/2025

Gebruik deze taak om Azure App Service bij te werken met behulp van Web Deploy/Kudu REST API's.

Syntaxis

# 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.

Invoer

ConnectedServiceName - Azure-abonnement
string. Verplicht.

Geef het Azure Resource Manager-abonnement op voor de implementatie.

WebAppName - App Service-naam
string. Verplicht.

Geef de naam op van een bestaande Azure App Service.

DeployToSlotFlag - Implementeren op site-
boolean. Standaardwaarde: false.

Gebruik deze optie om te implementeren naar een andere site dan de productiesite.

ResourceGroupName - resourcegroep
string. Vereist wanneer DeployToSlotFlag = true.

Geef de Azure-resourcegroep op die de Hierboven opgegeven Azure App Service bevat.

SlotName - Slot
string. Vereist wanneer DeployToSlotFlag = true.

Geef een andere site op dan de productiesite.

VirtualApplication - virtuele toepassing
string.

Geef de naam op van de virtuele toepassing die is geconfigureerd in Azure Portal. De optie is niet vereist voor implementaties naar de App Service-hoofdmap.

Package - pakket of map
string. Verplicht. Standaardwaarde: $(System.DefaultWorkingDirectory)/**/*.zip.

De map of het bestandspad naar het App Service-pakket of de map. Variabelen zijn onder andere Build en Release. jokertekens worden ondersteund.

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

WebAppUri - App Service-URL
string.

Geef een naam op voor de uitvoervariabele die wordt gegenereerd voor de URL van de App Service. De variabele kan worden gebruikt in volgende taken.

UseWebDeploy - Publiceren met behulp van Web Deploy
boolean. Standaardwaarde: true.

Publish using web deploy opties worden alleen ondersteund wanneer u een Windows-agent gebruikt. Op andere platforms is de taak afhankelijk van Kudu REST API's om de App Service te implementeren. De volgende opties worden niet ondersteund.

SetParametersFile - SetParameters-bestand
string. Facultatief. Gebruiken wanneer UseWebDeploy == true.

Geef de locatie op van het SetParameters.xml-bestand dat u wilt gebruiken.

RemoveAdditionalFilesFlag - Extra bestanden verwijderen op doel
boolean. Facultatief. Gebruiken wanneer UseWebDeploy == true. Standaardwaarde: false.

Gebruik deze optie om bestanden in Azure App Service te verwijderen die geen overeenkomende bestanden bevatten in het App Service-pakket of de map.

ExcludeFilesFromAppDataFlag - Bestanden uitsluiten van de App_Data map
boolean. Facultatief. Gebruiken wanneer UseWebDeploy == true. Standaardwaarde: false.

Sluit bestanden uit in de map App_Data worden geïmplementeerd in Azure App Service.

AdditionalArguments - Aanvullende argumenten
string. Facultatief. Gebruiken wanneer UseWebDeploy == true.

Aanvullende argumenten voor Web Deploy volgens de syntaxis -key:value.

Deze worden toegepast bij het implementeren van De Azure App Service. Voorbeeld: -disableLink:AppPoolExtension-disableLink:ContentExtension.

Meer informatie over Web Deploy-bewerkingsinstellingen.

TakeAppOfflineFlag - app offline halen
boolean. Standaardwaarde: false.

Gebruik deze optie om Azure App Service offline te halen door een app_offline.htm-bestand in de hoofdmap van de App Service te plaatsen voordat de synchronisatiebewerking begint. Het bestand wordt verwijderd nadat de synchronisatiebewerking is voltooid.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Vereisten

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Vertegenwoordiger
eisen	Geen
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welk dan ook
variabelen instellen	Welk dan ook
Agentversie	1.102.0 of hoger
Taakcategorie	Implementeren

Delen via