Управление системой сборки

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

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

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

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

Выполняемые задачи

• Проверка состояния, управление и изменение контроллеров и агентов из Visual Studio

• Проверка состояния, управление и изменение сервера, контроллера и агентов из консоли администрирования

• Запуск, остановка и перезапуск сервера построений

• Перезапуск контроллера построения или агента построения

• Отключение и включение контроллера или агента

• Укажите максимальное количество одновременно выполняемых построений для контроллера

• Регистрация сервера построений и отмена регистрации

• Проверка работоспособности сервера построений

• Используйте журналы событий, чтобы выявить проблемы

• Предпримите дальнейшие действия

Проверка состояния, управление и изменение контроллеров и агентов из Visual Studio

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

1. В Visual Studio в Team Explorer:

   1. Если вы еще не подключены к командному проекту из коллекции командных проектов, подключитесь к командному проекту.

   2. Выберите Главная, а затем выберите Построения.

2. На странице "Построения" выберите Действия и Управление контроллерами построения.

Следующие шаги

• Проверка состояния ваших контроллеров и агентов

  • Если Состояние Доступно и Состояние Включено, компонент, вероятно, работает правильно.

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

  • Если параметр Состояние имеет значение Автономно, то компонент отключен. Войдите на сервер построения и убедитесь, что он зарегистрирован и можно подключиться в Team Foundation Server.

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

• Удаление контроллера или агента
  См. Удаление контроллера построений или Удаление агента построений.

• Управления или разрешение проблем с сервером построений, контроллером или агентом
  Дополнительные сведения см. в разделе ниже.

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

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

1. Войдите в систему сервера построения, который требуется настроить.

2. Из Windows Пуск запустите Консоль администрирования Team Foundation.

   Отобразится окно Консоль администрирования Team Foundation.

3. В панели с иерархической структурой разверните имя сервера.

4. Выберите узел Конфигурация построения.

Примечание

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

Следующие шаги

• Проверка состояния ваших контроллеров и агентов

  • Если все контроллеры построений или агенты построения обрабатывают построение, можно увидеть сообщения об этом процессе в реальном времени с консоли администрирования Team Foundation.

    

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

  • Если контроллер или агент красный, компонент отключен. Убедитесь, что сервер построений может подключиться к Team Foundation Server.

• Работа с сервером построения

  

  • Выберите Перезапустить, Остановить или Запустить, чтобы запустить, остановить или перезапустить сервер сборки.

  • Выберите Свойства, чтобы развернуть и настроить сервер построений.

  • Выберите Зарегистрировать или Отменить регистрацию, чтобы зарегистрировать сервер построений или отменить его регистрацию.

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

  • Проверка работоспособности сервера построений.

• Работа с контроллером построения
  

  • Выберите Свойства и см. Развертывание и настройка контроллера сборок.

  • Выберите Перезапустить, чтобы перезапустить контроллер.

  • Выберите Включить или Отключить, чтобы включить или отключить контроллер.

• Работа с этим агентом построения
  

  • Выберите Свойства и см. Развертывание и настройка агентов сборки.

  • Выберите Перезапустить, чтобы перезапустить агент.

  • Выберите Включить или Отключить, чтобы включить или отключить агент.

Запуск, остановка и перезапуск сервера построений

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

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

Перезапуск контроллера построения или агента построения

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

Отключение и включение контроллера или агента

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

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

Включение и отключение агента построений и контроллера построений:

• В диалоговом окне Управление контроллерами построения Visual Studio выберите контроллер построений или агент построения, который нужно отключить или включить, а затем выберите Свойства. На экране появится диалоговое окно Свойства контроллера построений или Свойства агента построения. Снимите или установите флажок Служба контроллера построений включена или Служба агента построения включена.

• Из Консоль администрирования Team Foundation найдите контроллер построений или агент построения, который нужно отключить или включить, а затем щелкните его ссылку Включить или Отключить.

Регистрация сервера построений и отмена регистрации

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

• Чтобы временно списать сервер построения, щелкните Нет. Контроллеры и агенты на этом сервере построений не удаляются из коллекции командных проектов и отображаются с полем Статус, имеющим значение Автономно в диалоговом окне Управление контроллерами построения Visual Studio. Позже можно будет нажать Регистрация и восстановить контроллер и агентов построений.

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

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

Совет

Можно также заменить существующий сервер построений при развертывании нового сервера построений.Например, может потребоваться разместить ту же конфигурацию и набор контроллеров построения и агентов построения на новом, более мощном компьютере.Дополнительные сведения см. в разделе Настройка службы построения Team Foundation с помощью средства настройки Team Foundation Server.

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

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

1. Запустите диспетчер задач Windows (диспетчер задач в Windows 8).

2. В Windows 8, если отображается ссылка Дополнительные сведения, щелкните ее.

3. Выберите вкладку Процесс.

4. В версиях Windows, отличных от Windows 8, убедитесь, что выбрано Отображать процессы всех пользователей.

5. В какой версии Windows выполняется сервер построений?

   • Windows 8: Найдите процесс Узел службы построений Visual Studio Team Foundation. Он должен быть расположен в разделе Фоновые процессы или если сервер построения выполняется в интерактивном режиме, в разделе Приложения. Отслеживание ресурсов ЦП, памяти, диска и сети, потребляемых процессом.

   • Другая версия Windows: найдите процесс TFSBuildServiceHost.exe. Отслеживание ресурсов ЦП и памяти, потребляемых процессом.

6. Использовать другие вкладки в диспетчере задач для подтверждения общего состояния здоровья на сервере построений. Например, можно выбрать вкладку Производительность, чтобы подтвердить, что на компьютере достаточно ресурсов процессора и памяти. Затем можно выбрать Монитор ресурсов (в Windows 8Открыть монитор ресурсов).

Используйте журналы событий, чтобы выявить проблемы

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

Просмотрите последние события

Начните с проверки последних событий. В Консоли администрирования Team Foundation выберите События…, чтобы открыть окно просмотра событий для отображения последних информационных сообщений, предупреждений и сообщений об ошибках.

Просмотр журнала операций

Чтобы получить более подробные сведения по более длинному периоду времени, в средстве просмотра событий в области дерева разверните Журналы приложений и служб, Microsoft, Team Foundation Server, Службы построений, а затем выберите Работающая.

Просмотр аналитического журнала

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

Включение аналитического журнала

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

2. На панели дерева разверните узел Журналы приложений и служб, Microsoft, Team Foundation Server, Службы построения, а затем выберите Аналитический.

3. Если Аналитический все еще выбран, откройте контекстное меню и выберите Включить.

Совет

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

Настройка и просмотр данных

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

Следующие шаги

• Развертывание и работа с сервером построений
  Для использования Team Foundation Build с локальной системой Team Foundation Server, необходимо развернуть хотя бы один сервер построений. Сервер можно развернуть на физическом компьютере или виртуальной машине.

• Развертывание и настройка контроллера построений
  Используйте контроллер построений для выполнения упрощенных задач и распределения ресурсозатратной работы в процессе построения среди пула агентов построения. На сервере построения можно разместить только один контроллер построений.

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

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

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