AzureResourceGroupDeployment@1 - Azure 資源群組部署 v1 工作

發行項
07/02/2024

使用此工作來部署、啟動、停止和刪除 Azure 資源群組。

此工作已被取代;使用 AzureResourceGroupDeployment@2。

Syntax

# Azure Resource Group Deployment v1
# Deploy, start, stop, delete Azure Resource Groups.
- task: AzureResourceGroupDeployment@1
  inputs:
    #ConnectedServiceNameSelector: 'ConnectedServiceName' # 'ConnectedServiceName' | 'ConnectedServiceNameClassic'. Azure Connection Type. Default: ConnectedServiceName.
    ConnectedServiceName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Subscription. 
    #ConnectedServiceNameClassic: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Azure Classic Subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'Restart' | 'Delete' | 'DeleteRG'. Required when ConnectedServiceNameSelector = ConnectedServiceName. Action. Default: Create Or Update Resource Group.
    #actionClassic: 'Select Resource Group' # 'Select Resource Group'. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Action. Default: Select Resource Group.
    resourceGroupName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Resource Group. 
    #cloudService: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Cloud Service. 
    #location: 'East US' # 'Australia East' | 'Australia Southeast' | 'Brazil South' | 'Canada Central' | 'Canada East' | 'Central India' | 'Central US' | 'East Asia' | 'East US' | 'East US 2 ' | 'Japan East' | 'Japan West' | 'North Central US' | 'North Europe' | 'South Central US' | 'South India' | 'Southeast Asia' | 'UK South' | 'UK West' | 'West Central US' | 'West Europe' | 'West India' | 'West US' | 'West US 2'. Required when action = Create Or Update Resource Group. Location. Default: East US.
    #csmFile: # string. Required when action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when action = Create Or Update Resource Group. Template Parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override Template Parameters. 
    #deploymentMode: 'Incremental' # 'Validation' | 'Incremental' | 'Complete'. Required when action = Create Or Update Resource Group. Deployment Mode. Default: Incremental.
    #enableDeploymentPrerequisitesForCreate: false # boolean. Optional. Use when action = Create Or Update Resource Group. Enable Deployment Prerequisites. Default: false.
    #enableDeploymentPrerequisitesForSelect: false # boolean. Optional. Use when action = Select Resource Group. Enable Deployment Prerequisites. Default: false.
  # Output
    #outputVariable: # string. Resource Group.

輸入

ConnectedServiceNameSelector - Azure 連線類型
string. 允許的值： ConnectedServiceName (Azure Resource Manager) ， ConnectedServiceNameClassic (Azure 傳統) 。預設值：ConnectedServiceName。

必要。選取包含部署 Azure 訂用帳戶的服務連線。

ConnectedServiceName - Azure 訂用帳戶
string. 當 ConnectedServiceNameSelector = ConnectedServiceName 時為必要。

必要。選取包含部署 Azure 訂用帳戶的服務連線。

ConnectedServiceNameClassic - Azure 傳統訂用帳戶
string. 當 ConnectedServiceNameSelector = ConnectedServiceNameClassic 時為必要。

選取部署的 Azure 傳統訂用帳戶。

action - 行動
string. 當 ConnectedServiceNameSelector = ConnectedServiceName 時為必要。允許的值：Create Or Update Resource Group、、Select Resource Group (Start Start 虛擬機器) 、 Stop (Stop 虛擬機器) 、 Restart (Restart 虛擬機器) 、 Delete (Delete 虛擬機器) 、 DeleteRG (刪除資源群組) 。預設值：Create Or Update Resource Group。

要對 Azure 資源或資源群組執行的動作。

actionClassic - 行動
string. 當 ConnectedServiceNameSelector = ConnectedServiceNameClassic 時為必要。允許的值： Select Resource Group (選取雲端服務) 。預設值：Select Resource Group。

要對 Azure 資源或雲端服務執行的動作。

resourceGroupName - 資源群組
string. 當 ConnectedServiceNameSelector = ConnectedServiceName 時為必要。

提供資源群組的名稱。

cloudService - 雲端服務
string. 當 ConnectedServiceNameSelector = ConnectedServiceNameClassic 時為必要。

提供雲端服務的名稱。

location - 位置
string. 當 action = Create Or Update Resource Group 時為必要。允許的值：Australia East、、 West EuropeNorth Central USJapan WestJapan EastEast US 2 North EuropeEast USEast AsiaSouth Central USUK WestUK SouthWest Central USSoutheast AsiaWest IndiaWest USBrazil SouthCanada EastWest US 2Canada CentralCentral IndiaCentral USSouth IndiaAustralia Southeast 預設值：East US。

要部署資源群組的位置。如果資源群組已存在於訂用帳戶中，則會忽略此值。

csmFile - 範本
string. 當 action = Create Or Update Resource Group 時為必要。

