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

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

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

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

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

• Выбор решений для построения.

• Выбор агента построения и расположения перемещения.

• Выбор шагов построения.

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

• Настройка разрешений на агенте построения.

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

Обязательные компоненты

• Visual Studio Team System Team Foundation Server.

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

• Рабочая область на сервере системы управления версиями с как минимум одним решением для построения. Дополнительные сведения см. в разделе Практическое руководство. Создание сопоставленной рабочей области.

Требуемые разрешения

Для выполнения данного пошагового руководства, необходимо, чтобы разрешение Управление построением имело значение Разрешить. Кроме того, учетная запись уровня приложений и учетная запись 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.

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

   Откроется Мастер создания файла проекта MSBuild.

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

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

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

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

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

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

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

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

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

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

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

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

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

10. Нажмите на вкладку Политика сохранения.

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

    2. Выберите политику сохранения из раскрывающегося списка.

       Если вы выберите <Укажите число сохраняемых>, появится диалоговое окно Число построений.

    3. В текстовом поле Укажите число сохраняемых построений укажите, сколько построений вы хотите сохранить для результатов указанного построения.

11. Перейдите на вкладку Параметры построения по умолчанию.

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

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

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

    3. Заполните текстовые поля Отображаемое имя, Описание и Имя компьютера, и нажмите ОК.

       Дополнительные сведения см. в разделе Создание и управление агентами построения.

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

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

    Примечание.
    Каждое созданное построение помещается в отдельную папку. Следует убедится, что учетная запись, на которую настроен компьютер построения, имеет право записи в размещении UNC.

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

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

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

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

       Если был отмечен флаг Накапливать возвращения до окончания построения (меньшее количество построений), количество построений можно указать, выбрав флаг Не осуществлять построение чаще (в неделю), чем и введя количество в поле минуты. Допустимый диапазон для поля минуты: от 0 до 2147483647 (Int32 MaxValue).

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

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

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

    Созданное определение построения будет показано в папки ПостроенияСред. Командный обозреватель.

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

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

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

Установка разрешений построения

1. Обратитесь к системному администратору, предыдущего компьютера для построения, чтобы определить имя учетной записи, для которой исполняется служба Visual Studio Team Foundation Build.

2. В меню Группа выберите Параметры командного проекта, а затем — Участия в группах.

   Откроется диалоговое окно Группы проекта.

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

   Появится диалоговое окно Свойства группы Team Foundation Server.

4. Перейдите на вкладку Участники.

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

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

   Появится диалоговое окно Выбор: Пользователи или Группы.

6. В диалоговом окне Выберите пользователей или группы, введите учетную запись, связанную со службой Visual Studio Team Foundation Build на компьютере построения, который используется для данного определения построения.

   Примечание.
   Если это построение определения создается на нескольких агентах построения, тогда участниками группы "Службы построений" следует сделать все учетные записи служб Visual Studio Team Foundation Build.

7. Определите, какие пользователи должны запускать определения построений, дав им разрешения начинать/заканчивать построение.

См. также

Задачи

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

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

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

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

Ссылки

Команда Start (Team Foundation Build)