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


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

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

СоветСовет

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

Система с одним компьютером (автономная)

Для каждой коллекции командных проектов выделяется отдельный контроллер построений.Контроллер построений обычно выполняет наиболее легкую работу, такую как определение имени построения, создание метки в системе управления версиями, запись примечаний в журнал и составление отчета о состоянии построения.Контроллер построения использует действие AgentScope для делегирования ресурсоемкой работы, такой как компиляция кода, выполнение тестов, агентам построения в пуле.Эти агенты построений можно разместить на одном сервере построений или на разных.

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

Однако контроллер построений может запросить значительный объем памяти в определенных ситуациях, поэтому следует обеспечить достаточное количество памяти по мере необходимости, чтобы обеспечить его правильное функционирование.Или, в зависимости от потребностей и ресурсов команды, может потребоваться запустить контроллер построений на другом компьютере, чем для Team Foundation Server.

Два сервера построения

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

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

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

  • Создание или изменение контроллера построений.

  • Активация процессов построения для использования дополнительных двоичных файлов

  • Укажите максимальное количество построений, выполняемых параллельно

  • Удаление контроллера построений

  • Используйте размещенный контроллер построений в коллекции командных проектов, размещенных в службе Team Foundation Service

Создание или изменение контроллера построений.

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

  1. Войдите на сервер построения.

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

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

    ПримечаниеПримечание

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

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

    • Если он отсутствует в списке, нажмите кнопку Создать контроллер.

    • Контроллер уже перечислен.

      Контроллер построений

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

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

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

  1. В Visual Studio в Team Explorer:

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

    2. Выберите Значок "Начало"Главная, а затем выберите Значок построенийПостроения.

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

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

    Диалоговое окно "Управление контроллерами построений"

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

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

Диалоговое окно "Свойства контроллера построений"

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

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

Активация процессов построения для использования дополнительных двоичных файлов

Можно детально настраивать процесс построения с помощью:

  • Сборки, содержащие пользовательские действия рабочего процесса

  • Пользовательские задачи MSBuild

  • Сторонние структуры тестирования модулей в тестовых запусках.

Чтобы настроить процессы построения на использование этих разновидностей кода, верните двоичные файлы в папку (или любую из папок-наследников), указанную в поле Путь системы управления версиями к специальным сборкам.При настройке или изменении значения в этом поле сервер построений автоматически перезапускается для загрузки сборок.

СоветСовет

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

Руководство по возврату двоичных файлов в систему управления версиями см. в разделе Использование сторонних двоичных файлов, не построенных в коде.

Укажите максимальное количество построений, выполняемых параллельно

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

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

  • Можно разработать пользовательский шаблон построения для одновременного использования построениями более одного агента построения из пула 12 агентов построений в составе контроллера построений.Построения, обрабатываемые контроллером построений, основаны на пользовательском шаблоне построения, который в данный момент использует для выполнения делегирования трем агентам построения.Чтобы сделать данные очереди построения более удобными в использовании, настройте контроллер построений с помощью параметра Максимальное количество построений, выполняемых параллельно, установленного в Указать максимальное значение со значением 4.

Удаление контроллера построений

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

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

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

ПримечаниеПримечание

Можно также использовать консоль администрирования Team Foundation для удаления контроллера построения после входа на сервер построения.Однако в этом случае можно по-прежнему использовать Visual Studio или войти на другие серверы построений, чтобы удалить все удаленные агенты построения, объединенные в пул контроллером построений.

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

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

Служба Team Foundation, размещенный контроллер построений

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

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

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

  • Развертывание и настройка агентов построения
    Используйте агента построения для выполнения ресурсозатратной работы в построении.К таким операциям относится получение файлов из системы управления версиями, подготовка рабочей области, компиляция кода и запуск тестов.На сервере построения можно разместить одного или нескольких агентов построений.

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

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

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

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