Основные концепции
Прежде чем строить первый пайплайн, полезно понять, как pipel8ne моделирует CI/CD воркфлоу.
Четыре уровня
Проект
Проект — логический контейнер, объединяющий связанные пайплайны. Как правило, один проект = один репозиторий или одно приложение.
У проектов есть параметр видимости:
- Приватный — виден только вам
- Публичный — виден всем пользователям инстанса
Пайплайн
Пайплайн — ориентированный граф стейджей. У него есть триггер (что его запускает) и статус:
- Черновик — на стадии разработки; триггер необязателен; нельзя активировать
- Активный — настроен триггер, готов к экспорту
Можно иметь несколько пайплайнов в проекте (например, один для CI, один для деплоя, один для ночных задач).
Стейдж
Стейдж — именованная группа джобов, выполняемых вместе. Стейджи соединяются рёбрами зависимостей, определяющими порядок выполнения.
[Сборка] ──► [Тесты] ──► [Деплой]Все джобы внутри стейджа выполняются параллельно, если между ними нет рёбер.
Джоб
Джоб выполняется на конкретном раннере (например, ubuntu-latest, self-hosted). Он содержит список шагов, выполняемых последовательно.
При сбое джоба оставшиеся шаги пропускаются, и зависящие от него джобы также пропускаются.
Шаг
Шаг — наименьшая единица работы. Его тип определяет, что он делает и какие параметры принимает:
| Тип | Что делает |
|---|---|
shell_command | Запускает скрипт оболочки |
docker | Собирает, запускает, публикует или загружает Docker-образ |
git | Клонирует, переключает, тянет, тегирует или пушит |
test | Запускает набор тестов (Jest, Pytest, Vitest и др.) |
build | Собирает артефакт (npm, Maven, Cargo и др.) |
deploy | Деплоит в целевое окружение (Kubernetes, AWS, SSH и др.) |
notification | Отправляет сообщение (Slack, Teams, email, Discord) |
Холст
Визуальный редактор имеет три уровня холста. Переключение между ними происходит через детализацию:
| Уровень | Что отображается | Как войти |
|---|---|---|
| Вид пайплайна | Все стейджи + рёбра зависимостей | По умолчанию при открытии пайплайна |
| Вид стейджа | Все джобы в стейдже | Двойной клик по карточке стейджа |
| Вид джоба | Все шаги в джобе | Двойной клик по карточке джоба |
Используйте хлебные крошки вверху для возврата на предыдущий уровень.
Триггеры
Триггер определяет, когда запускается пайплайн. pipel8ne поддерживает:
| Тип триггера | Когда срабатывает |
|---|---|
push | При пуше в указанные ветки |
pull_request | При открытии pull request в указанные ветки |
schedule | По расписанию cron |
tag | При создании тега, совпадающего с шаблоном |
manual | Только при ручном запуске |
Триггер настраивается на уровне пайплайна, а не на уровне шага.
Экспорт YAML
Когда проектирование завершено, экспортируйте пайплайн в YAML-файл, совместимый с вашей CI/CD платформой. Экспорт генерируется на стороне клиента — ничего не покидает ваш браузер.
Поддерживаемые форматы: GitHub Actions, GitLab CI, Azure DevOps.
Смотрите Экспорт пайплайнов для подробностей.