指定指向 Azure Resource Manager 樣本的路徑或模式。深入瞭解 Azure Resource Manager 範本。若要立即開始使用，請使用此範例範本。

csmParametersFile - 範本參數
string. 選擇性。使用時 action = Create Or Update Resource Group。

指定參數檔案的 URL。範例 URL： https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.parameters.json

若要使用儲存在私人記憶體帳戶中的檔案，請在範本的URL中擷取並包含 (SAS) 令牌的共用存取簽章。範例： <blob_storage_url>/template.json?<SAStoken> 若要將參數檔案上傳至記憶體帳戶併產生 SAS 令牌，請使用 Azure 檔案複製工作，或使用 PowerShell 或 Azure CLI 遵循步驟。

若要在方格中檢視範本參數，請按兩下 … [覆寫範本參數] 文字框旁的。這項功能需要啟用來源端的 CORS 規則。如果範本位於 Azure 記憶體 Blob 中，請參閱跨原始來源資源分享以啟用 CORS。

overrideParameters - 覆寫範本參數
string. 選擇性。使用時 action = Create Or Update Resource Group。

指定要覆寫的範本參數。

若要在方格中檢視範本參數，請按兩下 ... [覆寫參數] 文字框旁的。這項功能需要啟用來源端的 CORS 規則。如果範本位於 Azure 記憶體 Blob 中，請參考此字串以啟用 CORS，或在文字框中輸入要覆寫的範本參數。

範例： -storageName fabrikam -adminUsername $(vmusername) -adminPassword (ConvertTo-SecureString -String '$(password)' -AsPlainText -Force) -azureKeyVaultName $(fabrikamFibre).

如果參數值有多個單字，請以引號括住單字，即使您使用變數傳遞值也一樣。例如： -name "parameter value" -name2 "$(var)" 。若要覆寫物件類型參數，請使用字串化的 JSON 物件。例如： -options ["option1"] -map {"key1": "value1" } 。

deploymentMode - 部署模式
string. 當 action = Create Or Update Resource Group 時為必要。允許的值： Validation (只限驗證) 、 IncrementalComplete。預設值：Incremental。

模式會將 Incremental 部署當做資源群組的累加式更新來處理。它會保留存在於資源群組中但未在範本中指定的未變更資源。

Complete mode 會刪除不在範本中的資源。完整模式需要比累加模式更多的時間。如果工作逾時，請考慮增加逾時或變更為 Incremental 模式。

警告

完整模式將會刪除範本中未指定之資源群組中的所有現有資源。請檢閱您要部署的資源群組是否不包含範本中未指定的任何必要資源。

Validate 模式可讓您在建立實際資源之前，先找出範本的問題。

注意

Validate模式一律會建立資源群組，即使未部署任何資源也一樣。

深入瞭解部署模式。

enableDeploymentPrerequisitesForCreate - 啟用部署必要條件
boolean. 選擇性。使用時 action = Create Or Update Resource Group。預設值：false。

僅適用於資源群組包含虛擬機時。

選擇 [部署群組] 選項可設定每個虛擬機上的部署群組代理程式。

選取 WinRM 選項會使用自我簽署憑證，透過埠 5986 上的 HTTPS 通訊協定，設定 Windows 遠端管理 (WinRM) 接聽程式。需要此設定才能在 Azure 機器上執行部署作業。如果目標虛擬機是由負載平衡器支援，請確定已針對目標埠設定輸入NAT規則， (5986) 。

enableDeploymentPrerequisitesForSelect - 啟用部署必要條件
boolean. 選擇性。使用時 action = Select Resource Group。預設值：false。

僅適用於資源群組包含虛擬機時。

選擇 [部署群組] 選項可設定每個虛擬機上的部署群組代理程式。

選取 WinRM 選項會使用自我簽署憑證，透過埠 5986 上的 HTTPS 通訊協定，設定 Windows 遠端管理 (WinRM) 接聽程式。在 Azure 機器上執行部署作業需要此設定。如果目標虛擬機是由負載平衡器所支援，請確定已針對目標埠設定輸入NAT規則， (5986) 。

outputVariable - 資源群組
string.

選取現有資源群組時為必要專案。提供資源組變數的名稱。變數可用來 $(variableName) 參考後續工作中的資源群組，例如用於部署應用程式的PowerShell on Target Machines 工作。

只有在選取的動作為 Create、 Update或 Select時才有效。

工作控制選項

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

輸出變數

無。

規格需求

需求	描述
管線類型	YAML、傳統組建、傳統版本
執行於	Agent、DeploymentGroup
要求	自我裝載代理程式必須具備符合下列需求的功能，才能執行使用此工作的作業：azureps
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	任何
Settable 變數	任何
代理程式版本	1.103.0 或更新版本
工作類別	部署

共用方式為