PDM

Сборки и пайплайны ​

Страница CI-сборки — место, где собирают образы сервисов, ничего при этом не выкатывая.

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

Что такое сборка и при чём тут GitLab ​

Сама сборка происходит не в PDM. PDM запускает пайплайн — сценарий сборки в GitLab — и дальше следит за ним: опрашивает его состояние примерно раз в 10 секунд, складывает логи и показывает итог. Когда пайплайн успешно завершается, PDM вычитывает из его логов тег опубликованного образа — это и есть результат сборки.

Отсюда два практических следствия:

  • длительность сборки определяется пайплайном, а не PDM. Час в состоянии «Выполняется» — это нормально, если пайплайн действительно идёт час;
  • разбираться в причинах падения нужно в GitLab. PDM показывает, что упало и даёт ссылку; почему упало — написано в пайплайне.

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

Запуск сборки ​

Карточка Новая сборка видна только при наличии права на запуск сборок. В ней перечислены сервисы, у которых есть сборочные действия — сервисы, умеющие только «Установить тег», сюда не попадают, собирать там нечего.

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

Несколько сервисов можно собрать разом: отметьте нужные строки, заполните значение в каждой и нажмите Собрать выбранные (N). Сборки запускаются подряд, по одной.

История сборок ​

Карточка Последние сборки — история сборок. В колонке Цель вместе со значением (ветка, версия или тег) показывается короткий хеш коммита, если он известен.

Статусы ​

СтатусЦветЧто значит
В очередисерыйСборка зарегистрирована, пайплайн ещё не пошёл
ВыполняетсясинийПайплайн выполняется
УспешнозелёныйПайплайн завершился успешно, образ собран
ОшибкакрасныйПайплайн упал или был отменён

Отменённый пайплайн показывается как «Ошибка»

Отдельного статуса «отменено» на этой странице нет — отмена попадает в «Ошибку».

Действия над сборкой ​

  • Повторить — есть только у упавших сборок. Перезапускает ту же сборку с теми же параметрами; в списке появляется новая запись, старая остаётся.
  • Пайплайн — ссылка на пайплайн в GitLab. Появляется, когда PDM уже знает его адрес.
  • Конвейер обработки — страница обработки этой сборки: пошаговый ход, логи, подробности ошибки.
  • Очистить завершённые — убирает с экрана завершённые сборки, оставляя активные. Это чистка представления, а не удаление: после перезагрузки страницы записи вернутся.

Как найти нужную сборку ​

Отдельного поиска и фильтров на странице нет — список отсортирован от новых к старым.

Полезно знать, чьи сборки вы вообще видите:

  • по умолчанию в списке только ваши сборки;
  • чтобы видеть сборки других пользователей, нужно отдельное право — его выдаёт администратор.

Так что пустой список означает «вы ничего не запускали», а не «в системе нет сборок».

Список сборок не обновляется сам

В отличие от страницы обработки, таблица «Последние сборки» загружается один раз при открытии страницы. Чтобы увидеть свежие статусы, откройте страницу заново — или перейдите по кнопке Конвейер обработки в обработку, где прогресс идёт в реальном времени.

Сборка в рамках выкладки ​

Сборку можно запустить и не заходя на эту страницу — прямо при изменении версии сервиса на стенде. Такая сборка на странице «CI-сборки» не появится: она не самостоятельная, а часть выкладки, и её ход виден в разделе «Рабочие пространства». Порядок действий описан в разделе Действия над приложением.

Смотрите также ​