Создание агентов построения и работа с ними
Для использования Team Foundation Build у команды должен быть по крайней мере один агент построения. Агент построения выполняет операции построения, требующие значительных ресурсов процессора. К таким операциям относится получение файлов из системы управления версиями, подготовка рабочей области, компиляция кода, выполнение тестов и возврат файлов в систему управления версиями. Каждый агент построения выделяется для отдельного контроллера построений, который им управляет.
Перед началом установки
В дополнение к различным способам использования агентов построения, следует также знать об их роли в системе построения. Дополнительные сведения см. в разделе Основные сведения о системе построения Team Foundation Build.
Агент построения размещается на компьютере построения. Поэтому, перед созданием и началом работы с агентом построения, необходимо настроить компьютер построения. На каждом компьютере построения можно разместить один или несколько агентов построения. Дополнительные сведения см. в разделе Настройка компьютера построения.
Содержание раздела
Необходимые разрешения
Создание агента построения
Изменение агента построения
Диалоговое окно "Свойства агента построения"
- Дополнительные сведения о свойстве рабочей папки
Использование агента построения для выполнения тестов
Установка дополнительного программного обеспечения
Установка программного обеспечения, необходимого для компиляции кода
Установка программного обеспечения, необходимого для выполнения других задач
Присвоение агенту построения тегов
Удаление агента построения
Необходимые разрешения
Для выполнения данной процедуры, необходимо быть членом группы Администраторы на компьютере построения и иметь разрешение Объединение источников построения со значением Разрешить. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
Создание агента построения
Создание агента построения
Войдите в систему компьютера построения, на котором требуется создать агента построения.
В меню Пуск выберите Все программы, Microsoft Team Foundation Server 2010 и Консоль администрирования Team Foundation.
Отобразится окно Консоль администрирования Team Foundation.
В панели с иерархической структурой разверните имя сервера и выберите узел Team Foundation Build.
На панели содержания появятся сведения о компьютере построения.
При отсутствии сообщения Служба построений настроена для... см. раздел Настройка компьютера построения.
Щелкните Новый агент.
Появится диалоговое окно Свойства агента построения. Дополнительные сведения см. в подразделе Свойства агента построения ниже в этом разделе.
По окончании изменения свойств агента нажмите кнопку ОК.
Щелкните ссылку Пуск при ее появлении непосредственно под именем агента построения.
Изменение агента построения
Изменять агента построения можно как с клиентского компьютера, так и непосредственно на компьютере построения, на котором находится агент построения.
Изменение агента построения с клиентского компьютера
В приложении Visual Studio откройте меню Построение и выберите пункт Управление контроллерами построений.
На экране появится диалоговое окно Управление контроллерами построений.
Выберите агента построения, который следует изменить, щелкните Свойства.
Появится диалоговое окно Свойства агента построения.
Изменение агента построения на компьютере построения
Войдите в систему компьютера построения, где запущен контроллер или агент построений, в который требуется внести изменения.
В меню Пуск выберите Все программы, Microsoft Team Foundation Server 2010 и Консоль администрирования Team Foundation.
Отобразится окно Консоль администрирования Team Foundation.
В панели с иерархической структурой разверните имя сервера и выберите узел Team Foundation Build.
Щелкните Свойства непосредственно под именем агента построения, которого необходимо изменить.
Появится диалоговое окно Свойства агента построения.
Диалоговое окно "Свойства агента построения"
Помимо свойств, влияющих на функции агента построения, в диалоговом окне Свойства агента построения можно просмотреть или изменить отображаемое имя и описание.
Отображаемое имя, описание
Укажите имя и описание, которое может облегчить поиск и получение необходимых сведений об агенте построения для участников команды.
Контроллер
Укажите контроллер построений для управления этим агентом построения. Контроллер построений может выполняться на одном компьютере с этим агентом построения или на другом компьютере построения.
Имя компьютера
В этом поле отображается имя компьютера построения, на котором находится агент построения.
Рабочая папка
Воспользуйтесь этим полем для указания пути к рабочей папке. Дополнительные сведения см. в разделе Дополнительные сведения о свойстве рабочей папки.
Служба агента построения активирована
Установите этот флажок, чтобы запустить этого агента построения или снимите флажок, чтобы сделать его не активным и остановить назначение ему построений.
Совет
Во время обслуживания компьютера построения агента построения желательно отключить.
Дополнительные сведения о свойстве рабочей папки
Агент построения использует рабочую папку для операций, связанных с чтением или записью файлов. Например, исходные файлы копируются в подкаталоги этой папки, а двоичные файлы создаются и хранятся в других подкаталогах этой папки.
Токены рабочей папки
Указание пути с помощью токена — это более гибкий подход, чем указание пути для свойства Рабочей папки (например, c:\temp\build\). Можно использовать два вида токенов:
Переменные среды. Переменные среды содержат сведения о среде для системы и пользователя, вошедшего в систему.
Например, Служба построения Team Foundation настроен для выполнения под учетной записью BuildSvcAcct. В качестве рабочей папки для агента построения на компьютере построения под управлением Windows Server 2008 указывается токен $(HomeDrive)\Builds. В результате, в качестве рабочей папки агент построения обычно будет использовать папку, расположенную по следующему пути: C:\Builds.
Совет
Чтобы вывести список переменных среды на компьютере построения, откройте командную строку и введите set.
Переменные построения Team Foundation: в рабочем каталоге агента построения можно использовать нижеуказанные переменные.
$(BuildAgentId) — автоматически генерируемое целое число, являющееся уникальным идентификатором агента построения в коллекции командного проекта.
$(BuildAgentName) — Отображаемое имя агента построения.
$(BuildDefinitionId) — автоматически генерируемое целое число, являющееся уникальным идентификатором определения построения в коллекции командного проекта.
$(BuildDefinitionPath) — имя командного проекта и имя определения построения, разделенные обратной косой чертой.
Пример рабочей папки
Например, имеем агента построения с именем BuildBot3. В командном проекте CoolApp определены два построения с именами NightlyBuild и WeeklyBuild. В поле Рабочая папка укажите значение $(SystemDrive)\TeamBuilds\$(BuildAgentName)\$(BuildDefinitionPath). В результате, агент построения BuildBot3 создает и использует две рабочих папки, а именно:
C:\TeamBuilds\BuildBot3\CoolApp\NightlyBuild
C:\ TeamBuilds\BuildBot3\CoolApp\WeeklyBuild
Ограничение длины имени рабочей папки
При выборе рабочей папки необходимо учитывать, что пути к этой папке, формируемые агентом построения, не должны превышать 259 символов. В противном случае построения завершатся сбоем с регистрацией следующей ошибки: TF10128: путьфизический_путь содержит более 259 разрешенных символов. Введите или выберите более короткий путь. Ошибка может быть неожиданной, так как физические пути, формируемые агентом, не всегда можно проследить.
Чтобы решить эту проблему, можно указать рабочую папку, физический путь к которой короче. Например, можно указать такую директорию: $(HOMEDRIVE)\bld\$(BuildAgentID)\$(BuildDefinitionID), что приведет к формированию приблизительно такого пути: c:\bld\3\2\.
Подкаталоги, созданные в рабочей папке
Агент построения создает следующие подкаталоги по такому пути и работает в них.
Подкаталог |
Используется для хранения файлов... |
|---|---|
Sources |
Читается агентом построения, например, исходные файлы. Загружаемые им файлы указываются в настройках Рабочая область каждого определения построения. Дополнительные сведения см. в разделе Работа с рабочими областями построений. |
Binaries |
Скомпилированный агентом построения, например, скомпилированные файлы приложения. |
TestResults |
Созданный любыми тестами, выполненными агентом построения. |
Использование агента построения для выполнения тестов
Можно разработать процесс построения, выполняющий один или несколько автоматических тестовых запусков. Как показано в следующей таблице, для некоторых видов тестов и тестовых операций необходим агент построения, удовлетворяющий специальным требованиям.
Тип тестов |
На компьютер построения должен быть установлен Visual Studio 2010. |
Другие требования и сведения |
|---|---|---|
Покрытие кода |
Да |
Отсутствуют |
Закодированные тесты пользовательского интерфейса |
Да |
Компьютер построения должен работать как интерактивный процесс. Дополнительные сведения о настройке компьютера построения такого типа см. в разделе Настройка компьютера построения. Дополнительные сведения о таких видах тестов см. в разделе Тестирование пользовательского интерфейса с помощью автоматических тестов пользовательского интерфейса. |
Создание данных для теста базы данных |
Нет |
Отсутствуют |
Модульные тесты базы данных. |
Да |
Отсутствуют |
Обычные тесты |
Нет |
Отсутствуют Дополнительные сведения см. в разделе Создание автоматического теста, запускающегося в виде исполняемого файла с помощью обычных тестов. |
Нагрузочные тесты |
Да |
Отсутствуют Дополнительные сведения см. в разделе Настройка последовательности выполнения тестов с помощью упорядоченных тестов. |
Модульные тесты MSTest |
Нет |
Отсутствуют |
Упорядоченные тесты |
Нет |
Отсутствуют |
Анализ влияния на тесты |
Нет |
Отсутствуют |
Веб-тесты |
Да |
Отсутствуют |
Дополнительные сведения об определении процесса построения для запуска тестов см. в разделе Использование системы построения для работы с тестами.
Установка дополнительного программного обеспечения
Чтобы агент построения выполнял определенные задачи, на компьютер построения возможно придется установить дополнительное программное обеспечение.
Установка программного обеспечения, необходимого для компиляции кода
Для построения большинства наиболее типичных проектов, агенту построения не требуется дополнительное программное обеспечение. Например, без установки дополнительного программного обеспечения агент построения может компилировать базовое приложение на языке Visual C# WPF.
Для компиляции проектов других типов необходимо установить дополнительное программное обеспечение. Например, для компиляции проекта установки, необходимо установить Visual Studio.
Убедитесь, что агент построения может компилировать проекты
Установите любую версию и выпуск Visual Studio, используемые командой на компьютере построения, на котором выполняется агент построения.
Установите любое другое программное обеспечение и компоненты, которые установлены в среде разработки и необходимы для построения приложения.
Установка программного обеспечения, необходимого для выполнения других задач
Для выполнения агентом построения других задач, на компьютере построения может понадобиться установить дополнительное программное обеспечение. В следующей таблице показаны некоторые стандартные задачи агента построения и программное обеспечение, необходимое для выполнения этих задач.
Чтобы агент построения... |
На компьютер агента построения необходимо установить такое программное обеспечение... |
|---|---|
Построение проектов веб-приложений ASP.NET |
Visual Studio 2010 |
Построение проектов C++ |
Visual Studio 2010 |
Присвоение агенту построения тегов
По мере роста масштаба системы построения, может возникнуть необходимость в определении специализированных агентов построения. Если у агента построения есть специальные возможности или он предназначен для особого использования, этому агенту следует назначить один или несколько тегов. В таком случае, при создании участником команды определения построения, для которого требуется определенный вид агента построения, он может указать тег в определении построения.
К агенту построения можно применить более одного тега. Например, можно создать агента построения с тегами x86 и выпуск, чтобы указать агента, установленного для компиляции конфигурации выпуска 32-разрядного приложения.
При выполнении нескольких агентов построения на одном компьютере построения, вероятно, они все будут иметь одинаковые возможности. Таким образом, может возникнуть необходимость в применении одинаковых тегов ко всем агентам построения на одном компьютере построения.
Использование тегов для представления возможностей агента построения
В следующей таблице приведены примеры имен тегов и возможности агента построения, которые они представляют.
К агенту построения применяются такие теги... |
Для идентификации агента построения, который может... |
|---|---|
x86 |
Компиляция 32-разрядных приложений |
x64 |
Компиляция 64-разрядных приложений |
IIS |
Компилирование веб-приложения ASP.NET с последующим размещением на компьютере построения, на котором выполняется агент построения |
тест, нагрузка |
Агент построения, выполняемый на компьютере построения, на котором установлен Test Professional 2010 для выполнения нагрузочного тестирования стабильности и производительности. |
Использование тегов для распределения нагрузки процесса построения
Теги можно использовать для распределения нагрузки в ходе выполнения построения, которое должна выполнить команда. Например, может быть одно определение построения с названием "Построение возврата", которое проверяет возвраты. (Дополнительные сведения см. в разделе Определение построения с условным возвратом для проверки изменений.) Это определение построения выполняется часто и одновременно может выполняться только один его экземпляр. Поэтому, настройте компьютер построения с оборудованием с высокой производительностью (например, скоростной многоядерный процессор и жесткий диск). Затем на таком компьютере построения создайте агента построения и присвойте ему возврат тега. Определение построения настроено для выполнения только агента построения с возвратом тега.
Другое определение построения с именем "Fast Track Build" используется для выполнения построения по проекту с первостепенным значением, над которым работает команда. Настраивается другой агент построения, который отвечает требованиям конкретного проекта. Присвойте ему тег "FastTrack", а затем настройте определение построения для выполнения только агента построения с этим тегом.
Применение тегов к агенту построения с клиентского компьютера
В меню Построение выберите пункт Управление контроллерами построений.
На экране появится диалоговое окно Управление контроллерами построений.
Выберите агента построения, к которому следует применить тег, щелкните Свойства.
Появится диалоговое окно Свойства агента построения.
Для применения одного или нескольких тегов, выполните одно из следующих действий:
Выберите из списка один или несколько тегов.
Щелкните ссылку Добавить новый тег. В диалоговом окне Добавить новый тег введите имя применяемого тега.
Применение тегов к агенту построения на компьютере построения
Войдите в систему компьютера построения, где запущен контроллер или агент построений, в который требуется внести изменения.
В меню Пуск выберите Все программы, Microsoft Team Foundation Server 2010 и Консоль администрирования Team Foundation.
Отобразится окно Консоль администрирования Team Foundation.
В панели с иерархической структурой разверните имя сервера и выберите узел Team Foundation Build.
Непосредственно под именем агента построения щелкните пункт Свойства.
Появится диалоговое окно Свойства агента построения.
Для применения одного или нескольких тегов, выполните одно из следующих действий:
Выберите из списка один или несколько тегов.
Щелкните ссылку Добавить новый тег. В диалоговом окне Добавить новый тег введите имя применяемого тега.
Удаление агента построения
Удалить агента построения можно как с компьютера клиента, так и непосредственно с компьютера построения, на котором находится агент построения.
Примечание Удаление агента построения не приводит к удалению Служба построения Team Foundation с компьютера построения.
Удаление агента построения с компьютера клиента
В меню Построение выберите пункт Управление контроллерами построений.
На экране появится диалоговое окно Управление контроллерами построений.
Выберите контроллер построений или агент построения, который следует удалить, и щелкните Удалить.
Удаление агента построения с компьютера построения
Войдите в систему компьютера построения, где запущен контроллер или агент построений, в который требуется внести изменения.
В меню Пуск выберите Все программы, Microsoft Team Foundation Server 2010 и Консоль администрирования Team Foundation.
Отобразится окно Консоль администрирования Team Foundation.
В панели с иерархической структурой разверните имя сервера и выберите узел Team Foundation Build.
Непосредственно под именем агента построения щелкните Удалить.
См. также
Другие ресурсы
Определение процесса построения
Журнал изменений
Дата |
Журнал |
Причина |
|---|---|---|
|
Май 2011 |
Добавлены сведения о выполнении тестов. |
Улучшение информации. |