CI/CD для PHP-проекта без панических атак

Минимальный pipeline для PHP: lint, тесты и rsync на прод по SSH, без Docker, K8s и Helm. Где у такой схемы слабые места и когда пора усложнять.

Не каждый PHP-проект оправдывает Kubernetes. Для типового сайта, интернет-магазина или CRM на одном-двух серверах хватает простой схемы: CI прогоняет проверки, потом rsync по SSH выкладывает код на прод. Без Docker-образов, Helm-чартов и отдельного человека, который понимает, как это всё устроено.

Ниже — как собрать такой pipeline, где у него слабые места и в какой момент пора усложнять.

Что должен делать минимальный pipeline

Задача CI/CD на маленьком проекте скромная: не дать выкатить сломанный код и сделать деплой одной кнопкой вместо ручного копирования по FTP. Для этого нужно три шага.

  1. Lint. php -l по изменённым файлам ловит синтаксические ошибки. Поверх него — phpcs для стиля и, если команда готова, PHPStan или Psalm для статического анализа. Начинайте с мягкого уровня, иначе первый запуск выдаст тысячу замечаний и его отключат.
  2. Тесты. phpunit, если тесты есть. Если их нет, pipeline всё равно полезен: lint и сборка уже отсекают часть ошибок. Тесты можно добавлять постепенно, начиная с самого денежного места — оформления заказа или расчёта цены.
  3. Деплой. composer install --no-dev, сборка фронтенда, если она есть, и rsync на сервер.

В GitLab CI это укладывается в пару десятков строк YAML. В GitHub Actions выглядит похоже, только синтаксис другой.

stages: [check, deploy]

lint:
  stage: check
  image: composer:2
  script:
    - find . -name "*.php" -not -path "./vendor/*" -print0 | xargs -0 -n1 php -l
    - composer install --no-interaction
    - vendor/bin/phpunit

deploy:
  stage: deploy
  rules:
    - if: $CI_COMMIT_BRANCH == "main"
  script:
    - composer install --no-dev --optimize-autoloader
    - rsync -az --delete --exclude-from=.deploy-exclude ./ deploy@server:/var/www/site/

Это скелет, а не готовый файл: SSH-ключ, версия PHP и пути у каждого проекта свои. Образ взят для примера: в нём есть PHP и Composer, но версия PHP в CI должна совпадать с серверной, иначе тесты проверяют не то окружение.

Где обычно больно

Простая схема ломается не на YAML, а на мелочах вокруг него.

  • --delete без исключений. rsync с этим флагом удалит на сервере всё, чего нет в репозитории: загрузки пользователей, кэш, логи, конфиг с паролями. Список исключений пишется до первого деплоя, а не после первой потери. Сначала прогоните rsync с --dry-run и посмотрите, что он собирается удалить.
  • Секреты в репозитории. Пароли к базе и ключи API хранятся в переменных CI или в файле .env на сервере, который деплой не трогает. Приватный ключ для деплоя — отдельный, с правами только на нужную папку.
  • Полуобновлённый сайт. Пока rsync копирует файлы, часть кода уже новая, часть старая. На маленьком сайте это секунды, и обычно никто не замечает. Если замечают — переходите на релизы по папкам: каждый деплой кладётся в новую директорию, а в конце переключается симлинк current. Откат — это переключить симлинк обратно.
  • Миграции базы. Код можно откатить, базу так просто нельзя. Миграции пишутся так, чтобы старый код какое-то время работал с новой схемой: сначала добавили колонку, потом выкатили код, удаление старого — следующим релизом.
  • Кэш после деплоя. OPcache, кэш шаблонов, кэш фреймворка. Если после выкладки сайт показывает старое, значит в pipeline не хватает шага с перезагрузкой PHP-FPM или очисткой кэша.

Откат и уверенность

Главный страх при автоматическом деплое — «выкатили, всё упало, что делать». Ответ должен быть готов заранее. При схеме с релизами по папкам откат занимает секунды. При голом rsync — повторный запуск pipeline с предыдущего коммита, это дольше, но тоже работает.

После деплоя полезен smoke-тест: curl на главную и пару ключевых страниц, проверка кода ответа. Если не 200, pipeline краснеет, и вы узнаёте о проблеме раньше клиентов. Это пять строк, а экономят они много нервов.

Когда пора наворачивать

Простота важнее «правильности», пока проект маленький. Усложнять стоит, когда появляется конкретная причина:

  • команда выросла до нескольких разработчиков, и им нужны отдельные стенды под ветки;
  • появились staging, production и preview-окружения, которые должны быть одинаковыми;
  • серверов стало несколько, и деплой нужно делать на все синхронно;
  • проект разросся до нескольких сервисов на разных языках, а окружение «работает у меня» начинает отличаться от прода.

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

Чек-лист минимального CI/CD

  • Код в git, прод собирается только из основной ветки.
  • Lint и тесты запускаются на каждый push.
  • Деплой по SSH-ключу, секреты в переменных CI, а не в репозитории.
  • У rsync есть список исключений, проверенный через --dry-run.
  • Есть понятный способ отката и кто-то, кто знает, как им пользоваться.
  • После деплоя — автоматическая проверка, что сайт отвечает.
  • Бэкапы базы и загрузок живут отдельно от деплоя и проверяются.

Если хотите такую схему у себя, но некому собрать, это входит в настройку DevOps: pipeline, деплой, мониторинг и бэкапы под ваш проект, без лишних слоёв.

Опишите ваш проект в Telegram или MAX — подскажем, какой pipeline ему нужен.

Настройка DevOps
Услуга по теме — обсудим ваш проект.

Есть задача по теме? Напишите — вернёмся с оценкой и сроками.

Написать в Telegram → Написать в MAX