AzureRmWebAppDeployment@2 – úloha nasazení Azure App Service v2

Článek
01/27/2024

Aktualizujte Azure App Service pomocí rozhraní REST API pro nasazení webu / Kudu.

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.

# YAML Syntax is not supported in TFS 2018.
# Use the classic designer to add and configure tasks.
# See the following Inputs section for details on the inputs that this task supports.

Vstupy

ConnectedServiceName - Předplatné Azure
string. Povinná hodnota.

Vyberte předplatné Azure Resource Manager pro nasazení.

WebAppName - název App Service
string. Povinná hodnota.

Zadejte nebo vyberte název existujícího Azure App Service.

DeployToSlotFlag - Nasazení do slotu
boolean. Výchozí hodnota: false.

Vyberte možnost nasazení do existujícího slotu jiného než produkčního slotu.

ResourceGroupName - Skupina prostředků
string. Vyžaduje se, když DeployToSlotFlag = true.

Zadejte nebo vyberte skupinu prostředků Azure, která obsahuje Azure App Service uvedené výše.

SlotName - Slot
string. Vyžaduje se, když DeployToSlotFlag = true.

Zadejte nebo vyberte existující slot jiný než produkční slot.

VirtualApplication - Virtuální aplikace
string.

Zadejte název virtuální aplikace nakonfigurované v Azure Portal. Pro nasazení do kořenového adresáře App Service se tato možnost nevyžaduje.

Package - Balíček nebo složka
string. Povinná hodnota. Výchozí hodnota: $(System.DefaultWorkingDirectory)/**/*.zip.

Cesta ke složce nebo souboru k balíčku nebo složce App Service. Proměnné (verze sestavení | ), podporují se zástupné znaky.
Například $(System.DefaultWorkingDirectory)/**/**.zip.

WebAppUri - adresa URL App Service
string.

Zadejte název výstupní proměnné, která se vygeneruje pro adresu URL App Service. Proměnnou je možné využívat v dalších úkolech.

UseWebDeploy - Publikování pomocí nasazení webu
boolean. Výchozí hodnota: true.

Publikování pomocí možností nasazení webu se podporuje jenom při použití agenta windows. Na jiných platformách úloha spoléhá na rozhraní REST API Kudu k nasazení App Service a následující možnosti se nepodporují.

SetParametersFile - Soubor SetParameters
string. Nepovinný parametr. Použít, když UseWebDeploy == true.

Volitelné: umístění souboru SetParameters.xml, který se má použít.

RemoveAdditionalFilesFlag - Odebrání dalších souborů v cíli
boolean. Nepovinný parametr. Použít, když UseWebDeploy == true. Výchozí hodnota: false.

Vyberte možnost odstranění souborů na Azure App Service, které nemají v balíčku nebo složce App Service odpovídající soubory.

ExcludeFilesFromAppDataFlag - Vyloučení souborů ze složky App_Data
boolean. Nepovinný parametr. Použít, když UseWebDeploy == true. Výchozí hodnota: false.

Výběrem možnosti zabráníte nasazení souborů ve složce App_Data do Azure App Service.

AdditionalArguments - Další argumenty
string. Nepovinný parametr. Použít, když UseWebDeploy == true.

Další argumenty nasazení webu za syntaxí -key:value.
Použijí se při nasazování Azure App Service. Příklad: -disableLink:AppPoolExtension -disableLink:ContentExtension.
Další příklady nastavení operace nasazení webu najdete v tomto článku.

TakeAppOfflineFlag - Přechádět aplikaci do offline režimu
boolean. Výchozí hodnota: false.

Výběrem možnosti převést Azure App Service offline umístěním souboru app_offline.htm do kořenového adresáře App Service před zahájením operace synchronizace. Po úspěšném dokončení operace synchronizace se soubor odebere.

Možnosti řízení úkolů

Všechny úkoly mají kromě vstupů úkolů také možnosti řízení. Další informace najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úloh.

Výstupní proměnné

Žádné

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasický build, klasická verze
Běží na	Agent
Požadavky	Žádné
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	1.102.0 nebo vyšší
Kategorie úloh	Nasazení

Sdílet prostřednictvím