git pull rebase при деплое Laravel на VPS
git pull rebase выполняет git fetch, а затем перебазирует локальные коммиты поверх удалённых, вместо создания merge-коммита. На сервере это даёт линейную историю и предсказуемый деплой. Настройка включается один раз через git config pull.rebase true в каталоге проекта.
01Включите rebase для git pull
Зайдите в каталог проекта от пользователя, который деплоит, и включите rebase по умолчанию для текущего репозитория. Ключ --global задаёт поведение для всех репозиториев пользователя, без него настройка действует только в этом проекте. Проверить значение можно командой git config pull.rebase.
cd /var/www/example.com
git config pull.rebase true
git config pull.rebase
02Проверьте доступ к приватному репозиторию
Для приватного репозитория клонирование идёт по SSH-ключу пользователя, который деплоит. Публичный ключ добавьте в GitHub как deploy key. Проверка ssh -T git@github.com должна вернуть приветствие с вашим именем пользователя.
ssh -T git@github.com
03Клонируйте проект на сервер
Клонируйте репозиторий в /var/www/example.com от пользователя, который будет деплоить. Не используйте sudo git clone: файлы окажутся у root, и следующие git pull упадут с error: cannot open .git/FETCH_HEAD: Permission denied.
git clone git@github.com:user/app.git /var/www/example.com
04Установите зависимости и соберите фронтенд
Установите PHP-зависимости без dev-пакетов и с оптимизированным автозагрузчиком. Затем поставьте npm-пакеты по lock-файлу и соберите фронтенд. Все команды выполняйте от владельца проекта, без sudo.
cd /var/www/example.com
composer install --no-dev --optimize-autoloader
npm ci
npm run build
05Настройте права на storage и bootstrap/cache
Владелец файлов проекта: пользователь, который деплоит. www-data пишет только в storage и bootstrap/cache через группу. Остальные файлы www-data только читает, поэтому chown -R www-data на весь сайт не нужен.
sudo chown -R $USER:www-data storage bootstrap/cache
sudo chmod -R ug+rwX storage bootstrap/cache
06Примените миграции и оптимизируйте конфиг
При APP_ENV=production команда migrate ждёт подтверждения, поэтому нужен флаг --force. php artisan optimize кэширует конфиг, маршруты, события и шаблоны. После кэша конфига env() вне файлов config/ возвращает null, а правка .env действует только после нового php artisan optimize или php artisan config:clear.
php artisan migrate --force
php artisan optimize
php artisan queue:restart
07Проверьте деплой через git pull rebase
Сделайте git pull в каталоге проекта: при включённом rebase локальные коммиты перебазируются поверх удалённых. Убедитесь, что история линейная и нет merge-коммита. Затем проверьте, что сайт отвечает и в логе Laravel нет новых ошибок.
cd /var/www/example.com
git pull
git log --oneline -5
tail -n 50 storage/logs/laravel.log
Частые ошибки
-
После
sudo git cloneилиchown -R www-dataна весь проектgit pullпадает сerror: cannot open .git/FETCH_HEAD: Permission denied.Верните владельца файлов пользователю, который деплоит:
sudo chown -R $USER:www-data /var/www/example.com.www-dataоставьте только чтение и запись вstorageиbootstrap/cache. -
composer installилиphp artisan optimizeпадают сfile_put_contents(/var/www/example.com/bootstrap/cache/packages.php): Failed to open stream: Permission denied.Команду запустили от пользователя без записи в
bootstrap/cache, обычно послеchown www-data:www-data. Верните группу:sudo chown -R $USER:www-data bootstrap/cacheи запускайте команды без sudo. -
git pullс rebase останавливается на конфликте и оставляет репозиторий в состоянии rebase.Разрешите конфликт в файлах, выполните
git addдля исправленных файлов иgit rebase --continue. Чтобы отменить перебазирование, выполнитеgit rebase --abort. -
После
git pullсайт отдаёт старый код, хотя файлы обновились.При
opcache.validate_timestamps=0новый код подхватывается только послеsudo systemctl reload php8.3-fpm. Проверьте значение в/etc/php/8.3/fpm/php.iniи перезагрузите службу.
Deploykin
Как это делается в Deploykin
В Deploykin репозиторий GitHub подключается к сайту из панели, и после каждого пуша панель сама запускает деплой с миграциями и кэшами. git pull по SSH не нужен.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Что делает git pull rebase?
git pull с включённым rebase выполняет git fetch, а затем перебазирует ваши локальные коммиты поверх удалённых. Вместо merge-коммита история остаётся линейной.
Как отключить rebase для git pull?
Выполните git config pull.rebase false в каталоге проекта. Для всех репозиториев пользователя добавьте ключ --global.
Чем git config pull.rebase false отличается от true?
true перебазирует локальные коммиты поверх удалённых, false создаёт merge-коммит при расхождении истории. Значение false возвращает стандартное поведение git.
Почему git pull падает с Permission denied на сервере?
Файлы репозитория принадлежат другому пользователю, например после sudo git clone или chown -R www-data на весь проект. Верните владельца командой sudo chown -R $USER:www-data /var/www/example.com.
Ещё по теме
- Руководство · Деплой Как развернуть сайт на VPS: Laravel и PHP на Ubuntu 24.04 Пошаговый деплой сайта на VPS: nginx, PHP 8.3, MySQL 8, git clone, composer install, миграции, права на storage и проверка через curl.
- Руководство · Деплой CI CD на Jenkins: деплой Laravel и PHP-сайтов на VPS Пошаговая настройка CI CD на Jenkins для деплоя Laravel и PHP-сайтов на Ubuntu 24.04: команды сборки, права, миграции и проверка результата.
- Руководство · Деплой git pull submodules при деплое Laravel на VPS Как настроить git pull submodules при деплое Laravel на Ubuntu 24.04: клонирование с подмодулями, обновление, права, composer install и проверка результата.
- Руководство · Деплой Как отменить git pull на сервере: пошаговый разбор Как отменить git pull на Ubuntu 24.04: сохранить правки, вернуть коммиты через git reset и git revert, восстановить деплой Laravel и проверить результат.
- Руководство · Деплой git fetch и git pull: различия и деплой Laravel на VPS Чем git fetch отличается от git pull, как настроить деплой Laravel на Ubuntu 24.04: команды, права на storage, nginx и проверка работы сайта.
- Руководство · Деплой Деплой PHP сайта на VPS: от чистого сервера до рабочего сайта Пошаговый деплой PHP-сайта и Laravel на VPS с Ubuntu 24.04: установка nginx, PHP 8.3, MySQL 8, настройка конфига, права и проверка.
Деплой Laravel на сервер: команды, конфиг и ошибки: все материалы темы