Цепочка сборки
Содержание
| Документация TeamCity On-Premises
Цепочка сборок — это последовательность сборок, связанных между собой зависимостями моментальных снимков. Иногда цепочку сборки называют «конвейером». Части цепочки сборки, связанные с зависимостями моментальных снимков с включенной синхронизацией ревизий, используют один и тот же моментальный снимок источников.
Посмотрите наше видеоруководство о том, как составить конвейер в TeamCity.
Распространенный вариант использования
Наиболее распространенный вариант использования для определения цепочки сборки — запуск одного и того же набора тестов вашего проекта на разных платформах. Например, перед , сборка , вы хотите убедиться, что тесты выполняются правильно на разных платформах и в разных средах. Для этого вы можете поручить TeamCity запустить тесты, затем сначала интеграционную сборку, а затем — выпускную сборку.
Давайте посмотрим, как работает механизм цепочки сборки в деталях.
При запуске зависимой сборки конфигурации сборки Release TeamCity делает следующее:
Разрешает цепочку всех конфигураций сборки, которые Снимок конфигурации сборки версии зависит от.
Проверяет наличие изменений для всех зависимых конфигураций сборки и синхронизирует их, когда первая сборка в цепочке сборки входит в очередь сборки.
Добавляет в очередь сборки все сборки, требующие сборки с определенными ревизиями.
Настройка цепочек сборки
Чтобы указать зависимости в конфигурации сборки:
В настройках конфигурации сборки выберите Зависимости .
На странице Зависимости щелкните ссылку Добавить новую зависимость моментального снимка .
Дополнительные сведения и пример см. в разделе Настройка зависимостей сборки.
Остановка/удаление из очереди сборок из цепочки сборки
Если сборка, останавливаемая или удаляемая из очереди сборки, является частью цепочки сборки, под полем комментария отображается сообщение: « Эта сборка является частью построить цепочку «.
Если есть другие запущенные или поставленные в очередь части цепочки сборки (т.е. другие запущенные сборки или сборки в очереди, которые связаны со сборкой под действием), эти сборки будут перечислены ниже под меткой » Остановить другие части «.
Если у пользователя есть права на остановку сборки в списке, рядом с ним есть флажок. Флажок установлен по умолчанию, если остановка текущей сборки обязательно приведет к сбою сборки в списке (для например, если указанная сборка зависит от исходной остановленной сборки).0005
Если у пользователя нет прав на остановку сборки из списка, флажок не отображается.
Установка флажка помечает выбранную сборку для остановки/удаления из очереди.
Если у пользователя нет прав доступа для просмотра сборки, которая является частью цепочки сборки, эта сборка вообще не видна пользователю. При наличии хотя бы одной такой сборки выдается предупреждение: « У вас нет прав доступа ко всем ее частям «. Полоса отображается прямо под сообщением « Эта сборка является частью цепочки сборки «.
В случае, когда все остальные части цепочки сборки не могут быть просмотрены текущим пользователем, мы показываем желтую полосу с предупреждением: » У вас нет прав доступа чтобы увидеть другие его части «.
Если для цепочки сборки нет запущенных или поставленных в очередь сборок (т.е. все остальные части цепочки сборки завершены), дополнительная информация не отображается.
Отключение синхронизации ревизий между частями цепочки
Вы можете отключить синхронизацию версий для зависимости моментального снимка конфигурации сборки при продвижении сборки.
Этот параметр работает, если вы продвигаете сборку из части цепочки 1 в часть цепочки 2, а в первой конфигурации сборки части 2 этот параметр отключен. В этом случае TeamCity может использовать разные исходные версии для сборок в части 1 и части 2. См. пример настройки сборки в разделе Настройка зависимостей сборки.
Это полезно, когда вам нужно запустить зависимую сборку без синхронизации ее версии кода с ее зависимостями (предшествующие сборки в цепочке).
Например, вы можете повысить старую сборку до конфигурации сборки развертывания, и эта сборка будет выполняться с использованием последних сценариев развертывания.
При нагрузочном/приемочном тестировании, когда вы храните тесты в системе контроля версий и часто меняете их для тестирования вашей системы, вам не нужно полностью перестраивать приложение; вместо этого вы можете подобрать цепочку непосредственно на этапе тестирования.
Визуальное представление цепочек построения
По сути, каждая цепочка построения представляет собой направленный ациклический граф, то есть не может иметь циклов.
Цепочки сборки видны в различных местах веб-интерфейса TeamCity:
Страница зависимостей настроек конфигурации сборки
Вкладка «Цепочки сборки» на домашней странице проекта и домашней странице конфигурации сборки
901 13 Страница зависимостей конфигурации сборки settings
Если конфигурация сборки является частью цепочки сборки, соответствующая информация отображается в Настройки конфигурации сборки | Зависимости | Зависимости снимков .
При нажатии на ссылку цепочки сборки открывается предварительный просмотр цепочки сборки и ее конфигурации в отдельном окне. В предварительном просмотре показаны сборки цепочки; сборки с настроенным автоматическим запуском отмечены значком: .
Если конфигурации сборки в цепочке используют ветви функций, логические имена ветвей также представлены в виде меток сборки на графе цепочки. Обратите внимание, что эти имена могут отличаться от корней VCS, фактически используемых для сборок: если сборка использует ветвь по умолчанию, но зависит от сборки, использующей нестандартную ветвь, метка сборки зависимостей будет отражать это. Например, если сборка A использует ветвь по умолчанию «master», но зависит от сборки B, которая использует ветвь «v1.1», обе сборки будут помечены как «v1.1».
Вкладка «Сборка цепочек» на домашней странице проекта и домашней странице «Конфигурация сборки»
Вы можете просматривать цепочки сборки как на странице проекта, так и на странице конфигурации сборки: на каждой из этих страниц есть вкладка «Сборка цепочки» , появляющаяся при настройке зависимостей моментальных снимков.
На вкладке отображается список цепочек сборки, которые содержат сборки данного проекта или данной конфигурации сборки с возможностью их фильтрации. Обратите внимание, что цепочки сборки отсортированы таким образом, что цепочка сборки с последней завершенной сборкой отображается вверху списка.
Значок круговой диаграммы отображает соотношение статусов сборок, входящих в цепочки. При наведении курсора на круговую диаграмму отображаются подробности:
Когда цепочка развернута, также доступна следующая информация:
все сборки эта цепочка сборок состоит из
статус этих сборок: не активирован , в очереди запущенной или завершенной и ее подробностях
цепочка отображает сборки в порядке фактического выполнения, то есть сборки, которые начинаются первыми, находятся слева.
Щелчок сборки в цепочке выделяет выбранную сборку и все ее прямые зависимости. Эта страница:
обеспечивает компактное представление цепочек: если несколько топовых сборок вызвали одну и ту же цепочку зависимых сборок, TeamCity отображает одну цепочку сборок с несколькими топовыми сборками.
имеет дополнительные параметры отображения: Группировать по проектам и Скрыть детали.
транзитивно выделяет все нижестоящие/восходящие сборки, когда сборка выбрана в цепочке сборок.
С этой страницы вы также можете:
Продолжить цепочку, если есть еще «не запущенные» сборки. Нажмите Run , и новая сборка будет запущена в ревизиях цепочки и связана со сборками из этой цепочки.
Нажмите, чтобы открыть диалоговое окно пользовательской сборки с предварительно выбранными ревизиями цепочки сборки. Это действие можно использовать, если вы хотите перезапустить какую-либо сборку в цепочке.
Вкладка «Зависимости» на странице результатов сборки
Если зависимости настроены, вы можете просмотреть их детали на странице результатов сборки, вкладка Зависимости . На этой вкладке также отображаются косвенные зависимости, например, если сборка A зависит от сборки B, которая зависит от сборок C и D, то эти сборки C и D являются косвенными зависимостями для сборки A.
На вкладке также отображаются артефакты, загруженные и доставленные построения цепочки. Это также позволяет группировать/разгруппировать сборки и выделять сборки, повторно используемые из предыдущих цепочек (подходящие сборки).
Последнее изменение: 01 февраля 2022 г.
Справочник по сборке артефактов
Собери свое собственное колье – готовое
Сборные ожерелья
Собери свои собственные ожерелья из полированного золота, розового золота и серебра подвески в Серии форм и разнообразие стилей цепей — от изящных кабельных звеньев до тяжелых роликов и всего, что между ними — различной длины.
Строить
Two Ways
Просто:
1. Выберите кулон
2. Выберите цепочку…
Дополнительная сборка:
3a. Добавьте дополнительные подвески.
3б. Добавьте еще одну цепочку (каждый кулон подходит для двух цепочек).
3с. Скомбинируйте с другим простым кулоном и цепочкой.
