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


Определение построения с помощью шаблона обновления

Чтобы продолжить использование определений построения, созданных в прежних версиях, в Visual Studio Team Foundation Server 2010, можно воспользоваться шаблоном обновления. В частности, с помощью этого шаблона можно запустить перечисленные ниже виды объектов построения:

  • определения построения, созданные с помощью Visual Studio Team System 2008 Team Foundation Server;

  • типы построения, созданные с помощью Visual Studio 2005 Team Foundation Server.

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

Кроме того, при использовании предыдущей версии Visual Studio ALM для создания определения построения или типа построения на сервере с Team Foundation Server 2010, система автоматически создает определение построения для шаблона обновления.

Чтобы изменить основные аспекты данного объекта построения, созданного в прежней версии, нужно внести изменения в файл TFSBuild.proj. Дополнительные сведения см. в разделе Цели, задачи и свойства Team Foundation Build. Однако некоторые параметры объекта определения построения можно изменить, открыв узел "Построения" в Сред. Командный обозреватель. Эти параметры рассматриваются в данном разделе.

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

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

Изменение определения построения шаблона обновления

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

  2. Щелкните правой кнопкой мыши определение построения, которое требуется изменить, и выберите пункт Редактировать определение построения.

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

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

  5. Убедитесь, что в шаблоне процесса построения отображается надпись Шаблон обновления.

  6. Разверните узел Требуется.

  7. Убедитесь, что в поле Путь папки конфигурации задан правильный путь к папке, содержащей файл TFSBuild.proj.

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

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

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

В этом разделе

  • Сведения о параметрах процесса построения шаблона по умолчанию

  • Определение детализации журнала

  • Укажите агенты построения, которые обрабатывают ваше построение

  • Определение временных пределов агента построения

  • Определение дополнительных параметров процесса построения

Сведения о параметрах процесса построения шаблона по умолчанию

В этом разделе объясняется, как изменить построение с помощью параметров процесса построения для построений на основе шаблона обновления. Эти сведения должны быть применимы к Visual Studio Application Lifecycle Management (ALM), если справедливы следующие утверждения:

  • работа ведется над командным проектом, который был создан на основе одного из двух шаблонов процессов, входящих в состав Visual Studio ALM: MSF для гибкой разработки программного обеспечения версии 5.0 или MSF для оптимизации процесса CMMI версии 5.0;

  • никто в команде не удалял и не настраивал шаблон обновления.

Определение детализации журнала

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

Значение

Ошибки построения

Предупреждения при построении

Очень важно

Построение

Сообщения

Обычная важность

Построение

Сообщения

Не очень важно

Построение

Сообщения

Свойства действия рабочего процесса (входные и выходные данные)

Минимальный

Y

N

N

N

N

N

Обычные

Y

Y

Y

N

N

N

Подробные

Y

Y

Y

Y

N

N

Диагностические

Y

Y

Y

Y

Y

Y

Заданное значение уровня подробности ведения журнала влияет также на уровень подробности сообщений, выдаваемых MSBuild. Дополнительные сведения см. в разделе Справочные сведения о командной строке MSBuild.

Дополнительные сведения об отчетах о построении см. в разделе Отображение окна результатов построения.

Укажите агенты построения, которые обрабатывают ваше построение

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

  • Фильтр имен – введя имя агента в этом поле можно отфильтровать агенты построения, которые используются для обработки этого определения построения. Кроме того, можно указать набор имен, воспользовавшись подстановочными знаками "*" и "?". Например, можно указать CI*, чтобы задать любой агент, чье имя начинается с символов CI. Агентами, соответствующими этому критерию, будут, в частности, CI, CI1 и CI_Agent2.

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

    Примечание

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

Определение временных пределов агента построения

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

Цель...

Параметр

Инструкции по применению

Задать максимально допустимое время обработки построения агентом построения

Максимальное время выполнения

Введите значение интервала времени в формате чч:мм:сс. Например, если указано значение 04:30:15, а агент построения не завершил свою работу спустя 4 часа, 30 минут и 15 секунд, построение завершится ошибкой превышения времени ожидания. Укажите значение 00:00:00, если нужно предоставить агенту построения неограниченное время для обработки построения.

Задать максимально допустимое время для назначения запроса построения агенту построения

Максимальное время ожидания

Введите значение интервала времени в формате чч:мм:сс. Например, если указано значение 01:30:45, а построение не было назначено агенту построения спустя 1 час, 30 минут и 45 секунд, построение завершится ошибкой превышения времени ожидания. Укажите значение 00:00:00, если нужно предоставить контроллеру построений неограниченное время для поиска агента построения, который будет обрабатывать это определение построения.

Определение дополнительных параметров процесса построения

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

Цель...

Параметр

Инструкции по применению

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

Подкаталог исполняемых модулей

Если не задать подкаталог, система будет использовать подкаталог с именем Binaries.

Воспользоваться определением типа построения, имеющимся на локальном компьютере

Не загружать тип построения

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

Обычно, значение Истина задается для этого параметра временно, с целью отладки файла TFSBuild.proj.

Создать файлы журнала ошибок и предупреждений для отдельных проектов

Файл журнала на каждый проект

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

Задать аргументы командной строки, передаваемые в MSBuild

Аргументы MSBuild

Если для процесса построения необходима передача аргументов в MSBuild, введите их в параметре Аргументы MSBuild. Дополнительные сведения см. в разделе Справочные сведения о командной строке MSBuild.

Задать разрядность версии MSBuild, которая будет использоваться для обработки построения

Платформа MSBuild

Укажите одно из следующих значений.

  • Укажите Авто, если MSBuild нужно запускать на ЦП, разрядность которого совпадает с разрядностью ЦП службы Служба построения Team Foundation, установленной на агенте построения.

  • Укажите X86, чтобы всегда обрабатывать это построение с помощью 32-разрядной версии MSBuild.

    Поскольку Visual Studio 2010 выполняется как 32-разрядное приложение, при обработке построения агентом построения, запущенным на 64-разрядной версии службы Служба построения Team Foundation, могут возникнуть проблемы. Проблемы такого рода можно решить, задав значение X86.

  • Укажите X64, чтобы всегда обрабатывать это построение с помощью 64-разрядной версии MSBuild.

    ПримечаниеПримечание
    Если задано это значение, следует убедиться (например, с помощью тега, как описано ранее в этом разделе), что построение обрабатывается агентом построения на 64-разрядном компьютере построения.В противном случае построение завершится ошибкой.

Обеспечить рекурсивное получение и использование в MSBuild файлов, расположение которых задано в поле Путь папки конфигурации

Тип рекурсии

Укажите одно из следующих значений.

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

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

Задать подкаталог, используемый для сопоставления рабочей области и построения

Подкаталог источников

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

Задать подкаталог, который будет использоваться для хранения результатов тестов

Подкаталог результатов тестов

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