CI/CD для PHP-проекта без панических атак
Минимальный pipeline для PHP: lint, тесты и rsync на прод по SSH, без Docker, K8s и Helm. Где у такой схемы слабые места и когда пора усложнять.
Не каждый PHP-проект оправдывает Kubernetes. Для типового сайта, интернет-магазина или CRM на одном-двух серверах хватает простой схемы: CI прогоняет проверки, потом rsync по SSH выкладывает код на прод. Без Docker-образов, Helm-чартов и отдельного человека, который понимает, как это всё устроено.
Ниже — как собрать такой pipeline, где у него слабые места и в какой момент пора усложнять.
Что должен делать минимальный pipeline
Задача CI/CD на маленьком проекте скромная: не дать выкатить сломанный код и сделать деплой одной кнопкой вместо ручного копирования по FTP. Для этого нужно три шага.
- Lint.
php -lпо изменённым файлам ловит синтаксические ошибки. Поверх него —phpcsдля стиля и, если команда готова, PHPStan или Psalm для статического анализа. Начинайте с мягкого уровня, иначе первый запуск выдаст тысячу замечаний и его отключат. - Тесты.
phpunit, если тесты есть. Если их нет, pipeline всё равно полезен: lint и сборка уже отсекают часть ошибок. Тесты можно добавлять постепенно, начиная с самого денежного места — оформления заказа или расчёта цены. - Деплой.
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 ему нужен.