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

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

  • Статья

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

Разверните шаблон Диспетчера ресурсов Azure (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 (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Team project. 
    #deploymentGroupName: # string. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. Password. 
    #outputVariable: # string. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && (enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None). 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 (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Team project. 
    #deploymentGroupName: # string. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. Password. 
    #outputVariable: # string. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && (enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None). 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 (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Azure Pipelines/TFS service connection. 
    #teamProject: # string. Alias: project. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Team project. 
    #deploymentGroupName: # string. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. Password. 
    #outputVariable: # string. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && (enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None). 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-адреса шаблона. Пример: <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-адреса шаблона. Пример: <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. Дополнительные сведения о шаблонах Azure Resource Manager. Чтобы сразу приступить к работе, используйте этот пример шаблона.


параметры шаблона 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-адреса шаблона. Пример. <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 позволяет находить проблемы с шаблоном перед созданием фактических ресурсов.

Заметка

Режим 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. Требуется, если (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent.

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

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


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

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

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


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

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


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

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


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

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

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

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


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

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

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


userName - имя пользователя
string. Требуется, если enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true.

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

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

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


password - пароль
string. Необязательный. Используется при enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true.

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

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

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

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


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

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

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


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

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


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

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


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

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


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

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


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

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

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

Никакой.

Замечания

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

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

  • Работает с кроссплатформенными агентами (Linux, macOS или Windows)
  • Поддерживает шаблоны JSONs, расположенные по любым общедоступным 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 для включения при переопределении параметров

Если файл шаблона ссылается из БОЛЬШОго двоичного объекта, при переопределении параметров в конвейере может появиться следующее предупреждение:

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 не поддерживает многостроковые строки в шаблоне ARM или json-файле параметра.

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

Требования

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