AzureResourceGroupDeployment@1 - Azure 资源组部署 v1 任务

使用此任务部署、启动、停止和删除 Azure 资源组。

此任务已弃用;使用 AzureResourceGroupDeployment@2

语法

# 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 资源管理器) 、 ConnectedServiceNameClassic (Azure 经典) 。 默认值:ConnectedServiceName

必需。 选择包含部署的 Azure 订阅的服务连接。


ConnectedServiceName - Azure 订阅
string. 当 ConnectedServiceNameSelector = ConnectedServiceName 时,需要此选项。

必需。 选择包含部署的 Azure 订阅的服务连接。


ConnectedServiceNameClassic - Azure 经典订阅
string. 当 ConnectedServiceNameSelector = ConnectedServiceNameClassic 时,需要此选项。

选择用于部署的 Azure 经典订阅。


action - 行动
string. 当 ConnectedServiceNameSelector = ConnectedServiceName 时,需要此选项。 允许的值:、、、 (Start 虚拟机) 、 Stop (Stop 虚拟机) 、 Restart (Restart 虚拟机) 、 Delete (Delete 虚拟机) DeleteRG 、 (Delete Resource Group) 。 StartSelect Resource GroupCreate Or Update Resource Group 默认值: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、、、Brazil SouthCanada CentralCanada EastCentral USJapan WestEast AsiaEast US 2 East USCentral IndiaJapan EastNorth Central USSouth IndiaSouth Central USSoutheast AsiaWest EuropeWest Central USNorth EuropeUK WestUK SouthWest India、、West US、 。 West US 2Australia Southeast 默认值:East US

要部署资源组的位置。 如果订阅中已存在资源组,则将忽略此值。


csmFile - 模板
string. 当 action = Create Or Update Resource Group 时,需要此选项。

指定指向 Azure 资源管理器模板的路径或模式。 详细了解 Azure 资源管理器模板。 若要立即开始,请使用 此示例模板


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 文件复制 任务或使用 PowerShellAzure 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 目标计算机任务中。

仅当所选操作为 CreateUpdateSelect时有效。


任务控制选项

除了任务输入,所有任务都有控制选项。 有关详细信息,请参阅 控制选项和常见任务属性

输出变量

无。

要求

要求 说明
管道类型 YAML、经典版本、经典版本
运行平台 Agent、DeploymentGroup
需求 自承载代理必须具有满足以下要求的功能才能运行使用此任务的作业:azureps
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任意
可设置变量 任意
代理版本 1.103.0 或更高版本
任务类别 部署