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

Обновлен: Ноябрь 2007

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

При создании определений построения с помощью диалогового окна Определение построения вы можете задать несколько опций. Эти опции включают имя построения, рабочую область системы управления версиями для файлов, участвующих в построении, расположение файла проекта TFSBuild.proj, агент построения, политику сохранения сборок, и триггер построения. Если у вас нет существующего файла проекта MSBuild, вы можете использовать диалоговое окно Определение построения для запуска мастера создания файла проекта MSBuild, создающего новый файл TFSBuild.proj для вашего определения построения. Вы также можете открыть диалоговое окно Свойства агента построения для создания нового агента построений.

После создания нового определения построения вы можете изменить эти опции. Дополнительные сведения см. в разделе Редактирование определения построения.

Дальнейшую настройку определений вы можете выполнить, отредактировав файл TFSBuild.proj, записанный в формате MSBuild. Дополнительные сведения см. в разделе Настройка построения Team Foundation.

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

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

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

Чтобы создать новое определение построения

1. В командном обозревателе выберите проект, для которого вы хотите создать новое определение построения.

2. В меню Построение выберите Новое определение построения.

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

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

3. Задайте имя, связанное с определением построения в текстовом поле Имя определения построения.

   Имя должно быть уникальным и является допустимым именем файла Windows.

4. Введите подходящее описание в поле Описание.

   Это описание будет показано в диалоговом окне Поставить в очередь построения "<имя командного проекта>". Дополнительные сведения см. в разделе Практическое руководство. Постановка в очередь или запуск определения построения.

5. Нажмите на вкладку Рабочая область.

   Таблица Рабочие папки включает по умолчанию папку системы управления версиями командного проекта, для которого вы создаете новые определения построений, и локальную папку агента построения. Локальная папка агента построений показана в столбце Локальная папка. Все пути рабочей области в агенте построения приведены к маршрутам относительно показанного корневого каталога по умолчанию.

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

   Выбранная вами рабочая область становится дочерней по отношению к общему корневому каталогу агента построения.

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

7. Перейдите на вкладку Файл проекта. В панели Файл проекта вы можете либо просмотреть существующий файл проекта TFSBuild.proj, либо запустить Мастер создания файла проекта для создания нового файла TFSBuild.proj.

8. Для просмотра существующего файла TFSBuild.proj file нажмите кнопку Обзор. В диалоговом окне Выбрать папку, выберите существующее определение построения из папки TeamBuildTypes, затем нажмите ОК.

   Теперь файл TFSBuild.proj используется как существующим, так и вашим новым определением построения.

   Если файл TFSBuild.proj найден, в панели Файл проекта будет показан следующий текст: Найден файл проекта MSBuild: TFSBuild.proj. Если файл проекта не найден, панель Файл проекта показывает текст предупреждения и советует вам создать новый файл проекта MSBuild. 

   Важное примечание.
   Любое изменение, которое вы делаете в общем файле TFSBuild.proj, вносит изменения во все определения построений, с которыми связан данный файл. Дополнительные сведения см. в разделе Настройка построения Team Foundation.

   Чтобы создать новый файл проекта для вашего определения построения, нажмите кнопку Создать. Откроется Мастер создания файла проекта MSBuild.

   1. На странице Выбрать и упорядочить решения для построения выберите решения для построения. Чтобы упорядочить решения, выберите решение и с помощью расположенных справа клавиш со стрелками измените порядок, в котором оно будет участвовать в построении.

      Внимание!
      Учитывайте зависимость одного решения от другого при определении порядка их построения. Например, если Решение2 имеет зависимость от Решения1, настройте построение Решения1 до Решения2.

   2. Нажмите кнопку Далее.

      Появится страница Выберите конфигурацию для построения.

   3. В таблице под меткой Какие конфигурации следует собирать выберите требуемую конфигурацию и платформы, которые вы хотите включить в ваши определения построений. В конфигурации построения указана конфигурация и платформа, например "Выпуск" и "Любой ЦП".

      Примечание.
      Если вы создаете определение построения для веб-проектов, выберите в раскрывающемся меню Платформа пункт Смешанная платформа.

   4. Нажмите кнопку Далее.

      Появится страница Выберите параметры построения.

   5. Задайте опции, которые вы хотите включить, установив по необходимости флажки Выполнить тест (например, тесты проверки построения и т. п.) и Запустить анализ кода. Если флажок Выполнить тест (например, тесты проверки построения и т. п.) установлен, воспользуйтесь раскрывающимися опциями для задания по необходимости опций Проверить файл метаданных и Список выполняемых тестов.

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

      Важное примечание.
      Для запуска тестов на агенте построения должен быть установлен Team Edition for Testers. Для запуска анализа кода на агенте построения должен быть установлен Team Edition for Developers.

   6. Нажмите кнопку Готово.

      В панели Файл проекта появится диалоговое окно Определение построения. Созданный вами файл TFSBuild.proj хранится в системе управления версиями по маршруту $<Командный проект>\TeamBuild Types\<Имя определения построения>\TFSBuild.proj.

