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

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

  • Статья

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

Перед созданием нового определения построения необходимо сначала настроить компьютер, который будет назначен агентом построения. Дополнительные сведения см. в разделе Практическое руководство. Установка и настройка Team Foundation Build. После установки Team Foundation Build и необходимых компонентов на одном или нескольких компьютерах можно с помощью пользовательского интерфейса Visual Studio Team System создавать новые агенты построения или управлять существующими агентами построения. Каждый агент построения может быть связан только с одним портом. В большинстве случаев это означает, что каждый агент построения связан с одним компьютером построения. Однако можно также указать интерактивный порт, который можно использовать, запуская tfsbuildservice.exe из командной строки. Интерактивный порт позволяет делать тестовые запуски, которые включают открытие и закрытие Windows Forms. Дополнительные сведения см. в разделах Параметры файла TfsBuildService.exe.config в компонентах Team Foundation Server и Практическое руководство. Настройка интерактивного порта для построения Team Foundation.

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

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

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

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

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

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

  2. Выберите пункт Управление агентами сборки в меню Построение.

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

  3. Нажмите кнопку Создать.

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

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

    В диалоговом окне Управление агентами построения отображается это имя.

  5. Введите описание в текстовом поле Описание (необязательно).

    Например, можно ввести «Данный агент построения предназначен для отката построений».

  6. В поле Имя компьютера введите имя компьютера, где установлен Team Foundation Build.

  7. В текстовом поле Порт связи введите номер порта, который Team Foundation использует для связи с Team Foundation Build.

    Значение по умолчанию — 9191. Дополнительные сведения о портах, которые используются Team Foundation, см. в разделе Архитектура безопасности Team Foundation Server.

  8. Установите флажок Требовать безопасный канал (HTTPS), если необходимо, чтобы агент построения требовал использования протоколов HTTPS и SSL.

    Дополнительные сведения о шагах, необходимых для использования протокола HTTPS, см. в разделе Практическое руководство. Настройка агента построения на обязательное использование HTTPS и SSL.

  9. В текстовом поле Рабочий каталог введите значение для рабочей папки на агенте построения.

    Значение по умолчанию — $(Temp)\$(BuildDefinitionPath). Свойство BuildDefinitionPath охватывает <Командный проект>\<Имя определения построения>. Также можно использовать параметр BuildDefinitionId, который охватывает целочисленный идентификатор, уникальный для определения построения. Параметр BuildDefinitionId обычно используется для создания более короткого пути.

    Bb399135.alert_note(ru-ru,VS.90).gifПримечание.

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

    Настройка по умолчанию для параметра Состояние агента — Включен. Другие значения показывают соответствующее состояние агента.

Редактирование и удаление агентов построения

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

Удаление агента построения

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

  2. Выберите пункт Управление агентами сборки в меню Построение.

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

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

    Агент построения удаляется из списка.

Редактирование агента построения

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

  2. Выберите пункт Управление агентами сборки в меню «Построение».

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

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

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

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

  5. Чтобы отключить агент построения, выберите в раскрывающемся меню «Состояние агента» значение Отключен.

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

См. также

Задачи

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

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

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

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

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

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

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

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