AzureRmWebAppDeployment@2 – Azure App Service Deploy v2-uppgift

Artikel
03/24/2025

Använd den här uppgiften för att uppdatera Azure App Service med hjälp av Web Deploy/Kudu REST API:er.

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.

Ingångar

ConnectedServiceName - Azure-prenumeration
string. Obligatoriskt.

Ange Azure Resource Manager-prenumerationen för distributionen.

WebAppName - App Service-namn
string. Obligatoriskt.

Ange namnet på en befintlig Azure App Service.

DeployToSlotFlag - Distribuera till fack
boolean. Standardvärde: false.

Använd det här alternativet om du vill distribuera till ett annat befintligt fack än produktionsplatsen.

ResourceGroupName - resursgrupp
string. Krävs när DeployToSlotFlag = true.

Ange den Azure-resursgrupp som innehåller Azure App Service som anges ovan.

SlotName - fack
string. Krävs när DeployToSlotFlag = true.

Ange ett annat befintligt fack än produktionsplatsen.

VirtualApplication - virtual application
string.

Ange namnet på det virtuella program som har konfigurerats i Azure-portalen. Alternativet krävs inte för distributioner till App Service-roten.

Package - paket eller mapp
string. Obligatoriskt. Standardvärde: $(System.DefaultWorkingDirectory)/**/*.zip.

Mapp- eller filsökvägen till App Service-paketet eller mappen. Variablerna omfattar Build och Release. jokertecken stöds.

Till exempel $(System.DefaultWorkingDirectory)/\*\*/\*.zip.

WebAppUri - App Service URL-
string.

Ange ett namn för utdatavariabeln som genereras för App Service-URL:en. Variabeln kan användas i efterföljande uppgifter.

UseWebDeploy - Publicera med webdistribution
boolean. Standardvärde: true.

Publish using web deploy alternativ stöds endast när du använder en Windows-agent. På andra plattformar förlitar sig uppgiften på Kudu REST API:er för att distribuera App Service, och följande alternativ stöds inte.

SetParametersFile - SetParameters-fil
string. Valfritt. Använd när UseWebDeploy == true.

Ange platsen för den SetParameters.xml fil som ska användas.

RemoveAdditionalFilesFlag - Ta bort ytterligare filer vid mål
boolean. Valfritt. Använd när UseWebDeploy == true. Standardvärde: false.

Använd det här alternativet om du vill ta bort filer i Azure App Service som inte har några matchande filer i App Service-paketet eller mappen.

ExcludeFilesFromAppDataFlag - Undanta filer från App_Data-mappen
boolean. Valfritt. Använd när UseWebDeploy == true. Standardvärde: false.

Undanta filer i mappen App_Data från att distribueras till Azure App Service.

AdditionalArguments - ytterligare argument
string. Valfritt. Använd när UseWebDeploy == true.

Ytterligare argument för webbdistribution efter syntaxen -key:value.

Dessa tillämpas när du distribuerar Azure App Service. Exempel: -disableLink:AppPoolExtension-disableLink:ContentExtension.

Läs mer om inställningarna för webdistributionsåtgärd.

TakeAppOfflineFlag - ta appen offline
boolean. Standardvärde: false.

Använd det här alternativet om du vill koppla från Azure App Service genom att placera en app_offline.htm fil i apptjänstens rotkatalog innan synkroniseringen påbörjas. Filen tas bort när synkroniseringen har slutförts.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Ombud
kräver	Ingen
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Vilken som helst
variabler som kan	Vilken som helst
Agentversion	1.102.0 eller senare
Aktivitetskategori	Gruppera

Dela via