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

Помещение сборки в очередь

  • Статья

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

Важно!

Если вы используете Visual Studio 2013 с Visual Studio Team Foundation Server 2013 и меняете параметры процесса сборки при ее постановке очередь, это может вызвать ошибку.Получить исправление KB 2898341.

Общие задачи

Справочные материалы

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

Поместить публичное построение в очередь можно с помощью команды командной строки TFSBuild start.

Поместите в очередь закрытое построение если требуется выполнить построение для изменений, помещенных в набор отложенных изменений. Личное построение (также называемое дружественным построением) можно использовать для проверки изменений в коде перед их возвратом в систему управления версиями.

Поместить личное построение в очередь можно с помощью команды командной строки TFSBuild start с параметром /shelveset.

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

Повторение завершенной сборки

Публичные построения

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

  1. В командном обозревателе выполните следующее.

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

    2. Выберите Значок "Начало" Главная, затем Значок построений Сборки (нажмите клавиши CTRL+0, B).

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

    Откроется диалоговое окно Поставить сборку в очередь TeamProjectName.

  2. В списке Определение сборки будет выбрано определение сборки и ниже отображается его описание. Если требуется поставить в очередь другое определение сборки, выберите его из списка.

  3. Проследите, чтобы в списке Что следует собрать? был выбран элемент Последние источники.

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

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

    В поле Положение отобразится предполагаемое положение построения в очереди.

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

    Важно!

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

    См. раздел Настройка транзитных каталогов.

  7. (Необязательно.) Перейдите на вкладку Параметры, чтобы просмотреть и переопределить параметры в определении построения только для данного запуска.

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

  8. Выберите Очередь.

Частные построения

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

Различия между частными и публичными построениями

Результат завершенного частного построения отличается от результата завершенного публичного построения.

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

  • Сборка не помечает источники, не создает рабочий элемент при сбое и не сопоставляет наборы изменений и рабочие элементы.

  • В обозревателе построений завершенное построение отображается рядом со следующим значком: Icon_BldPrivateBuild

  • Завершенная сборка именуется с использованием формата Build N, где N — уникальное целое значение. Публичные построения именуются иначе; формат их имен задается параметром Формат номера построения.

  • Для каждого определения построения задается отдельная (и, возможно, различная) политика хранения. Она ограничивает количество завершенных частных построений, хранимых в системе.

Помещение частного построения в очередь

  1. В командном обозревателе выполните следующее.

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

    2. Выберите Значок "Начало" Главная, затем Значок построений Сборки (нажмите клавиши CTRL+0, B).

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

    Откроется диалоговое окно Поставить сборку в очередь TeamProjectName.

  2. В списке Определение сборки будет выбрано определение сборки и ниже отображается его описание. Если требуется поставить в очередь другое определение сборки, выберите его из списка.

  3. В списке Что следует построить? выберите элемент Последние источники с набором отложенных изменений.

    Отобразится поле Имя набора отложенных изменений.

  4. Выполните одно из следующих действий:

    • Если набор отложенных изменений уже существует, введите его имя в поле Имя набора отложенных изменений или нажмите кнопку с многоточием (…) для поиска набора отложенных изменений.

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

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

    Важно!

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

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

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

    В поле Положение отобразится предполагаемое положение построения в очереди.

  8. (Необязательно.) Перейдите на вкладку Параметры, чтобы просмотреть и переопределить параметры в определении построения только для данного запуска.

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

  9. Выберите Очередь.

Повторение завершенной сборки

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

  • В командном обозревателе выполните следующее.

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

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

    3. На странице Сборки в разделе Мои сборки откройте контекстное меню завершенной сборки и выберите Повторить попытку сборки.