Главная / Блог / Двухэтапный CI/CD-пайплайн сайта

Двухэтапный CI/CD-пайплайн сайта: от сборки до развёртывания

Двухэтапный CI/CD-пайплайн - это организация автоматической поставки сайта, в которой проверка изменений отделена от публикации. Первый этап собирает и проверяет проект, второй - доставляет готовый результат на сервер. Второй этап запускается только при успешном завершении первого.

CI/CD-пайплайн - это автоматическая последовательность шагов от изменения кода в Git до работающего сайта. CI (Continuous Integration, непрерывная интеграция) отвечает за сборку и проверку каждого изменения. CD имеет два значения: Continuous Delivery (непрерывная доставка) и Continuous Deployment (непрерывное развёртывание). В первом случае изменения автоматически доводятся до состояния готовности к выпуску, но публикация в production может требовать ручного подтверждения. Во втором случае успешно прошедшие проверки изменения публикуются в production автоматически. Разница между доставкой и развёртыванием принципиальна для настройки пайплайна.

Простой отправки файлов на сервер по FTP или выполнения git pull на production недостаточно для предсказуемой работы. Ошибка в зависимостях, типах или сборке становится видна уже на живом сайте. Разделение на два этапа снижает этот риск: при условии, что публикация выполняется только через настроенный пайплайн, изменения, не прошедшие проверки, не допускаются к развёртыванию. Оговорка существенна: ручной FTP-доступ, отдельный скрипт или другой путь публикации вне пайплайна такую защиту обходят.

Что такое двухэтапный пайплайн

Двухэтапный пайплайн - это вариант организации CI/CD из двух последовательных групп шагов: build and test, затем deploy.

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

Это не стандарт с фиксированным набором стадий. Названия этапов, состав проверок и способ доставки зависят от проекта. Двумя этапами схема не ограничена: при усложнении проекта добавляются staging-окружение, миграции, бэкапы, ручное подтверждение релиза. Два этапа - минимальная схема разделения проверки и публикации, а не обязательная норма.

Терминологическая деталь: в GitLab CI есть сущность stage, в GitHub Actions её нет. Там основные единицы - workflow, jobs и steps. Поэтому для примера на GitHub Actions точнее говорить о двух последовательных фазах, реализованных двумя jobs: фаза проверки и фаза публикации. Внутри каждой фазы выполняется несколько шагов, часть задач фазы проверки может выполняться параллельно.

Первый этап: сборка и проверка проекта

Задача первого этапа - подтвердить, что изменения пригодны к развёртыванию. Если подтверждение не получено, пайплайн останавливается. Обычный состав такой фазы включает установку зависимостей, статический анализ, тесты и production-сборку.

Установка зависимостей

Чистая установка по lock-файлу (npm ci, uv sync --locked, composer install). Проверяет воспроизводимость окружения: проект должен собираться не только на компьютере разработчика. Вариант uv sync --locked проверяет соответствие lock-файла и завершается ошибкой при его неактуальности, что соответствует задаче проверки в CI.

Статический анализ и проверка типов

Линтер и проверка типов без запуска кода: ESLint, tsc --noEmit, PHPStan, Stylelint. Это быстрая проверка, которая отсекает синтаксические ошибки, неиспользуемые импорты, нарушения конфигурации.

Автоматизированные тесты

Для начала достаточно запускать имеющиеся автоматизированные тесты. Полное покрытие проекта не является обязательным условием внедрения пайплайна. Требование одно: имеющиеся тесты должны проходить в чистом окружении.

Production-сборка

Сборка в режиме production: next build, npm run build, сборка темы или плагина. Успешная production-сборка - одно из условий передачи проекта на следующий этап. Сама по себе она подтверждает собираемость, но не доказывает работоспособность приложения, для этого нужны тесты и другие проверки. Артефакт сборки сохраняется для следующего этапа.

Результат этапа - готовый артефакт и понятный вердикт: можно передавать дальше или нет.

Второй этап: развёртывание сайта

Задача второго этапа - доставить готовый артефакт на сервер без повторной проверки кода.

Передача артефактов сборки

Артефакт передаётся между этапами штатными средствами платформы: artifacts в GitHub Actions, artifacts в GitLab CI. Копировать исходники и собирать заново на сервере нежелательно: теряется гарантия, что публикуется именно проверенная сборка.

Подготовка окружения и переменных

Переменные окружения, ключи API, строки подключения задаются на стороне сервера или в секретах CI, а не хранятся в репозитории. Этап проверяет их наличие до начала перезапуска.

Развёртывание на сервере

Варианты зависят от хостинга: копирование файлов по SSH или rsync, перезапуск контейнера, обновление на shared-хостинге, атомарная замена symlink на новую версию. Конкретный способ выбирается под инфраструктуру, логика этапа от него не меняется.

Проверка работоспособности после публикации

Проверка после публикации подтверждает, что сайт отвечает и отдаёт ожидаемый контент: HTTP-статус главной, наличие ключевых блоков, ответ API healthcheck. Часто для этого используют smoke-тест. Smoke-тест не является обязательной частью второго этапа, это опция конфигурации. В простых схемах достаточно проверки кода ответа и времени отклика.

Повторная сборка проекта на втором этапе не нужна. Если проект собирается заново, двухэтапный пайплайн сохраняется, но теряется гарантия, что в production попадает именно тот артефакт, который прошёл проверки на первом этапе. Поэтому предпочтительнее передавать готовый результат сборки.

Как выглядит двухэтапный пайплайн на практике

