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


DeployVisualStudioTestAgent@2 — задача развертывания агента тестирования Visual Studio версии 2

Важно!

Эта задача устарела и будет прекращена 31 января 2024 г. Используйте задачу Visual Studio Test для выполнения модульных и функциональных тестов.

Важно!

DeployVisualStudioTestAgent@2 не рекомендуется. Используйте задачу Visual Studio Test для выполнения модульных и функциональных тестов.

Синтаксис

# Visual Studio test agent deployment v2
# DeployVisualStudioTestAgent@2 is deprecated. Use the Visual Studio Test task to run unit and functional tests.
- task: DeployVisualStudioTestAgent@2
  inputs:
  # Test Machines
    testMachines: # string. Required. Machines. 
    adminUserName: # string. Required. Admin login. 
    adminPassword: # string. Required. Admin password. 
    winRmProtocol: 'Http' # 'Http' | 'Https'. Required. Protocol. Default: Http.
    #testCertificate: true # boolean. Optional. Use when winRmProtocol = Https. Test Certificate. Default: true.
  # Agent Configuration
    machineUserName: # string. Required. Username. 
    machinePassword: # string. Required. Password. 
    #runAsProcess: false # boolean. Run UI tests. Default: false.
    #isDataCollectionOnly: false # boolean. Enable data collection only. Default: false.
  # Advanced
    #testPlatform: '14.0' # '15.0' | '14.0'. Test agent version. Default: 14.0.
    #agentLocation: # string. Test agent location. 
    #updateTestAgent: false # boolean. Update test agent. Default: false.
# Visual Studio Test Agent Deployment v2
# DeployVisualStudioTestAgent@2 is deprecated. Use the Visual Studio Test task to run unit and functional tests.
- task: DeployVisualStudioTestAgent@2
  inputs:
  # Test Machines
    testMachines: # string. Required. Machines. 
    adminUserName: # string. Required. Admin login. 
    adminPassword: # string. Required. Admin password. 
    winRmProtocol: 'Http' # 'Http' | 'Https'. Required. Protocol. Default: Http.
    #testCertificate: true # boolean. Optional. Use when winRmProtocol = Https. Test Certificate. Default: true.
  # Agent Configuration
    machineUserName: # string. Required. Username. 
    machinePassword: # string. Required. Password. 
    #runAsProcess: false # boolean. Run UI tests. Default: false.
    #isDataCollectionOnly: false # boolean. Enable data collection only. Default: false.
  # Advanced
    #testPlatform: '14.0' # '15.0' | '14.0'. Test agent version. Default: 14.0.
    #agentLocation: # string. Test agent location. 
    #updateTestAgent: false # boolean. Update test agent. Default: false.

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

testMachines - Машины
string. Обязательный.

Эти входные данные имеют три варианта:

  • Предоставляет разделенный запятыми список IP-адресов или полных доменных имен компьютеров вместе с портами. Порт по умолчанию основан на выбранном протоколе. Например, dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986.
  • Предоставляет выходную переменную других задач. Например, $(variableName).
  • Предоставляет имя группы компьютеров. Если вы используете ПРОТОКОЛ HTTPS, имя или IP-адрес компьютера должны соответствовать cn в сертификате.

adminUserName - Администратор входа
string. Обязательный.

Указывает имя входа администратора для целевых компьютеров.


adminPassword - Администратор пароль
string. Обязательный.

Указывает пароль администратора для целевых компьютеров. Эти входные данные могут принимать переменную, определенную в определениях сборки или выпуска как $(passwordVariable). Вы можете пометить тип переменной как secret безопасный.


winRmProtocol - Протокол
string. Обязательный. Допустимые значения: Http, Https. Значение по умолчанию: Http.

Указывает протокол, используемый для подключения WinRM к компьютерам. Значение по умолчанию — HTTPS.


testCertificate - Тестовый сертификат
boolean. Необязательный элемент. Используйте при winRmProtocol = Https. Значение по умолчанию: true.

Предоставляет возможность пропуска проверки подлинности сертификата компьютера доверенным центром сертификации. Параметр является обязательным для протокола HTTPS WinRM.


machineUserName - Пользователя
string. Обязательный.

Указывает имя пользователя, с которым должен выполняться агент тестирования.


machinePassword - Пароль
string. Обязательный.

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


runAsProcess - Запуск тестов пользовательского интерфейса
boolean. Значение по умолчанию: false.

Указывает, должен ли агент тестирования выполняться как интерактивный процесс. Эти входные данные необходимы для закодированных тестов пользовательского интерфейса.


isDataCollectionOnly - Включение только сбора данных
boolean. Значение по умолчанию: false.

Необязательный элемент. Указывает, используется ли агент тестирования только для сбора данных, а не для выполнения тестов. Обычно это можно найти в приложении в группе компьютеров тестирования (AUT).


testPlatform - Версия агента тестирования
string. Допустимые значения: 15.0 (Visual Studio 2017), 14.0 (Visual Studio 2015). Значение по умолчанию: 14.0.

Указывает версию агента тестирования Visual Studio. Выбирает подходящую версию в соответствии с версией VS с помощью созданных тестовых двоичных файлов.


agentLocation - Расположение агента тестирования
string.

Необязательный элемент. Предоставляет путь к vstf_testagent.exe из сети или локального расположения. Если путь не указан, он будет автоматически скачан из центра загрузки. Установите агент тестирования 2015 с обновлением 3.
Установите Test Agent 2017.


updateTestAgent - Обновление агента тестирования
boolean. Значение по умолчанию: false.

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


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

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

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

Нет.

Remarks

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

  • Поддержка агента тестирования Visual Studio 2017. Теперь можно развертывать и выполнять тесты с помощью нескольких версий агента тестирования Visual Studio. Поддерживаются версии 2015 и 2017.
  • Группы компьютеров, созданные из центра тестирования, больше не поддерживаются. Вы можете продолжать использовать список компьютеров или групп ресурсов Azure.

Требования

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