Что такое пайплайны?

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

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

Запуск пайплайна через веб-интерфейс

Для ручного запуска пайплайна перейдите в проекте в раздел «Репозитории Git» и выберите в меню «⋮» нужного репозитория пункт «Собрать». Или выберите нужный репозиторий и нажмите на кнопку «Собрать» в открывшемся разделе списка пайплайнов.

Подтвердите своё действие в открывшемся модальном окне и дождитесь завершения процесса сборки пайплайна.

Запуск пайплайна с помощью консольной утилиты

dockhost repository build <name> [options]

Подробнее о команде запуска принудительной сборке репозитория можно узнать в описании команды repository build

Просмотр результата сборки пайплайна

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

Для этого перейдите в проекте в раздел «Репозитории Git» и выберите нужный репозиторий, после этого откроется раздел списка пайплайнов репозитория.

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

Откат изменений пайплайна

Если собранный контейнер работает не так, как ожидалось, например, в коде была допущена ошибка, можно откатить текущий контейнер на предыдущую версию. Для этого перейдите в проекте в раздел «Репозитории Git» и выберите нужный репозиторий, после этого откроется раздел списка пайплайнов репозитория.

Выберите нужный пайплайн и в меню «⋮» нажмите на кнопку «Перезапустить»

Подтвердите своё действие в открывшемся модальном окне и дождитесь завершения процесса сборки пайплайна.

Использование встроенных переменных в ARG

Для каждого пайлайна существуют системные переменные, которые можно использовать как значение аргументов (ARG) сборки. Список доступных переменных представлен в таблице ниже:

Для того чтобы значение системной переменной было подставлено в значение аргумента (ARG), необходимо в значение аргумента (ARG) указать название переменной с префиксом $, например $CI_PIPELINE_ID.

Сборка образа из приватного реестра

Если в Dockerfile репозитория используется базовый образ из приватного реестра (например, FROM private-registry.com/image:tag), платформа Dockhost автоматически выполнит авторизацию во всех подключённых к проекту реестрах перед началом сборки.

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

Подробнее о подключении реестров образов читайте в статье «Подключение реестра образов».