Поделиться через

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

  • Статья

Разверните шаблон Azure Resource Manager (ARM) в группе ресурсов и управляйте виртуальными машинами.

Развертывание шаблона Azure Resource Manager (ARM) в группе ресурсов. Вы также можете запускать, останавливать, удалять и отменять выделение всех Виртуальные машины в группе ресурсов.

Синтаксис

# Azure resource group deployment v2
# Deploy an Azure Resource Manager (ARM) template to a resource group and manage virtual machines.
- task: AzureResourceGroupDeployment@2
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'StopWithDeallocate' | 'Restart' | 'Delete' | 'DeleteRG'. Required. Action. Default: Create Or Update Resource Group.
    resourceGroupName: # string. Required. Resource group. 
    #location: # string. Required when action = Create Or Update Resource Group. Location. 
  # Template
    #templateLocation: 'Linked artifact' # 'Linked artifact' | 'URL of the file'. Required when action = Create Or Update Resource Group. Template location. Default: Linked artifact.
    #csmFileLink: # string. Required when templateLocation = URL of the file && action = Create Or Update Resource Group. Template link. 
    #csmParametersFileLink: # string. Optional. Use when templateLocation = URL of the file && action = Create Or Update Resource Group. Template parameters link. 
    #csmFile: # string. Required when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override template parameters. 
    #deploymentMode: 'Incremental' # 'Incremental' | 'Complete' | 'Validation'. Required when action = Create Or Update Resource Group. Deployment mode. Default: Incremental.
  # Advanced deployment options for virtual machines
    #enableDeploymentPrerequisites: 'None' # 'None' | 'ConfigureVMwithWinRM' | 'ConfigureVMWithDGAgent'. Optional. Use when action = Create Or Update Resource Group || action = Select Resource Group. Enable prerequisites. Default: None.
    #teamServicesConnection: # string. Alias: deploymentGroupEndpoint. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Team project. 
    #deploymentGroupName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. Password. 
    #outputVariable: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group. VM details for WinRM. 
  # Advanced
    #deploymentName: # string. Optional. Use when action = Create Or Update Resource Group. Deployment name. 
    #deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group. Deployment outputs. 
    #addSpnToEnvironment: false # boolean. Optional. Use when action = Create Or Update Resource Group. Access service principal details in override parameters. Default: false.
    #useWithoutJSON: false # boolean. Optional. Use when action = Create Or Update Resource Group. Use individual output values without JSON.Stringify applied. Default: false.

# Azure resource group deployment v2
# Deploy an Azure Resource Manager (ARM) template to a resource group and manage virtual machines.
- task: AzureResourceGroupDeployment@2
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'StopWithDeallocate' | 'Restart' | 'Delete' | 'DeleteRG'. Required. Action. Default: Create Or Update Resource Group.
    resourceGroupName: # string. Required. Resource group. 
    #location: # string. Required when action = Create Or Update Resource Group. Location. 
  # Template
    #templateLocation: 'Linked artifact' # 'Linked artifact' | 'URL of the file'. Required when action = Create Or Update Resource Group. Template location. Default: Linked artifact.
    #csmFileLink: # string. Required when templateLocation = URL of the file && action = Create Or Update Resource Group. Template link. 
    #csmParametersFileLink: # string. Optional. Use when templateLocation = URL of the file && action = Create Or Update Resource Group. Template parameters link. 
    #csmFile: # string. Required when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override template parameters. 
    #deploymentMode: 'Incremental' # 'Incremental' | 'Complete' | 'Validation'. Required when action = Create Or Update Resource Group. Deployment mode. Default: Incremental.
  # Advanced deployment options for virtual machines
    #enableDeploymentPrerequisites: 'None' # 'None' | 'ConfigureVMwithWinRM' | 'ConfigureVMWithDGAgent'. Optional. Use when action = Create Or Update Resource Group || action = Select Resource Group. Enable prerequisites. Default: None.
    #teamServicesConnection: # string. Alias: deploymentGroupEndpoint. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Team project. 
    #deploymentGroupName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. Password. 
    #outputVariable: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group. VM details for WinRM. 
  # Advanced
    #deploymentName: # string. Optional. Use when action = Create Or Update Resource Group. Deployment name. 
    #deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group. Deployment outputs. 
    #addSpnToEnvironment: false # boolean. Optional. Use when action = Create Or Update Resource Group. Access service principal details in override parameters. Default: false.

