Развертывание и настройка агентов построения

Чтобы использовать Team Foundation Build, команда должна иметь по крайней мере один агент построения для выполнения ресурсозатратной работы в процессе построения.

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

Агент построения выполняет шаги процесса построения, которые содержатся в действии AgentScope.К таким операциям относится получение файлов из системы управления версиями, подготовка рабочей области, компиляция кода, выполнение тестов и слияние файлов обратно в систему управления версиями.

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

Совет
Если коллекция командных проектов размещена на Team Foundation Service и потребности команды можно удовлетворить одним стандартным агентом построения, можно воспользоваться Размещенный контроллер построений вместо развертывания собственного агента построения.

Необходимые разрешения

Необходимо быть членом группы "Администраторы Windows" на сервере построений и членом группы "Администраторы построений коллекции проектов" в коллекции командных проектов.Дополнительные сведения см. в разделе Разрешения Team Foundation Server.

Выполняемые задачи

• Создание или изменение агента построения

• Установите Visual Studio и другое программное обеспечение для включения компиляции и другие возможности

• Задание рабочего каталога

• Включение агента построения для выполнения тестов

• Назначение тегов для представления возможностей агента построения или целей

• Развертывание агента построения, который может компилировать и тестировать приложение Магазина Windows

• Удаление агента построения

Создание или изменение агента построения

Создание или изменение агента построений с сервера построений

1. Войдите в систему сервера построения, который требуется настроить.

2. Из Windows Пуск запустите Консоль администрирования Team Foundation.

   Отобразится окно Консоль администрирования Team Foundation.

3. В области дерева консоли администрирования Team Foundation разверните имя сервера и выберите узел Конфигурация построения.

   На панели содержания появятся сведения о сервере построения.

   Если отображается сообщение Настройка установленных компонентов, см. раздел Развертывание сервера построений.

4. На странице Конфигурация построения:

   • Чтобы создать новый агент построения, выберите Создать агент.

   • Изменение существующего агента построения

     

     выберите Свойства.

   Появится диалоговое окно Свойства агента построения.

Изменение агента построения из Visual Studio

1. В Visual Studio в Team Explorer:

   1. Если вы еще не подключены к командному проекту из коллекции командных проектов, подключитесь к командному проекту.

   2. Выберите Главная, а затем выберите Построения.

2. На странице "Построения" выберите Действия и Управление контроллерами построения.

   На экране появится диалоговое окно Управление контроллерами построений.

   

3. Выберите агент построения, который следует изменить, щелкните Свойства.

   Появится диалоговое окно Свойства агента построения.

Отображаемое имя, Описание. Введите имя и описание, чтобы помочь участникам команды легко определить агент построения.

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

В разделах ниже содержатся дополнительные сведения о настройке агента построения.

Установите Visual Studio и другое программное обеспечение для включения компиляции и другие возможности

Рекомендуется устанавливать в агенте построений версию Visual Studio, используемую вашей командой на компьютерах разработки.Дополнительные сведения см. в разделе Установка Visual Studio.Установите также любое другое программное обеспечение и компоненты, которые установлены на компьютерах разработки и необходимы для построения приложения.В противном случае могут возникнуть проблемы, например некоторые проекты кода не удастся скомпилировать.

Задание рабочего каталога

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

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

Использование маркеров рабочего каталога

Указание пути с помощью маркера — это более простой и надежный подход, чем указание пути для свойства Рабочей папки (например, c:\temp\build\).Можно использовать два вида токенов:

• Переменные среды
  Переменные среды содержат сведения о среде для системы и пользователя, вошедшего в систему.Самая обычная переменная — SYSTEMDRIVE, однако в некоторых ситуациях могут использоваться такие переменные, как USERNAME или HOMEPATH.

  Совет
  Чтобы вывести список переменных среды на сервере построения, откройте командную строку и введите set.

• Переменные Team Foundation Build
  Можно использовать следующие переменные в рабочем каталоге агента построения:

  • $(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: The pathPhysicalPath contains more than the allowed 259 characters. Type or select a shorter path.

Чтобы решить эту проблему, можно указать рабочую папку, физический путь к которой короче.Например, можно указать $(ДИСК_ДОМАШНЕЙ_ПАПКИ)\bld\$(ИД_агента_построений)\$(ИД_определения_построений), что даст нам следующий рабочий каталог: c:\bld\3\2\.

Подкаталоги, созданные в рабочем каталоге

Агент построения создает следующие подкаталоги по такому пути и работает в них.

Подкаталог	Используется для хранения файлов...
Sources	Читается агентом построения, например, исходные файлы.Загружаемые им файлы указываются в настройках Рабочая область каждого определения построения.Дополнительные сведения см. в разделе Работа с рабочими областями построений.
Binaries	Скомпилированный агентом построения, например, скомпилированные файлы приложения.
TestResults	Созданный любыми тестами, выполненными агентом построения.

Включение агента построения для выполнения тестов

Можно определить процесс построения, выполняющий один или несколько тестовых запусков.

Важно
Множество видов тестов и тестовых операций требуют установки в агенте построения той же версии Visual Studio, которая используется рабочей группой на компьютерах разработки.Дополнительные сведения см. в разделе Установка Visual Studio.

Агент построения может выполняться:

• Покрытие кода

• Кодированные тесты ИП (требуется сервер построений, выполняемый в интерактивном режиме).См. разделы Выполнение сервера построений в интерактивном режиме и Тестирование пользовательского интерфейса с помощью автоматических закодированных тестов пользовательского интерфейса.)

• Создание данных для теста базы данных

• Модульные тесты базы данных.

• Обычные тесты

• Нагрузочные тесты

• Модульные тесты

• Упорядоченные тесты

• Анализ влияния на тесты

• Веб-тесты

Назначение тегов для представления возможностей агента построения или целей

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

Можно присвоить теги из диалогового окна Свойства агента построения, описанного выше.Затем можно применить тегик определениям построений.

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

Можно применить следующий тег...	Для идентификации агента построения, который может...
x86	Компиляция 32-разрядных приложений
x64	Компиляция 64-разрядных приложений
тест проверки построений	Выполните тесты проверки построения, которые выполняются в ночном построении проверки построения.
WindowsStore	Компиляция и тестирование приложения Магазина Windows.
IIS	Компилирование веб-приложения ASP.NET с последующим размещением на компьютере, на котором выполняется агент построения.
интерактивные	Выполните задачи, требующие агента на сервере построений, выполняемом в интерактивном режиме.

К агенту построения можно применить более одного тега.Например, можно создать агента построения с тегами x86 и выпуск, чтобы указать агента, установленного для компиляции конфигурации выпуска 32-разрядного приложения.

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

Удаление агента построения

1. В Visual Studio откройте диалоговое окно Управление контроллерами построения, как описано выше в разделе Создание или изменение агента построений.

2. Выберите агент построения, который следует удалить, щелкните Удалить.

Совет
Можно также использовать консоль администрирования Team Foundation для удаления агентом построения после входа на сервер построения.

Следующие шаги

• Масштабирование системы построений Team Foundation
  По мере увеличения численности рабочей группы и базы кода можно инкрементно расширять систему построений относительно легко.

• Управление системой построения.
  Иногда необходимо отслеживать и управлять системой построения.

• Используйте систему построения для компиляции, тестирования и развертывания приложения
  После того как система построения на месте, команда готова к созданию простого процесса построения (например, построение непрерывной интеграции) и использования функций автоматизированного построения и тестирования приложения.