AzureVmssDeployment@0 — задача развертывания масштабируемого набора виртуальных машин Azure версии 0

Эта задача развертывает образ масштабируемого набора виртуальных машин.

Синтаксис

# Azure VM scale set deployment v0
# Deploy a virtual machine scale set image.
- task: AzureVmssDeployment@0
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Update image' # 'Update image' | 'Configure application startup'. Required. Action. Default: Update image.
    vmssName: # string. Required. Virtual Machine scale set name. 
    vmssOsType: # 'Windows' | 'Linux'. Required. OS type. 
  # Image Details
    #imageUrl: # string. Required when action = Update image || action = UpdateImage. Image URL. 
  # Configure start-up
    #customScriptsDirectory: # string. Optional. Use when action = Configure application startup || action = Update image || action = UpdateImage. Custom script directory. 
    #customScript: # string. Optional. Use when action = Configure application startup || action = Update image || action = UpdateImage. Command. 
    #customScriptArguments: # string. Optional. Use when action = Configure application startup || action = Update image || action = UpdateImage. Arguments. 
    #customScriptsStorageAccount: # string. Optional. Use when action = Configure application startup || action = Update image || action = UpdateImage. Azure storage account where custom scripts will be uploaded. 
  # Advanced
    #skipArchivingCustomScripts: false # boolean. Skip Archiving custom scripts. Default: false.

Входы

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

Указывает подписку Azure Resource Manager для масштабируемого набора.

action - действие
string. Обязательно. Допустимые значения: Update image (обновление масштабируемого набора виртуальных машин с помощью образа), Configure application startup (расширение настраиваемой виртуальной машины в масштабируемом наборе виртуальных машин). Значение по умолчанию: Update image.

Обновляет масштабируемый набор виртуальных машин по выбранному методу с помощью образа VHD и (или) запуска скриптов развертывания и установки с помощью расширения виртуальной машины пользовательского скрипта.

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

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

vmssName - имя масштабируемого набора виртуальных машин
string. Обязательно.

Указывает имя параметра масштабирования виртуальной машины для обновления. Используйте образ VHD или расширение пользовательской виртуальной машины скрипта.

типа ОС
string. Обязательно. Допустимые значения: Windows, Linux.

Указывает тип операционной системы масштабируемого набора виртуальных машин.

imageUrl - URL-адрес изображения
string. Требуется, если action = Update image || action = UpdateImage.

Указывает URL-адрес образа VHD. Если это URL-адрес BLOB-объекта хранилища Azure, расположение учетной записи хранения совпадает с расположением масштабируемого набора.

customScriptsDirectory - каталог пользовательских скриптов
string. Необязательный. Используется при action = Configure application startup || action = Update image || action = UpdateImage.

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

Команда customScript -
string. Необязательный. Используется при action = Configure application startup || action = Update image || action = UpdateImage.

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

Например:

1. Update-DatabaseConnectionStrings.ps1 -clusterType dev -user $(dbUser) -password $(dbUserPwd) обновляет строку подключения в web.config веб-приложения.
2. install-secrets.sh --key-vault-type prod -key serviceprincipalkey создает зашифрованный файл, содержащий ключ субъекта-службы.

customScriptArguments - аргументы
string. Необязательный. Используется при action = Configure application startup || action = Update image || action = UpdateImage.

Необязательный. Настраиваемый скрипт будет вызываться с переданными аргументами. Можно использовать переменные сборки и выпуска, что упрощает использование секретов.

customScriptsStorageAccount - учетной записи хранения Azure, в которой будут отправляться пользовательские скрипты
string. Необязательный. Используется при action = Configure application startup || action = Update image || action = UpdateImage.

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

skipArchivingCustomScripts - Пропускать настраиваемые скрипты архивации
boolean. Значение по умолчанию: false.

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

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

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

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

Никакой.

Замечания

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

Выполнение скрипта сообщается успешно, однако экземпляры VMSS не обновляются.

Масштабируемые наборы имеют политику обновления, которая определяет, как виртуальные машины будут доставлены up-to-date с последней моделью масштабируемого набора, и если политика обновления настроена вручную, необходимо вручную обновить каждую виртуальную машину. Дополнительные сведения см. в статье Как перенести виртуальные машины up-to-date с помощью последней модели масштабируемого набора. Вы можете изменить политику обновления или вручную обновить каждую виртуальную машину. Например, чтобы обновить политику до Automatic, используйте следующую команду Az CLI: az vmss update --set upgradePolicy.mode=Automatic -g <resource group name> -n <vmss name>

Ошибка: "Разрешение запрещено: скрипт не является исполняемым"

Эта проблема возникает, если вы пытаетесь запустить пользовательский скрипт, но скрипт не является исполняемым.

Чтобы устранить проблему, сначала убедитесь, что входные данные customScript не имеют ./ или ничего другого перед именем скрипта 'test.sh':

    customScript: 'test.sh'

Затем попробуйте добавить задачу командной строки перед задачей масштабируемого набора виртуальных машин:

    - task: CmdLine@2
      inputs:
        script: 'chmod 777 $(System.DefaultWorkingDirectory)/test.sh' 

Требования

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