# Azure Resource Group Deployment v2
# Deploy an Azure resource manager (ARM) template to a resource group. You can also start, stop, delete, deallocate all Virtual Machines (VM) in a resource group.
- task: AzureResourceGroupDeployment@2
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'StopWithDeallocate' | 'Restart' | 'Delete' | 'DeleteRG'. Required. Action. Default: Create Or Update Resource Group.
    resourceGroupName: # string. Required. Resource group. 
    #location: # string. Required when action = Create Or Update Resource Group. Location. 
  # Template
    #templateLocation: 'Linked artifact' # 'Linked artifact' | 'URL of the file'. Required when action = Create Or Update Resource Group. Template location. Default: Linked artifact.
    #csmFileLink: # string. Required when templateLocation = URL of the file && action = Create Or Update Resource Group. Template link. 
    #csmParametersFileLink: # string. Optional. Use when templateLocation = URL of the file && action = Create Or Update Resource Group. Template parameters link. 
    #csmFile: # string. Required when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override template parameters. 
    #deploymentMode: 'Incremental' # 'Incremental' | 'Complete' | 'Validation'. Required when action = Create Or Update Resource Group. Deployment mode. Default: Incremental.
  # Advanced deployment options for virtual machines
    #enableDeploymentPrerequisites: 'None' # 'None' | 'ConfigureVMwithWinRM' | 'ConfigureVMWithDGAgent'. Optional. Use when action = Create Or Update Resource Group || action = Select Resource Group. Enable prerequisites. Default: None.
    #teamServicesConnection: # string. Alias: deploymentGroupEndpoint. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Azure Pipelines/TFS service connection. 
    #teamProject: # string. Alias: project. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Team project. 
    #deploymentGroupName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. Password. 
    #outputVariable: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group. VM details for WinRM. 
  # Outputs
    #deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group. Deployment outputs.

Входные данные

azureSubscription - Подписка Azure
Входной псевдоним: ConnectedServiceName. string. Обязательный.

Выбирает подключение службы, содержащее подписку Azure для развертывания.


action - Действий
string. Обязательный. Допустимые значения: Create Or Update Resource Group, Select Resource Group (Настройка параметров развертывания виртуальной машины), Start (Запуск виртуальных машин), Stop (Остановка виртуальных машин), StopWithDeallocate (Остановка и освобождение виртуальных машин), Restart (Перезапуск виртуальных машин), Delete (Удаление виртуальных машин), DeleteRG (Удаление группы ресурсов). Значение по умолчанию: Create Or Update Resource Group.

Действие, выполняеме с ресурсами Или группой ресурсов Azure.


resourceGroupName - Группа ресурсов
string. Обязательный.

Предоставляет имя группы ресурсов.


location - Расположение
string. Требуется при .action = Create Or Update Resource Group

Расположение для развертывания группы ресурсов. Если группа ресурсов уже существует в подписке, это значение будет игнорироваться.


templateLocation - Расположение шаблона
string. Требуется при .action = Create Or Update Resource Group Допустимые значения: Linked artifact, URL of the file. Значение по умолчанию: Linked artifact.

Выберите связанный артефакт или URL-адрес файла.


csmFileLink - Ссылка на шаблон
string. Требуется при .templateLocation = URL of the file && action = Create Or Update Resource Group

Указывает URL-адрес файла шаблона. Пример URL-адреса: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.json

Чтобы развернуть шаблон, хранящийся в частной учетной записи хранения, получите и включите маркер подписанного URL-адреса (SAS) в URL-адрес шаблона. Пример: <blob_storage_url>/template.json?<SAStoken>

Чтобы отправить файл шаблона (или связанный шаблон) в учетную запись хранения и создать маркер SAS, используйте задачу копирования файлов Azure или выполните действия с помощью PowerShell или Azure CLI.

Чтобы просмотреть параметры шаблона в сетке ... , щелкните рядом с текстовым полем Переопределить параметры шаблона. Для использования этой функции требуется включить правила CORS в источнике. Если шаблоны находятся в большом двоичном объекте службы хранилища Azure, см. раздел Основные сведения о запросах CORS для включения CORS.


csmParametersFileLink - Ссылка на параметры шаблона
string. Необязательный элемент. Используйте при templateLocation = URL of the file && action = Create Or Update Resource Group.

Указывает URL-адрес файла параметров. Пример: https://raw.githubusercontent.com/Azure/...

Чтобы использовать файл, хранящийся в частной учетной записи хранения, извлеките и включите маркер подписанного URL-адреса (SAS) в URL-адрес шаблона. Пример. <blob_storage_url>/template.json?<SAStoken> Чтобы отправить файл параметров в учетную запись хранения и создать маркер SAS, можно использовать задачу копирования файлов Azure или выполнить действия с помощью PowerShell или Azure CLI.

Чтобы просмотреть параметры шаблона в сетке ... , щелкните рядом с текстовым полем Переопределить параметры шаблона. Для использования этой функции требуется включить правила CORS в источнике. Если шаблоны находятся в большом двоичном объекте службы хранилища Azure, см. раздел Основные сведения о запросах CORS для включения CORS.


