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

git pull для деплоя Laravel на VPS: пошаговая настройка

git pull забирает коммиты из удалённого репозитория и сливает их в текущую ветку. На сервере эта команда запускает цепочку деплоя: обновление кода, зависимости Composer, права на каталоги, миграции и кэш.

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

01Подготовьте SSH-ключ для git pull

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

bash
ssh-keygen -t ed25519 -C "deploy@example.com"
cat ~/.ssh/id_ed25519.pub
ssh -T git@github.com

02Клонируйте репозиторий в каталог сайта

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

bash
sudo mkdir -p /var/www/example.com
sudo chown $USER:www-data /var/www/example.com
git clone git@github.com:user/app.git /var/www/example.com
cd /var/www/example.com

03Установите зависимости Composer

composer install --no-dev --optimize-autoloader ставит пакеты строго по composer.lock без dev-зависимостей и собирает оптимизированный автозагрузчик. Запускайте команду от владельца проекта, без sudo. Если Composer пишет Your requirements could not be resolved to an installable set of packages, в тексте указано, какого расширения не хватает, например ext-intl ставится пакетом php8.3-intl.

bash
composer install --no-dev --optimize-autoloader

04Соберите фронтенд

Если в проекте есть package.json, зависимости ставят через npm ci, а сборку через npm run build. npm ci ставит версии строго по package-lock.json и падает, если файл расходится с package.json. Сборка на сервере с малым объёмом памяти может закончиться Killed: процесс убил OOM-killer, проверьте sudo dmesg -T | grep -i "killed process" и добавьте swap.

bash
npm ci
npm run build

05Выдайте права на storage и bootstrap/cache

Владелец файлов проекта: пользователь, который деплоит. www-data пишет только в storage и bootstrap/cache, доступ даёт группа. Остальные файлы www-data только читает, поэтому chown -R www-data:www-data на весь сайт не нужен: он позволяет PHP переписать собственный код.

bash
sudo chown -R $USER:www-data storage bootstrap/cache
sudo chmod -R ug+rwX storage bootstrap/cache

06Проверьте.env и создайте APP_KEY

Файл .env на сервере создают из .env.example и заполняют APP_ENV=production, APP_DEBUG=false, параметры DB_* и APP_URL. APP_KEY создают один раз командой php artisan key:generate: новый ключ разлогинивает всех и ломает зашифрованные данные, при переезде ключ переносят вместе с .env. Без ключа Laravel отвечает No application encryption key has been specified.

bash
cp .env.example .env
php artisan key:generate

07Примените миграции

php artisan migrate --force выполняет неприменённые миграции. Флаг --force обязателен при APP_ENV=production, иначе команда ждёт подтверждения и деплой зависает. При ошибке SQLSTATE[HY000] [1045] Access denied for user проверьте DB_USERNAME и DB_PASSWORD в .env, при SQLSTATE[HY000] [2002] Connection refused проверьте, что MySQL запущен и слушает адрес из DB_HOST.

bash
php artisan migrate --force

08Соберите кэш конфига и маршрутов

php artisan optimize кэширует конфиг, маршруты, события и шаблоны. После кэша конфига env() вне файлов config/ возвращает null, а правка .env действует только после нового php artisan optimize или php artisan config:clear. Команда пишет в bootstrap/cache, поэтому запускайте её от владельца проекта: иначе получите file_put_contents(/var/www/example.com/bootstrap/cache/packages.php): Failed to open stream: Permission denied.

bash
php artisan optimize

Частые ошибки

  • git pull падает с error: cannot open .git/FETCH_HEAD: Permission denied.

    Файлы репозитория принадлежат другому пользователю, обычно после sudo git clone или chown -R www-data на весь проект. Верните владельца: sudo chown -R $USER:www-data /var/www/example.com.

  • composer install или php artisan optimize падает с Failed to open stream: Permission denied в bootstrap/cache.

    Каталог принадлежит www-data после chown -R www-data:www-data. Верните группу: sudo chown -R $USER:www-data storage bootstrap/cache и запускайте команды без sudo от владельца проекта.

  • git pull по SSH отвечает git@github.com: Permission denied (publickey).

    У пользователя, который делает git pull, нет ключа, добавленного в GitHub. Проверьте ssh -T git@github.com от этого пользователя и добавьте публичный ключ как deploy key.

  • Сайт отдаёт 419 Page Expired на формах.

    Laravel не нашёл CSRF-токен в сессии: проверьте @csrf в форме, SESSION_DOMAIN, SESSION_SECURE_COOKIE и наличие таблицы sessions при драйвере database. После правки .env выполните php artisan optimize.

Deploykin

Как это делается в Deploykin

В Deploykin репозиторий GitHub подключается к сайту из панели, и после каждого пуша панель сама запускает деплой с миграциями и кэшами. git pull по SSH не нужен.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Чем git pull отличается от git fetch?

git fetch только забирает коммиты из удалённого репозитория и обновляет ветки отслеживания. git pull делает git fetch, а затем сливает изменения в текущую ветку через merge или rebase.

Что делает git pull origin master?

Команда забирает ветку master из удалённого репозитория origin и сливает её в текущую ветку. Если текущая ветка не master, появится merge-коммит или конфликт.

Почему после git pull на сайте старый код?

С opcache.validate_timestamps=0 PHP не проверяет время изменения файлов. Выполните sudo systemctl reload php8.3-fpm, чтобы новый код попал в opcache.

Нужно ли запускать git pull через sudo?

Нет. sudo git pull оставит файлы репозитория у root, и следующий git pull от пользователя упадёт с Permission denied на .git/FETCH_HEAD.

Почему после правки.env ничего не меняется?

Конфиг закэширован командой php artisan optimize, и env() вне файлов config/ возвращает null. Выполните php artisan optimize заново или php artisan config:clear.

Ещё по теме

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

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