9. Нажмите на вкладку Политика сохранения. В списке Укажите, как должны храниться сборки вы можете выбрать политику сохранения для неудачного, прерванного, частично успешного и полностью успешного построения. Выберите политику сохранения из раскрывающегося списка. Если вы выберите <Укажите число сохраняемых>, появится диалоговое окно Число построений. В текстовом поле Укажите число сохраняемых сборок укажите, сколько сборок вы хотите сохранить для результатов указанного построения.

10. Перейдите на вкладку Параметры построения по умолчанию. В панели Параметры сборки по умолчанию вы можете выбрать существующий агент построения из раскрывающегося списка Агент сборки. Если агента построения не существует или вы хотите создать нового, нажмите кнопку Новый. Появляется диалоговое окно Свойства агента построения. Заполните текстовые поля Отображаемое имя, Описание и Имя компьютера, и нажмите ОК. Дополнительные сведения см. в разделе Создание и управление агентами построения.

    В текстовом поле Построения будут выполняться на общем ресурсе (например, \\server\share) введите UNC-маршрут (\\server\share). После завершения процесса построения готовые двоичные файлы и журналы будут находится в этой папке.

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

11. Выберите вкладку Триггер.

    1. В панели Триггер выберите Возвраты не запускают новую сборку для выполнения построений только по запросу.

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

    3. Выберите Накапливать возвраты до завершения предшествующей сборки (меньше сборок) для создания последовательных построений. Если флажок Накапливать возвраты до завершения предшествующей сборки (меньше сборок) установлен, вы можете указать, как часто будут выполняться построения, установив флажок Выполнять сборку не чаще, чем каждые и введя количество минут в текстовом поле минуты.

       Допустимый диапазон для текстового поля минуты: от 0 до 2147483647 (Int32 MaxValue).

       Примечание.
       В случае использования Visual Studio Team System 2008 Team Foundation Server с пакетом обновления 1 (SP 1), можно задать интервал построений отката в диапазоне от 120 до 240 минут. В случае использования Visual Studio Team System 2008 Team Foundation Server с пакетом обновления 1 (SP 1), Team Foundation Build пропускает любое значение в данном диапазоне.

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

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

12. Если вы ввели всю необходимую информацию, нажмите кнопку ОК для создания своего определения построения.

    Созданное определение построения будет показано в папки Сборки Сред. Командный обозреватель. Для просмотра информации, хранимой на сервере для вашего определения построения, нажмите правую кнопку в Сред. Командный обозреватель на щелкните по пункту Редактирование определения сборки. Будет показано диалоговое окно Определение построения, заполненное введенной вами информацией. Вы также можете изменить введенную вами информацию. Дополнительные сведения см. в разделе Редактирование определения построения.

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

См. также

Задачи

Пошаговое руководство. Создание определения построения в Team Foundation Build

Практическое руководство. Установка разрешений для агента построения Team Foundation

Практическое руководство. Установка и настройка Team Foundation Build

Пошаговое руководство. Расширение возможностей Team Foundation Build с помощью настраиваемых задач

Основные понятия

Общие сведения о Team Foundation Build

Другие ресурсы

Работа с определениями построений в Team Foundation Build