csmFile - Шаблон
string. Требуется при .templateLocation = Linked artifact && action = Create Or Update Resource Group

Указывает путь или шаблон, указывающий на шаблон azure Resource Manager. Дополнительные сведения о шаблонах Resource Manager Azure. Чтобы сразу приступить к работе, используйте этот пример шаблона.


csmParametersFile - Параметры шаблона
string. Необязательный элемент. Используйте при templateLocation = Linked artifact && 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) в URL-адрес шаблона. Пример. <blob_storage_url>/template.json?<SAStoken> Чтобы отправить файл параметров в учетную запись хранения и создать маркер SAS, используйте задачу копирования файлов Azure или выполните действия с помощью PowerShell или Azure CLI.

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

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

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

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

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

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

Примечание

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

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


enableDeploymentPrerequisites - Включение необходимых компонентов
string. Необязательный элемент. Используйте при action = Create Or Update Resource Group || action = Select Resource Group. Допустимые значения: None, ConfigureVMwithWinRM (Настройка с помощью агента WinRM), ConfigureVMWithDGAgent (Настройка с помощью агента группы развертывания). Значение по умолчанию: None.

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

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

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


teamServicesConnection - Подключение службы Azure Pipelines
Входной псевдоним: deploymentGroupEndpoint. string. Требуется, если enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Указывает подключение службы для подключения к организации Или коллекции Azure DevOps для регистрации агента.

Вы можете создать подключение к службе с помощью +New и выбрать Token-based authentication. Вам потребуется личный маркер доступа (PAT) для настройки подключения к службе. Щелкните Manage , чтобы обновить сведения о подключении к службе.


teamServicesConnection - Подключение службы Azure Pipelines/TFS
Входной псевдоним: deploymentGroupEndpoint. string. Требуется, если enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Указывает подключение службы для подключения к организации Или коллекции Azure DevOps для регистрации агента.

Вы можете создать подключение к службе с помощью +New и выбрать Token-based authentication. Вам потребуется личный маркер доступа (PAT) для настройки подключения к службе. Щелкните Manage , чтобы обновить сведения о подключении к службе.


teamProject - Командный проект
Входной псевдоним: project. string. Требуется, если enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Указывает командный проект, определяющий группу развертывания.


deploymentGroupName - Группа развертывания
string. Требуется, если enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Указывает группу развертывания, в которой будут зарегистрированы агенты. Дополнительные сведения о группах развертывания.


copyAzureVMTags - Копирование тегов виртуальной машины Azure в агенты
boolean. Необязательный элемент. Используйте при enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Значение по умолчанию: true.

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

По умолчанию все теги Azure копируются в формате : Key: Value. Пример. Тег Role : Web Azure будет скопирован на компьютер агента как есть.

Узнайте больше об использовании тегов для ресурсов Azure.


runAgentServiceAsUser - Запуск службы агента от имени пользователя
boolean. Необязательный элемент. Используйте при enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Значение по умолчанию: false.

Запускает службу агента от имени пользователя, отличного от пользователя по умолчанию, если задано trueзначение .

Пользователь по умолчанию — NT AUTHORITY\\SYSTEM в Windows и root Linux.


userName - Имя пользователя
string. Требуется, если enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group.

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

Для пользователей домена укажите значения как domain\username или username@domain.com. Для локальных пользователей укажите username.

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


password - Пароль
string. Необязательный элемент. Используйте при enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group.

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

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

Он может принимать переменные, определенные в конвейерах сборки или выпуска, как $(passwordVariable). Вы можете пометить переменную как secret , чтобы защитить ее.

Для виртуальных машин Linux пароль не требуется и игнорируется.


outputVariable - Сведения о виртуальной машине для WinRM
string. Необязательный элемент. Используйте при enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group.

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

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


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

Указывает имя создаваемого развертывания группы ресурсов.


deploymentOutputs - Выходные данные развертывания
string. Необязательный элемент. Используйте при action = Create Or Update Resource Group.

Предоставляет имя выходной переменной, которая содержит раздел outputs текущего объекта развертывания в строковом формате. ConvertFrom-Json Используйте командлет PowerShell для анализа объекта JSON и доступа к отдельным выходным значениям.


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

Добавляет идентификатор субъекта-службы и ключ конечной точки Azure, выбранной в качестве среды выполнения скрипта. Переменные $servicePrincipalId и $servicePrincipalKey могут находиться в параметрах переопределения, таких как -key $servicePrincipalKey.


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

Отдельные выходные значения преобразуются с помощью JSON. Stringify по умолчанию. Если вы хотите использовать выходные значения без их преобразования с помощью JSON. Stringify, включите этот параметр. Дополнительные сведения см. в этой статье.


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

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

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

