Управление сведениями по построении и уровнем детализации

Можно получить подробные сведения о завершенном построении.

• Как построение было запущено? Было ли построение выполнено успешно?Когда оно было запущено?Сколько времени заняло построение?Как оно было выполнено по сравнению с предыдущими построениями?

• Построение чего было выполнено? Какие решения, наборы изменений и исправления ошибок вошли в построение?

• Что неправильно? Какие были выданы предупреждения или ошибки?Какие тесты завершились ошибкой?

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

Содержание раздела

• Создание и поток информации о построении

  • Определение процесса построения

  • Процесс построения помещен в очередь и выполнен

  • Информация о построении создана, отфильтрована и сохранена

  • Получение информации о построении

• Задание параметра процесса построения, определяющего подробность записи в журнал

• Рекомендация: как можно меньше подробностей

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

  • При создании пользовательского шаблона процесса построения используйте минимальный уровень подробности

• Дополнительные сведения

Создание и поток информации о построении

Определение процесса построения

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

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

Процесс построения помещен в очередь и выполнен

Можно вручную переопределить параметр Уровень подробного ведения журнала, когда вы ставите в очередь определение построения, основанное на шаблоне по умолчанию или шаблоне обновления.В диалоговом окне Поставить построение в очередь перейдите на вкладку Параметры, раскройте узел Основные и выберите значение в списке Уровень подробного ведения журнала, задав этот параметр построения.Это значение применяется к данному выполнению построения.

Информация о построении создана, отфильтрована и сохранена

Система построения передает значение параметра процесса построения Уровень детализации в свойство Verbosity.Это свойство используется для фильтрации информации о построении, внесена в журнал и сохраняется на сервере Team Foundation Server с помощью Information из следующих источников:

• Действия рабочего процесса. Несколько действий рабочего процесса создают сообщение, если операция удалась, и предупреждение или ошибку, если она прошла неудачно.Например, действие SyncWorkspace создает сообщения с низким приоритетом при загрузке исходного кода и других файлов с сервера на агент построения.Если загрузка файлов не удается, это действие создает сообщения об ошибках.Другой пример: действие OpenWorkItem создает предупреждение, если не удалось создание рабочего элемента.

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

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

  • В Team Foundation Server хранит результаты компиляции, ошибки и предупреждения.

  • Журнал в транзитном каталоге хранит ту же информацию, что и в Team Foundation Server, а также все остальные, создаваемым в MSBuild.

• Тестировать код: Процесс построения с помощью действия RunTests или MSTest проводит тесты.Все сообщения, которые журнал этих действий отдельные с важностью значение максимума, если контроллер построений локален, или низкий при использовании Размещенный контроллер построений.

Получение информации о построении

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

Параметр процесса построения, определяющий детализацию записи в журнал

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

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

Значение	Ошибки	Предупреждения	Сообщения высокой важности	Сообщения с обычным уровнем важности	Сообщения с низким уровнем важности	Свойства действия рабочего процесса (входные и выходные данные)
Минимальный	Y	N	N	N	N	N
Обычные	Y	Y	Y	N	N	N
Подробные	Y	Y	Y	Y	N	N
Диагностика (совет: В большинстве случаев можно вместо этого использовать журналы диагностики.См. Диагностирование проблем построения).	Y	Y	Y	Y	Локальный контроллер построений. Y Размещенный контроллер построений: N	Y

Рекомендация: как можно меньше подробностей

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

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

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

При создании пользовательского шаблона процесса построения используйте минимальный уровень подробности

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

• Убедитесь, что для записи сообщения выбрано наиболее подходящее действие: Действие WriteBuildMessage, Действие WriteBuildWarning, Действие WriteBuildError или WriteBuildTestError.

• При использовании для записи в журнал действия Действие WriteBuildMessage примените разумный и последовательный подход к заданию свойства Importance.Используя высокое значение важности для сообщения, имейте в виду, что это потенциально увеличивает количество сохраняемых и получаемых членами команды данных.

Примечание
Особенно сильными последствия таких решений могут быть, если эти действия используются внутри циклов, например DoWhile, ForEach<T> или While.

Дополнительные сведения

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

Раздел Действия построения Team Foundation описывает упоминаемые в этой теме действия рабочего процесса.

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

Раздел Просмотр результатов построения содержит руководство по использованию окна результатов построения.

Разделы IBuildDetail, BuildMessageImportance и BuildVerbosity описывают некоторые ключевые элементы API-интерфейса Team Foundation Build, предоставляющие функции получения сведений о построении.

Раздел Справочник по командной строке MSBuild описывает MSBuild.

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