Действия рабочего процесса Lab Management
При настройке шаблона рабочего процесса Lab Management (LabDefaultTemplate.11.xaml), можно использовать одну или несколько стандартных действий Lab Management.Кроме того, можно использовать объекты, создаваемые мастером Lab Management.В этой теме представлено описание действий и объектов Team Foundation Lab Management, доступных при настройке шаблона рабочего процесса для создания, развертывания и тестирования приложения.Сведения об использовании этих действий в настраиваемом рабочем процессе см. в разделе Настройка рабочего процесса Lab Management.
Требования
- Visual Studio Ultimate, Visual Studio Premium, Visual Studio Test Professional
В этом разделе содержатся следующие подразделы.
Действия Lab Management
В следующей таблице описаны отдельные свойства рабочего процесса Lab Management.
Действие |
Описание |
|---|---|
Создает новую среду из сохраненного шаблона и развертывает ее в заданной группе узлов. |
|
Удаление среды. |
|
Удаляет снимок среды. |
|
Создает тестовый запуск в среде и ожидает его окончания. |
|
Создает файл средства просмотра среды с идентификатором ссылки на снимок.Он используется для подключения к снимку среды. |
|
Возвращает расположение и номер построения для сценария создания, развертывания и тестирования. |
|
Возвращает для среды маркер использования. |
|
Получает идентификатор снимка среды. |
|
Получение состояния среды. |
|
Получает URI среды для заданного имени среды и имени расположения лаборатории. |
|
Анализирует сведения в скрипте развертывания, заданные свойством |
|
Сбрасывает для среды маркер использования. |
|
Восстанавливает среду из указанного снимка. |
|
Запускает скрипт развертывания.При сбое выдает предупреждение построения в соответствии со свойством ThrowOnError. |
|
Размещает в очереди новый рабочий процесс в контроллере построений на сервере построений. |
|
Создает новую среду и хранит ее в общей папке библиотеки командного проекта. |
|
Задает для среды маркер использования. |
|
Создание снимка среды. |
|
Запуск среды. |
|
Остановка среды. |
|
Ожидает готовность среды к тестированию в течение заданного максимального времени.Если в конце периода ожидания среда к тестированию не готова, создается исключение истечения времени. |
|
Тип рабочего процесса. |
|
Ожидает завершения построения в очереди в течение заданного максимального времени ожидания.Если рабочий процесс построения не завершается за заданное максимальное время, создается исключение TimeOutException.Действие периодически проверяет состояние построения в очереди с целью определения завершенных построений.Этот интервал задается свойством RefreshInterval. |
|
Записывает сведения о развертывании, входящие в сводку построения. |
.gif "Ff934562.collapse_all(ru-ru,VS.110).gif")
CreateLabEnvironment
Создает новую среду из сохраненного шаблона и развертывает ее в заданной группе узлов.Это длительное действие, которое ждет создания новой среды.Если создание новой лабораторной среды невозможно, это действие создает исключение LabDeploymentProcessException.
Свойства
LabEnvironmentName |
Имя новой среды.Если это свойство имеет значение NULL или оно пустое, будет использоваться имя шаблона среды. |
LabEnvironmentTemplateUri |
URI шаблона хранимой среды.URI шаблона лабораторной среды можно получить с помощью действия GetLabEnvironmentUri.Обязательное. |
TeamProjectHostGroupName |
Группа узлов, в которой будет развернута новая среда.Если указанная группа узлов не найдена, создается исключение NoTeamProjectHostGroupFoundException.Обязательное. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
DeleteLabEnvironment
Удаление среды.Это длительное действие, которое ждет удаления среды.Если удаление лабораторной среды завершается сбоем, это действие создает исключение LabDeploymentProcessException.
Свойства
LabEnvironmentUri |
URI удаляемой среды.URI лабораторной среды можно получить с помощью действия GetLabEnvironmentUri.Обязательное. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
DeleteSnapshot
Удаляет снимок среды.Это длительное действие, которое ждет удаления снимка.Если удаление снимка завершается сбоем, это действие создает исключение LabDeploymentProcessException.
Свойства
LabEnvironmentUri |
URI лабораторной среды, чей снимок был удален.URI лабораторной среды можно получить с помощью действия GetLabEnvironmentUri.Обязательное. |
SnapshotId |
Идентификатор удаляемого снимка.Идентификатор снимка можно получить с помощью действия GetLabEnvironmentSnapshotId.Обязательное. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
ExecuteRemoteTestRun
Создает тестовый запуск в среде и ожидает его окончания.Это длительное действие, которое ждет окончания тестирования или истечения времени ожидания.Время ожидания задается свойством MaxWaitTime.Это действие периодически проверяет состояние тестового запуска в очереди с целью определения завершенных тестовых запусков.Этот интервал задается свойством RefreshInterval.С помощью свойства MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion можно задавать количество последовательных случаев игнорирования ошибок Team Foundation Server во время проверки состояния тестового запуска.
Возвращаемое значение
Объект TestRunStatistics, хранящий сведения о тестовом запуске.
Свойства
BuildNumber |
Номер построения, для которого выполняются тесты. |
LabEnvironmentUri |
URI среды, в которой будут выполняться тестовые случаи.URI среды можно получить с помощью действия GetLabEnvironmentUri. |
MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion |
Максимальное количество последовательных сбоев, которые должны игнорироваться, когда действие ожидает выполнения тестов.Значение этого свойства по умолчанию равно 3. |
MaxWaitTime |
Объект TimeSpan, задающий максимальное время ожидания окончания тестового запуска.В конце заданного периода ожидания создается исключение истечения времени.Значение по умолчанию 0 (нуль), что соответствует бесконечному ожиданию действия. |
RefreshInterval |
Объект TimeSpan, задающий интервал, после которого обновляется состояние тестового запуска.Значение по умолчанию для этого интервала составляет 60 секунд. |
TestDirectory |
Путь к тестовым исполняемым файлам. |
TestEnvironment |
Имя тестовой среды, в которой будут выполняться тестовые случаи. |
TestParameters |
Объект RunTestDetails, задающий такие параметры, как план тестирования, набор тестов, параметры тестирования и конфигурация теста.Обязательное. |
Заголовок |
Имя тестового запуска.Обязательное. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
GenerateEnvironmentViewerFile
Создает файл средства просмотра среды, содержащий идентификатор ссылки на снимок.Это действие используется для подключения к снимку среды.Имя файла средства просмотра среды является именем снимка без специальных символов: @"\[\`~\!@\#$%^&\*()+=\[{\\\]}|\\\\;:',/?\]" + "\"".
Свойства
FilePath |
Путь UNC для хранения файла средства просмотра среды.Учетная запись службы построения должна иметь следующие разрешения на запись для пути.Обязательное. |
LabEnvironmentUri |
URI среды.URI среды можно получить с помощью действия GetLabEnvironmentUri.Обязательное. |
SnapshotId |
Идентификатор снимка.Идентификатор снимка можно получить с помощью действия GetLabEnvironmentSnapshotId.Если снимок является недопустимым, создается исключение InvalidSnapshotException.Обязательное. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
GetBuildLocationAndBuildNumber
Возвращает расположение и номер построения для сценария создания, развертывания и тестирования.Если выбрано "командное построение" и значение URI построения равно NULL, выбирается последнее работоспособное построение, а сведения возвращаются.Если работоспособное построение не найдено, создается исключение System.ArgumentException.Если "командное построение" не выбрано, возвращается только расположение построения, заданное пользователем.
Возвращаемое значение
Объект String, определяющий расположение построения.
Свойства
BuildDetails |
Объект Microsoft.TeamFoundation.Lab.Workflow.Activities.BuildDetails, содержащий связанные с построением сведения в сценарии создания, развертывания и тестирования. |
BuildNumber |
Номер выбранного построения.Это outArgument.Значение NULL для построений, отличных от командных. |
SelectedBuild |
Сведения о построении для сервера построений.Это outArgument.Значение NULL для построений, отличных от командных. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
GetLabEnvironmentInUseMarker
Получает для среды маркер использования.
Возвращаемое значение
LabEnvironmentInUseMarker, задающий сведения о маркере среды
Свойства
LabEnvironmentUri |
URI среды.Для получения URI среды следует использовать действие GetLabEnvironmentUri.Обязательное. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
GetLabEnvironmentSnapshotId
Получает идентификатор снимка среды.Если снимок с указанным именем не найден, это действие создает исключение NoSnapshotFoundException.
Возвращаемое значение
Объект Int64, задающий идентификатор снимка.
Свойства
LabEnvironmentUri |
URI среды.Для получения URI среды следует использовать действие GetLabEnvironmentUri.Обязательное. |
SnapshotName |
Имя снимка.Обязательное. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
GetLabEnvironmentStatus
Получает состояние среды.
Возвращаемое значение
Перечисленное значение LabEnvironmentState, которое указывает на текущее состояние среды.
Свойства
LabEnvironmentUri |
URI среды.Для получения URI среды следует использовать действие GetLabEnvironmentUri.Обязательное. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
GetLabEnvironmentUri
Получает URI среды для заданного имени среды и имени расположения лаборатории.Лаборатория может располагаться в группе узлов или в общей папке библиотеки.Если среда не найдена, это действие создает исключение LabEnvironmentNotFoundException.
Возвращаемое значение
Объект String, задающий URI среды.
Свойства
LabEnvironmentName |
Имя среды.Обязательное. |
ProjectName |
Имя командного проекта.Если значение этого свойства равно NULL или не задано, используется текущий проект построения. |
TeamProjectLabLocationName |
Имя расположения лаборатории.Может быть именем группы узлов или именем общей папки библиотеки.Если расположение лаборатории не найдено, создается исключение NoLabLocationFoundException.Обязательное. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
InitializeAgentSpecAndEnvironmentVariables
Инициализирует аргументы, необходимые для действия RunDeploymentScript.InitializeAgentSpecAndEnvironmentVariables извлекает свойства виртуальных машин в среде, необходимые для скрипта развертывания на машинах.
Возвращаемое значение
Объект ScriptDetails, хранящий необходимые для развертывания сведения о скрипте.
Свойства
BuildLocation |
Путь к построению.Используется для расширения макроса $(BuildLocation).Обязательное. |
DeploymentScriptDetails |
Сведения о развертывании в формате "имя лабораторной системы | аргументы скрипта | рабочая папка".Обязательное. |
LabEnvironmentUri |
URI среды.Для получения URI среды следует использовать действие GetLabEnvironmentUri.Обязательное. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
ResetLabEnvironmentInuseMarker
Сбрасывает для среды маркер использования.
Свойства
LabEnvironmentUri |
URI среды.Для получения URI среды следует использовать действие GetLabEnvironmentUri.Обязательное. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
RestoreLabEnvironment
Восстанавливает среду из указанного снимка.Если снимок является недопустимым, действие выдает исключение InvalidSnapshotException.
Свойства
LabEnvironmentUri |
URI среды.Для получения URI среды следует использовать действие GetLabEnvironmentUri.Обязательное. |
SnapshotId |
Идентификатор снимка, из которого восстанавливается среда.Идентификатор снимка можно получить с помощью действия GetLabEnvironmentSnapshotId.Обязательное. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
RunDeploymentScript
Запускает скрипт развертывания.При сбое скрипта выдается предупреждение построения в соответствии со свойством ThrowOnError.
Возвращаемое значение
Перечисленное значение BuildStatus, задающее состояние операции развертывания.
Свойства
MaximumAttemptsForNetUse |
Максимальное количество попыток добавления сетевого использования. |
ScriptDetails |
Объект "Сведения о скрипте" для лабораторной системы.Обязательное. |
SharedLocationForNetUse |
Расположение, к которому должна иметь доступ учетная запись службы лаборатории. |
ThrowOnError |
Флаг, определяющий необходимость создания исключения для ошибки.Значение по умолчанию — true. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
RunWorkflow
Размещает в очереди новый рабочий процесс в контроллере построений на сервере построений.Существует два способа указания контроллера построения, в котором построение должно быть поставлено в очередь.
Используйте свойство LabEnvironmentUri.Если в этой среде предполагается интеграция рабочих процессов, для постановки рабочих процессов в очередь будет использоваться ее контроллер построений.В противном случае создается исключение LabDeploymentProcessException.
Контроллер построений задается с помощью свойства BuildControler.
Возвращаемое значение
Объект Int32, задающий идентификатор построения в очереди.
Свойства
BuildController |
Имя контроллера построений.Если значения этого свойства и свойства LabEnvironmentUri равны NULL или не заданы, для размещения построения в очереди используется текущий контроллер построений. |
BuildDefinition |
Определение построения, размещаемого в очереди.Обязательное. |
LabEnvironmentUri |
URI среды с возможностями рабочих процессов.Для получения URI среды следует использовать действие GetLabEnvironmentUri.Обязательное. |
ProjectName |
Имя командного проекта.Если значение этого свойства равно NULL или не задано, используется текущий проект построения. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
SaveLabEnvironment
Создает новую среду и хранит ее в общей папке библиотеки командного проекта.Это длительное действие, которое ждет сохранения среды.Если создание новой среды завершается сбоем, это действие создает исключение LabDeploymentProcessException.
Возвращаемое значение
Объект String, задающий URL-адрес новой среды.
Свойства
LabEnvironmentName |
Имя сохраненной среды.Если это свойство имеет значение NULL или оно пустое, будет использоваться имя среды. |
LabEnvironmentUri |
URI сохраняемой среды.Для получения URI среды следует использовать действие GetLabEnvironmentUri.Обязательное. |
TeamProjectLibraryShareName |
Общая папка библиотеки, в которой хранится среда.Если указанная общая папка библиотеки не найдена, создается исключение NoTeamProjectLibraryShareFoundException.Обязательное. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
SetLabEnvironmentInuseMarker
Задает для среды маркер использования.
Свойства
Комментарий |
Комментарий записан при заданном маркере. |
LabEnvironmentUri |
URI среды.Для получения URI среды следует использовать действие GetLabEnvironmentUri.Обязательное. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
SnapshotLabEnvironment
Создание снимка среды.Это длительное действие, которое ждет создания снимка среды.Если создание снимка завершается сбоем, это действие создает исключение LabDeploymentProcessException.
Возвращаемое значение
Значение Int64, задающее идентификатор снимка.
Свойства
LabEnvironmentUri |
URI среды, снимок которой следует сделать.Для получения URI среды следует использовать действие GetLabEnvironmentUri.Обязательное. |
SnapshotChainId |
Возвращает идентификатор цепочки снимков. |
SnapshotName |
Имя снимка, который следует сделать.Если значение этого свойства равно NULL, в качестве имени снимка используется текущее значение DateTime. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
StartLabEnvironment
Запуск среды.Это длительное действие, которое ждет запуска среды.Если запуск среды завершается сбоем, это действие создает исключение LabDeploymentProcessException.
Свойства
LabEnvironmentUri |
URI среды.Для получения URI среды следует использовать действие GetLabEnvironmentUri.Обязательное. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
StopLabEnvironment
Остановка среды.Это длительное действие, которое ждет остановки среды.Если остановка среды завершается сбоем, это действие создает исключение LabDeploymentProcessException.
Свойства
LabEnvironmentUri |
URI среды.Для получения URI среды следует использовать действие GetLabEnvironmentUri.Обязательное. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
WaitForTestCapabilityServices
Ожидает готовность среды к тестированию в течение заданного максимального времени.Если в конце периода ожидания среда к тестированию не готова, создается исключение истечения времени.Если задано свойство RepairCapabilityBeforeWaitBegins, восстановление вызывается перед ожиданием готовности.Максимальное время ожидания задается свойством MaxWaitTime.
Свойства
LabEnvironmentUri |
URI среды.Для получения URI среды следует использовать действие GetLabEnvironmentUri.Обязательное. |
MaxWaitTime |
Объект System.TimeSpan, задающий максимальное время ожидания готовности.В конце заданного периода ожидания создается исключение истечения времени.Значение по умолчанию равно 0 (нулю), что означает неограниченное время ожидания. |
RepairCapabilityBeforeWaitBegins |
Если это значение задано как true, будет сделана попытка восстановления перед ожиданием. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
WaitForWorkflow
Ожидает завершения построения в очереди в течение заданного максимального времени ожидания.Если рабочий процесс построения не завершается за заданное максимальное время, создается исключение TimeOutException.Действие периодически проверяет состояние построения в очереди с целью определения завершенных построений.Этот интервал задается свойством RefreshInterval.
Возвращаемое значение
Значение перечисления BuildStatus, обозначающее состояние рабочего процесса.
Свойства
AllowPartiallySucceededBuild |
Если значение задано как true, частичный успех считается достаточным для успешного завершения действия. |
BuildDetails |
Объект Microsoft.TeamFoundation.Build.Client.IBuildDetail, содержащий сведения о построении в очереди на сервере построений.Это выходной аргумент. |
LabWorkflowType |
Тип рабочего процесса. |
MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion |
Максимальное количество последовательных сбоев, которые должны игнорироваться при ожидании завершения рабочего процесса.Значение по умолчанию - 3.С помощью этого свойства можно повысить надежность рабочего процесса. |
MaxWaitTime |
Объект System.TimeSpan, задающий максимальное время завершения рабочего потока.В конце заданного периода ожидания создается исключение истечения времени.Значение по умолчанию равно 0 (нулю), что означает неограниченное время ожидания. |
QueueBuildId |
Идентификатор построения в очереди.Обязательное. |
RefreshInterval |
Объект System.TimeSpan, задающий интервал, после которого обновляется состояние рабочего процесса.Значение по умолчанию для этого интервала составляет 60 секунд. |
ThrowOnError |
Если значение задано как true, при сбое построения создается исключение. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
WaitForWorkflowCapabilityServices
Ожидает готовность рабочего процесса к тестированию в течение заданного максимального времени.Если в конце периода ожидания рабочий процесс не готов, создается исключение истечения времени.Если задано свойство RepairCapabilityBeforeWaitBegins, восстановление вызывается перед ожиданием готовности.Максимальное время ожидания задается свойством MaxWaitTime.
Свойства
LabEnvironmentUri |
URI среды.Для получения URI среды следует использовать действие GetLabEnvironmentUri.Обязательное. |
MaxWaitTime |
Объект System.TimeSpan, задающий максимальное время ожидания готовности.В конце заданного периода ожидания создается исключение истечения времени.Значение по умолчанию равно 0 (нулю), что означает неограниченное время ожидания. |
RepairCapabilityBeforeWaitBegins |
Если это значение задано как true, будет сделана попытка восстановления перед ожиданием. |
WaitForComputerNames |
Если это значение задано как true, система ожидает, пока не станут доступными имена компьютеров всех виртуальных машин. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
WriteDeploymentInformation
Записывает сведения о развертывании, входящие в сводку построения.В разделе сведений о развертывании имеется три подраздела: построение, развертывание и тестирование.Сведения о развертывании можно добавить в соответствующий подраздел с помощью свойства DeploymentInformationType.Ссылки на сведения о развертывании можно добавить с помощью Url.
Свойства
Сообщение |
Сообщение, отображаемое в сводке.Обязательное. |
Url |
Необязательный URL-адрес или ссылка, добавляемая в сообщение. |
DeploymentInformationType |
Задает подраздел сведений о развертывании для этого информационного сообщения.Необходимо использовать одно из следующих значений.
|
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
Классы управления лабораторной средой
В следующей таблице представлена сводная информация о классах управления лабораторной средой, которые можно использовать в конструкторе рабочих процессов для настройки создания, развертывания и тестирования.Классы входят в пространство имен Microsoft.TeamFoundation.Lab.Workflow.Activities.
Объект. |
Описание |
|---|---|
Класс LabWorkflowDetails содержит данные о конфигурации из мастера "Параметры рабочих процессов лаборатории".Объект LabWorkflowDetails содержит объекты BuildDetails, RunTestDetails и ScriptDetails. |
|
Хранит сведения о построении для сценария создания, развертывания и тестирования. |
|
Хранит сведения о параметрах тестирования, необходимые для создания автоматического тестового запуска в рабочем процессе создания, развертывания и тестирования. |
|
Хранит сведения, необходимые для определения лабораторной среды в сценарии создания, развертывания и тестирования. |
|
Хранит сведения о маркере использования среды. |
|
Задает текущее состояние среды. |
|
Хранит сведения о параметрах тестирования, необходимые для создания автоматического тестового запуска. |
|
Хранит сведения о скрипте развертывания, необходимые для сценария создания, развертывания и тестирования. |
|
Хранит сведения о тестовом запуске. |
LabWorkflowDetails
Класс LabWorkflowDetails содержит данные о конфигурации из мастера "Параметры рабочих процессов лаборатории".В LabDefaultTemplate объект LabWorkflowDetails рабочего процесса находится в аргументеLabWorkflowParameters.Класс LabWorkflowDetails содержит следующие свойства.
BuildDetails |
Объект BuildDetails, создаваемый мастером рабочих процессов и хранящий сведения о построении для сценария создания, развертывания и тестирования. |
DeploymentDetails |
Объект LabEnvironmentDetails, создаваемый мастером рабочих процессов и хранящий сведения, необходимые для развертывания построения в сценарии создания, развертывания и тестирования. |
EnvironmentDetails |
Объект LabEnvironmentDetails, создаваемый мастером рабочих процессов и хранящий сведения, определяющие среду, которая должна использоваться для сценария создания, развертывания и тестирования. |
TestParameters |
Объект RunTestDetails, создаваемый мастером рабочих процессов и хранящий сведения о параметрах тестирования, необходимые для создания автоматического тестового запуска. |
BuildDetails
Объект BuildDetails хранит сведения о построении для сценария создания, развертывания и тестирования.
Свойства
IsTeamSystemBuild |
Объект Boolean, определяющий, является ли используемое построение командным. |
BuildDefinitionUri |
Объект Uri, задающий URI определения построения. |
BuildDefinitionName |
Объект String, задающий имя определения построения. |
QueueNewBuild |
Объект Boolean, определяющий необходимость постановки нового построения в очередь. |
BuildUri |
Объект Uri, задающий URI построения, если построение является командным. |
CustomBuildPath |
Объект String, задающий путь к построению, если построение не является командным. |
Конфигурация. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
DeploymentDetails
Объект DeploymentDetails хранит сведения о параметрах тестирования, необходимые для создания автоматического тестового запуска в рабочем процессе создания, развертывания и тестирования.Доступ к объекту DeploymentDetails, создаваемому мастером Lab Management, можно получить с помощью свойства DeploymentDetails аргумента LabWorkflowParameters Argument.
Свойства
PostDeploymentSnapshotPath |
Объект String, содержащий путь хранения к снимку после развертывания. |
PostDeploymentSnapshotName |
Объект String, задающий имя снимка, сделанного после развертывания. |
TakePostDeploymentSnapshot |
Объект Boolean, определяющий необходимость снимка после развертывания. |
Скрипты |
Объект StringList, содержащий список виртуальных машин с соответствующими скриптами развертывания. |
DeploymentNeeded |
Объект Boolean, определяющий необходимость развертывания. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
LabEnvironmentDetails
Объект LabEnvironmentDetails хранит сведения, необходимые для определения лабораторной среды в сценарии создания, развертывания и тестирования.Доступ к объекту LabEnvironmentDetails, создаваемому мастером рабочих процессов Lab Management, можно получить с помощью свойства EnvironmentDetails аргумента LabWorkflowParameters Argument.
Свойства
ProjectName |
Объект String, задающий имя командного проекта. |
LabEnvironmentName |
Объект String, задающий имя лабораторной среды. |
NewLabEnvironmentName |
Объект String, задающий имя создаваемой лабораторной среды. |
HostGroupName |
Объект String, задающий имя группы узлов, в которой развертывается среда. |
LabLibraryShareName |
Объект String, задающий имя общей папки библиотеки, содержащей шаблон хранимой лабораторной среды. |
RevertToSnapshot |
Объект Boolean, определяющий необходимость отката до снимка. |
SnapshotName |
Объект String, задающий имя снимка среды, до которого выполняется откат. |
TfsUrl |
Объект String, задающий URL-адрес Team Foundation Server. |
LabEnvironmentUri |
Объект Uri, задающий URI выбранной среды. |
Disposition |
LabEnvironmentDisposition перечислило значение, указывающее состояние среды.Возможные значения: Unknown — состояние среды неизвестно. Active — среда развернута на узле и может быть запущена. Stored — среда хранится в общей папке библиотеке и не может быть использована до развертывания. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
RunTestDetails
Объект RunTestDetails хранит сведения о параметрах тестирования, необходимые для создания автоматического тестового запуска в рабочем процессе создания, развертывания и тестирования.Доступ к объекту RunTestDetails, создаваемому мастером Lab Management, можно получить с помощью свойства TestParameters аргумента LabWorkflowParameters Argument.
Свойства
TfsUrl |
Объект String, задающий URL-адрес Team Foundation Server. |
Имя проекта |
Объект String, задающий имя командного проекта. |
TestConfigurationId |
Объект Int32, задающий идентификатор конфигурации теста для тестового запуска. |
TestPlanId |
Объект Int32, задающий идентификатор плана тестирования. |
TestSuiteIdList |
Объект Systems.Collections.Generic.List, содержащий числовые идентификаторы запускаемых наборов тестов. |
TestSettingsId |
Объект Int32, задающий идентификатор параметров тестирования для тестового запуска. |
RunTest |
Объект Boolean, определяющий необходимость запуска теста. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
ScriptDetails
Предоставляет сведения скриптам развертывания.Объект ScriptDetails необходим при добавлении действия RunDeploymentScript в конструктор рабочих процессов.Объект InitializeAgentSpecAndEnvironmentVariables возвращает объект ScriptDetails.
Свойства
LabSystemName |
Объект String, задающий имя лабораторной среды. |
AgentSpec |
Объект AgentReservationSpec, содержащий теги, которые связаны с агентом построения в лабораторной системе. |
FileName |
Объект String, задающий имя файла скрипта развертывания. |
Аргументы |
Объект String, определяющий аргументы, передаваемые скрипту развертывания. |
WorkingDirectory |
Объект String, задающий рабочую папку для скрипта развертывания в лабораторной системе. |
EnvironmentVariables |
Объект System.Collection.Generic.IDictionary, содержащий пары имя-значения среды. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
TestRunStatistics
Хранит сведения о тестовом запуске.Объект TestRunStatistics возвращается действием ExecuteRemoteTestRun.
Свойства
TotalTests |
Объект Int32, задающий общее количество тестов при тестовом запуске. |
PassedTests |
Объект Int32, задающий количество успешно выполненных тестов при тестовом запуске. |
FailedTests |
Int32, указывающее число тестов, завершившихся с ошибкой в тестовом запуске. |
InconclusiveTests |
Int32, указывающее количество тестов, которые были безытоговы в тестовом запуске. |
PendingTests |
Объект Int32, задающий количество еще не выполненных тестов при тестовом запуске. |
AbortedTests |
Int32, указывающее количество тестов, прерванных в тестовом запуске. |
InProgressTests |
Объект Int32, задающий количество выполняемых в настоящий момент тестов при тестовом запуске. |
TestRunStatus |
Перечисленное значение TestRunState, задающее состояние тестового запуска. |
TestRunId |
Объект Int32, задающий идентификатор тестового запуска. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
LabEnvironmentInUseMarker
Хранит сведения о маркере использования среды.Чтобы вернуть объект LabEnvironmentInUseMarker, следует использовать действие GetLabEnvironmentInUseMarker.
Свойства
Пользователь |
Объект String, определяющий пользователя, пометившего среду. |
Отметка времени |
Объект DateTime, определяющий время, когда пользователь пометил среду. |
Комментарий |
Объект String, заданный пользователем, пометившим среду. |
b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top
LabEnvironmentState
Перечисление, определяющее текущее состояние среды.Состояние лабораторной среды, как правило, определяется состоянием находящихся в ней виртуальных машин.Если состояние всех виртуальных машин стабильно, значение LabEnvironmentState соответствует этому состоянию.В противном случае значение равно Mixed или Failed.Когда операция выполняется в среде, лабораторная среда находится в переходном состоянии, что указывает на выполняемую в данный момент операцию.
Для LabEnvironmentState предусмотрены следующие значения:
Нет данных
Создается
Сбой при создании
CreateCancelling
Обновляется
Хранимая среда
Запускается
Работает
Приостанавливается
Приостановлено
Останавливается
Остановлен
Создается снимок
DeletingSnapshot
Восстанавливается из снимка
Удаление
DeleteFailed
Deleted
Mixed
Сбой
Переносится