Нет.

Remarks

В разделе AzureResourceManagerTemplateDeployment@3 — задача развертывания шаблона ARM версии 3 доступна новая версия этой задачи.

Новые возможности задачи версии 2

  • Работает с кроссплатформенными агентами (Linux, macOS или Windows)
  • Поддерживает шаблоны JSON, расположенные по любым общедоступным URL-адресам http/https.
  • Улучшенный пользовательский интерфейс для переопределения параметров, которые теперь можно просматривать или изменять в сетке.
  • Сопоставление правил NAT для виртуальных машин, поддерживаемых подсистемой балансировки нагрузки.
  • Поле "Группа ресурсов" теперь переименовано в "Сведения о виртуальной машине для WinRM" и включено в раздел "Дополнительные параметры развертывания для виртуальных машин".
  • Ограничения
    • Классические подписки не поддерживаются. Поддерживаются только подписки ARM.
    • Синтаксис PowerShell не поддерживается, так как задача теперь node.js. При переопределении параметров шаблона убедитесь, что имена параметров параметров соответствуют регистру. Кроме того, удалите командлеты PowerShell, такие как ConvertTo-SecureString, при переходе с версии 1.0 на версию 2.0.

Устранение неполадок

Ошибка: внутренняя ошибка сервера

Эти проблемы в основном носят временный характер. Это может происходить по нескольким причинам:

  • Одна из служб Azure, которую вы пытаетесь развернуть, находится на обслуживании в регионе, в который вы пытаетесь выполнить развертывание. Следите https://status.azure.com/ за проверка простоями служб Azure.
  • Сама служба Azure Pipelines находится на обслуживании. Следите https://status.dev.azure.com/ за простоями.

В некоторых случаях это связано с ошибкой в шаблоне ARM, например, служба Azure, которую вы пытаетесь развернуть, не поддерживает регион, выбранный для ресурса.

Ошибка: время ожидания

Проблемы с временем ожидания могут возникать из двух мест:

  • Агент Azure Pipelines
  • Развертывание на портале

Вы можете определить, истекло ли время ожидания на портале, проверив ссылку развертывания портала, которая будет находиться в журналах задач. Если ссылки нет, скорее всего, проблема связана с агентом Azure Pipelines. Если ссылка есть, перейдите по ней, чтобы узнать, истекло ли время ожидания развертывания на портале.

Ошибка: правила CORS должны быть включены при переопределении параметров

Если на файл шаблона ссылается BLOB-объект, то при переопределении параметров в конвейере может появиться следующее предупреждение:

Warning: Failed to download the file from template path.

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

Помимо включения CORS убедитесь, что маркер SAS, указанный в ссылке шаблона, имеет значение "srt-sco". Этот маркер необходим для скачивания файла и продолжения работы.

Агент Azure Pipelines

Если проблема возникает из агента Azure Pipelines, можно увеличить время ожидания, установив значение timeoutInMinutes в качестве ключа в YAML значение 0. Дополнительные сведения см. в разделе Указание заданий в конвейере.

Развертывание на портале

Ознакомьтесь с этим документом о том, как определить, возникла ли ошибка из портал Azure: Просмотр журнала развертывания с помощью azure Resource Manager.

В случае развертывания портала попробуйте задать для параметра timeoutInMinutes в шаблоне ARM значение 0. Если значение не указано, предполагается, что оно равно 60 минутам. Значение 0 гарантирует, что развертывание будет выполняться до тех пор, пока оно может быть успешным.

Это также может произойти из-за временных проблем в системе. Следите https://status.dev.azure.com/ за проверка в случае простоя службы Azure Pipelines.

Ошибка: сбой проверки шаблона Azure Resource Manager (ARM)

Эта проблема чаще всего возникает из-за недопустимого параметра в шаблоне ARM, например, из-за неподдерживаемого номера SKU или региона. Если проверка завершается неудачно, проверьте сообщение об ошибке. В нем должны быть указаны ресурс и недопустимый параметр.

Эта проблема также может возникать из-за текста, состоящего из нескольких строк. Задача развертывания группы ресурсов Azure сейчас не поддерживает текст, состоящий из нескольких строк, в JSON-файле шаблона ARM или параметра.

Кроме того, ознакомьтесь со статьей о структуре и синтаксисе шаблонов ARM: общие сведения о структуре и синтаксисе шаблонов ARM.

Требования

Требование Описание
Типы конвейеров YAML, классическая сборка, классический выпуск
Выполняется в Агент, DeploymentGroup
Требования None
Capabilities Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд Любой
Устанавливаемые переменные Любой
Версия агента 2.119.1 или более поздней версии
Категория задач Развертывание