AzureResourceGroupDeployment@1 — задача развертывания группы ресурсов Azure версии 1

Статья
2025-02-24

Используйте эту задачу для развертывания, запуска, остановки и удаления групп ресурсов 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 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 (запуск виртуальных машин), Stop (остановка виртуальных машин), Restart (перезапуск виртуальных машин), 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, 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. Значение по умолчанию: 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-адреса шаблона. Пример. <blob_storage_url>/template.json?<SAStoken> Чтобы отправить файл параметров в учетную запись хранения и создать маркер SAS, используйте задачу копирования файлов Azure или выполните действия с помощью PowerShell или Azure CLI.

Чтобы просмотреть параметры шаблона в сетке, щелкните … рядом с текстовым полем переопределения параметров шаблона. Эта функция требует включения правил CORS в источнике. Если шаблоны находятся в BLOB-объекте хранилища Azure, обратитесь к совместному использованию ресурсов между источниками, чтобы включить CORS.

overrideParameters - переопределение параметров шаблона
string. Необязательно. Используется при action = Create Or Update Resource Group.

Задает параметры шаблона для переопределения.

Чтобы просмотреть параметры шаблона в сетке, щелкните ... рядом с текстовым полем "Переопределение параметров". Эта функция требует включения правил CORS в источнике. Если шаблоны находятся в большом двоичном объекте хранилища Azure, обратитесь к этой строке, чтобы включить 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 (только проверка), Incremental, Complete. Значение по умолчанию: Incremental.

Режим Incremental обрабатывает развертывания как добавочные обновления для группы ресурсов. Он оставляет неизменными ресурсы, которые существуют в группе ресурсов, но не указаны в шаблоне.

Complete режим удаляет ресурсы, которые не находятся в шаблоне. Полный режим занимает относительно больше времени, чем добавочный режим. Если время ожидания задачи истекло, рассмотрите возможность увеличения времени ожидания или изменения в режиме Incremental.

Предупреждение

Полный режим удаляет все существующие ресурсы в группе ресурсов, которые не указаны в шаблоне. Проверьте, не содержит ли развернутая группа ресурсов какие-либо необходимые ресурсы, которые не указаны в шаблоне.

режим Validate позволяет находить проблемы с шаблоном перед созданием фактических ресурсов.

Примечание.

Режим Validate всегда создает группу ресурсов, даже если ресурсы не развернуты.

Дополнительные сведения о режимах развертывания .

enableDeploymentPrerequisitesForCreate - включить необходимые компоненты развертывания
boolean. Необязательно. Используется при action = Create Or Update Resource Group. Значение по умолчанию: false.

Применимо только в том случае, если группа ресурсов содержит виртуальные машины.

При выборе параметра "Группа развертывания" агент группы развертывания настраивается на каждой из виртуальных машин.

Выбор параметра WinRM настраивает прослушиватель удаленного управления Windows (WinRM) по протоколу HTTPS через порт 5986 с помощью самозаверяющего сертификата. Эта конфигурация необходима для выполнения операции развертывания на компьютерах Azure. Если целевые виртуальные машины поддерживаются подсистемой балансировки нагрузки, убедитесь, что правила NAT для входящего трафика настроены для целевого порта (5986).

enableDeploymentPrerequisitesForSelect - включить необходимые компоненты развертывания
boolean. Необязательно. Используется при action = Select Resource Group. Значение по умолчанию: false.

Применимо только в том случае, если группа ресурсов содержит виртуальные машины.

outputVariable - группы ресурсов
string.

Требуется при выборе существующей группы ресурсов. Предоставляет имя переменной группы ресурсов. Переменная может использоваться в качестве $(variableName) для ссылки на группу ресурсов в последующих задачах, например в задаче PowerShell на целевых компьютерах для развертывания приложений.

Допустимо только в том случае, если выбранное действие Create, Updateили Select.

Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.

Выходные переменные

Нет.

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
требования	Локальные агенты должны иметь возможности , которые соответствуют следующим требованиям требуют выполнения заданий, использующих эту задачу: azureps
возможностей	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Любое
переменные settable	Любое
Версия агента	1.103.0 или более поздней версии
Категория задач	Внедрять