AzureRmWebAppDeployment@2 - Azure App 服務部署 v2 工作

文章
01/27/2024

使用 Web Deploy / Kudu REST API 更新Azure App 服務。

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.

輸入

ConnectedServiceName - Azure 訂用帳戶
string. 必要。

選取部署的 Azure Resource Manager訂用帳戶。

WebAppName - App Service名稱
string. 必要。

輸入或選取現有Azure App 服務的名稱。

DeployToSlotFlag - 部署至位置
boolean. 預設值：false。

選取選項以部署到生產位置以外的現有位置。

ResourceGroupName - 資源群組
string. 當時為必要 DeployToSlotFlag = true 專案。

輸入或選取包含上述Azure App 服務的 Azure 資源群組。

SlotName - 槽
string. 當時為必要 DeployToSlotFlag = true 專案。

輸入或選取生產位置以外的現有位置。

VirtualApplication - 虛擬應用程式
string.

指定已在Azure 入口網站中設定的虛擬應用程式名稱。部署至App Service根目錄不需要此選項。

Package - 封裝或資料夾
string. 必要。預設值：$(System.DefaultWorkingDirectory)/**/*.zip。

App Service套件或資料夾的資料夾或檔案路徑。 (組建 | 發行) 支援萬用字元的變數。
例如，$ (System.DefaultWorkingDirectory) /**/*.zip。

WebAppUri - App Service URL
string.

指定為App Service URL 產生的輸出變數名稱。變數可以在後續工作中取用。

UseWebDeploy - 使用 Web Deploy 發佈
boolean. 預設值：true。

只有在使用 Windows 代理程式時，才支援使用 Web 部署選項發佈。在其他平臺上，工作依賴Kudu REST API來部署App Service，而且不支援下列選項。

SetParametersFile - SetParameters 檔案
string. 選擇性。使用時機 UseWebDeploy == true 。

選擇性：要使用的SetParameters.xml檔案位置。

RemoveAdditionalFilesFlag - 移除目的地的其他檔案
boolean. 選擇性。使用時機 UseWebDeploy == true 。預設值：false。

選取選項可刪除App Service套件或資料夾中沒有相符檔案之Azure App 服務上的檔案。

ExcludeFilesFromAppDataFlag - 從App_Data資料夾中排除檔案
boolean. 選擇性。使用時機 UseWebDeploy == true 。預設值：false。

選取選項可防止App_Data資料夾中的檔案部署至Azure App 服務。

AdditionalArguments - 其他引數
string. 選擇性。使用時機 UseWebDeploy == true 。

遵循語法 -key：value 的其他 Web Deploy 引數。
部署Azure App 服務時，將會套用這些專案。範例：-disableLink：AppPoolExtension -disableLink：ContentExtension。
如需 Web Deploy 作業設定的更多範例，請參閱這一點。

TakeAppOfflineFlag - 讓應用程式離線
boolean. 預設值：false。

選取在同步作業開始之前，將app_offline.htm檔案放在App Service根目錄中，讓Azure App 服務離線的選項。同步作業成功完成之後，將會移除檔案。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。如需詳細資訊，請參閱控制項選項和一般工作屬性。

輸出變數

無。

規格需求

需求	說明
管線類型	YAML、傳統組建、傳統版本
執行于	代理程式
要求	無
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	任意
Settable 變數	任意
代理程式版本	1.102.0 或更新版本
工作類別	部署

分享方式：