使用此工作,使用 Web Deploy/Kudu REST API更新 Azure App Service。
語法
# 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.
輸入
ConnectedServiceName
-
Azure 訂用帳戶
string。 必須的。
指定部署的 Azure Resource Manager 訂用帳戶。
WebAppName
-
App Service 名稱
string。 必須的。
指定現有 Azure App Service 的名稱。
DeployToSlotFlag
-
部署至位置
boolean。 預設值:false。
使用此選項可部署到生產位置以外的現有位置。
ResourceGroupName
-
資源群組
string。
DeployToSlotFlag = true時為必要項。
指定包含上面指定之 Azure App Service 的 Azure 資源群組。
SlotName
-
位置
string。
DeployToSlotFlag = true時為必要項。
指定生產位置以外的現有位置。
VirtualApplication
-
虛擬應用程式
string。
指定已在 Azure 入口網站中設定的虛擬應用程式名稱。 部署至 App Service 根目錄時不需要此選項。
Package
-
套件或資料夾
string。 必須的。 預設值:$(System.DefaultWorkingDirectory)/**/*.zip。
App Service 套件或資料夾的資料夾或檔案路徑。 變數包括 組建 和 Release。 支援 通配符。
例如: $(System.DefaultWorkingDirectory)/\*\*/\*.zip 。
WebAppUri
-
應用服務 URL
string。
指定為 App Service URL 產生的輸出變數名稱。 變數可用於後續工作。
使用 Web DeployUseWebDeploy - 發佈
boolean。 預設值:true。
只有在使用 Windows 代理程式時,才支援 Publish using web deploy 選項。 在其他平臺上,工作依賴 Kudu REST API 來部署 App Service,而且不支援下列選項。
SetParametersFile
-
SetParameters 檔案
string。 選擇性。
UseWebDeploy == true時使用 。
指定要使用之 SetParameters.xml 檔案的位置。
RemoveAdditionalFilesFlag
-
在目的地 移除其他檔案
boolean。 選擇性。
UseWebDeploy == true時使用 。 預設值:false。
使用此選項可刪除 Azure App Service 上沒有相符檔案的 App Service 套件或資料夾中的檔案。
ExcludeFilesFromAppDataFlag
-
從 App_Data 資料夾排除檔案
boolean。 選擇性。
UseWebDeploy == true時使用 。 預設值:false。
排除 App_Data 資料夾中的檔案,使其無法部署到 Azure App Service。
AdditionalArguments
-
其他自變數
string。 選擇性。
UseWebDeploy == true時使用 。
語法 -key:value之後的其他Web Deploy自變數。
部署 Azure App Service 時,將會套用這些專案。 範例:-disableLink:AppPoolExtension-disableLink:ContentExtension。
TakeAppOfflineFlag
-
讓應用程式離線
boolean。 預設值:false。
使用此選項,在同步作業開始之前,將 app_offline.htm 檔案放在 App Service 的根目錄中,讓 Azure App Service 離線。 同步作業成功完成之後,將會移除檔案。
工作控制選項
除了工作輸入之外,所有工作都有控制選項。 如需詳細資訊,請參閱 控制項選項和一般工作屬性。
輸出變數
沒有。
需求
| 要求 | 說明 |
|---|---|
| 管線類型 | YAML、傳統組建、傳統版本 |
| 執行於 | 代理 |
| 需求 | 沒有 |
| 功能 | 此工作不符合作業中後續工作的任何需求。 |
| 命令限制 | 任意 |
| Settable 變數 | 任意 |
| 代理程式版本 | 1.102.0 或更新 |
| 工作類別 | 部署 |