Последовательность одинакова для большинства платформ. Сначала изменения попадают в Git, затем выполняется фаза build and test: установка, линт, типы, тесты, сборка. При ошибке пайплайн останавливается и deploy не запускается. При успехе сохраняется готовый артефакт, выполняется фаза deploy: передача, переменные, публикация. Затем сайт работает в production, опционально выполняется smoke-проверка.

Пример на GitHub Actions с двумя задачами. Вторая задача зависит от первой через needs и выполняется только при push в master:

name: site-pipeline

on:
  push:
    branches: [master]
  pull_request:
    branches: [master]

permissions:
  contents: read

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 26
          cache: npm
      - run: npm ci
      - run: npm run lint
      - run: npm run test
      - run: npm run build
      - uses: actions/upload-artifact@v4
        with:
          name: dist
          path: dist/

  deploy:
    if: github.event_name == 'push'
    needs: build
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/download-artifact@v4
        with:
          name: dist
          path: dist/
      - run: ./ops/deploy.sh

Здесь dist/ - условный каталог результата сборки для универсального примера, а не утверждение о структуре конкретного фреймворка. В Next.js стандартным результатом является каталог .next, при output: 'standalone' учитываются также .next/standalone, .next/static и public. Перед копированием примера путь заменяется на фактический артефакт проекта.

Версия Node.js в примере - 26, Active LTS на ноябрь 2026 года. Фактическая версия выбирается по совместимости зависимостей проекта, Node.js 24 остаётся поддерживаемой альтернативой.

Три детали примера важны для понимания. Во-первых, jobs выполняются в отдельных окружениях, поэтому deploy начинается с actions/checkout: без этого скрипт ./ops/deploy.sh из репозитория недоступен, артефакт передаёт только каталог dist/. Во-вторых, needs: build сохраняет зависимость: при неуспешной проверке публикация не запускается. В-третьих, pull_request запускает проверку до слияния, а условие if: github.event_name == 'push' оставляет публикацию только для push в master. Чтобы проверки Pull Request действительно блокировали слияние, их дополнительно делают обязательными в Branch protection rules или Rulesets, самого триггера для этого недостаточно.

Что происходит при ошибке первого этапа

При ошибке любого шага первого этапа пайплайн завершается со статусом failed, второй этап пропускается.

Такая блокировка относится к запуску deploy при неуспешной проверке: к развёртыванию не допускается версия проекта, проверка которой завершилась ошибкой. Сам процесс развёртывания при этом может иметь собственные отказы. Например, файлы успевают скопироваться, а перезапуск приложения завершается ошибкой. Это другой класс отказов, он относится уже ко второму этапу и требует отдельных мер: проверки статуса деплоя, логов публикации, процедуры отката.

Где искать причину остановки на первом этапе:

  • список задач пайплайна в интерфейсе GitHub Actions или GitLab CI;
  • лог упавшей задачи, обычно ошибка находится в конце лога;
  • артефакты и отчёты тестов, если платформа их сохраняет.

Результаты сборки стоит сохранять даже при успехе: по артефакту видно, какая именно версия прошла проверку. При споре "что опубликовано" артефакт даёт точный ответ без повторной сборки.

Когда двух этапов достаточно, а когда нет

СитуацияДостаточно двух этаповНужны дополнительные этапы
Небольшой сайт или веб-приложение без stagingДа, проверка и публикация закрывают потребностьНет
Проект с отдельным staging-окружениемНет, требуется отдельная процедура развёртывания и проверки в staging, технически это оформляется дополнительными шагами или окружениемДа
Несколько сред (dev, stage, prod)Нет, для каждой среды нужен свой шаг развёртыванияДа
Миграции БД, бэкапы, откат релизаНет, требуются шаги бэкапа до релиза и отката при ошибкеДа

Состав пайплайна расширяется по мере появления новых требований. Для лендинга без базы данных два этапа остаются актуальными годами. Для интернет-магазина с миграциями и очередями добавляются бэкап, dry-run миграций, canary-доставка, ручное подтверждение.

Двухэтапный пайплайн в Next.js и WordPress

Архитектура проекта определяет содержимое этапов. Механически переносить конфигурацию между платформами не получится.

АспектNext.jsWordPress (кастомная тема или плагин)
Что проверяет первый этапУстановка npm-зависимостей, ESLint, tsc, тесты, next buildPHP-линт, PHPStan или PHPCS, сборка фронтенда темы, тесты плагина при наличии
Что такое артефактРезультат next build или Docker-образАрхив темы или плагина с собранными ресурсами либо подготовленный набор файлов для доставки через rsync
Что делает второй этапДоставка сборки на хостинг, перезапуск Node-процесса или контейнераКопирование темы на сервер, очистка кеша, проверка главной
Типичная ошибка переносаСобирать проект на сервере вместо передачи артефактаПубликовать всю CMS вместо изменений темы

В Next.js сборка обязательна: без неё нечего публиковать. В WordPress акцент смещён на проверку кода и точечную доставку: ядро CMS на сервер при каждом релизе обычно не отправляют, отправляют только изменённую тему или плагин.

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

Частые вопросы

Чтобы не пропустить новые материалы

Короткий дайджест вечером в понедельник. Без спама.

Выберите, что получать

Обсудим ваш проект

Расскажите о вашем бизнесе, покажите текущий сайт или просто опишите задачу в свободной форме. Я изучу вводные, предложу решение и сориентирую по срокам и смете.

Отвечаю в течение нескольких часов в рабочее время.

Защита от спама – Yandex SmartCaptcha

Если вам удобнее обсудить всё текстом без заполнения форм – напишите напрямую: в Telegram или на sergei@kruglov.net

Удобнее голосом? Напишите пару слов о задаче - договоримся об удобном времени созвона на 15-20 минут, и я пришлю свой номер телефона.