К содержимому

git pull rebase при деплое Laravel на VPS

git pull rebase выполняет git fetch, а затем перебазирует локальные коммиты поверх удалённых, вместо создания merge-коммита. На сервере это даёт линейную историю и предсказуемый деплой. Настройка включается один раз через git config pull.rebase true в каталоге проекта.

Руководство Деплой 3 мин чтения

01Включите rebase для git pull

Зайдите в каталог проекта от пользователя, который деплоит, и включите rebase по умолчанию для текущего репозитория. Ключ --global задаёт поведение для всех репозиториев пользователя, без него настройка действует только в этом проекте. Проверить значение можно командой git config pull.rebase.

bash
cd /var/www/example.com
git config pull.rebase true
git config pull.rebase

02Проверьте доступ к приватному репозиторию

Для приватного репозитория клонирование идёт по SSH-ключу пользователя, который деплоит. Публичный ключ добавьте в GitHub как deploy key. Проверка ssh -T git@github.com должна вернуть приветствие с вашим именем пользователя.

bash
ssh -T git@github.com

03Клонируйте проект на сервер

Клонируйте репозиторий в /var/www/example.com от пользователя, который будет деплоить. Не используйте sudo git clone: файлы окажутся у root, и следующие git pull упадут с error: cannot open .git/FETCH_HEAD: Permission denied.

bash
git clone git@github.com:user/app.git /var/www/example.com

04Установите зависимости и соберите фронтенд

Установите PHP-зависимости без dev-пакетов и с оптимизированным автозагрузчиком. Затем поставьте npm-пакеты по lock-файлу и соберите фронтенд. Все команды выполняйте от владельца проекта, без sudo.

bash
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 на весь сайт не нужен.

bash
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.

bash
php artisan migrate --force
php artisan optimize
php artisan queue:restart

07Проверьте деплой через git pull rebase

Сделайте git pull в каталоге проекта: при включённом rebase локальные коммиты перебазируются поверх удалённых. Убедитесь, что история линейная и нет merge-коммита. Затем проверьте, что сайт отвечает и в логе Laravel нет новых ошибок.

bash
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.

Ещё по теме

Деплой Laravel на сервер: команды, конфиг и ошибки: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.