Деплой Laravel без паники: чек-лист deploy.md

Проект на Laravel работает локально, агент говорит «готово к продакшену», и ты впервые выкатываешь его на сервер. Дальше обычно одно из трёх: сайт показывает страницу ошибки со всеми настройками, потому что остался APP_DEBUG=true; письма и уведомления не уходят, потому что очередь на сервере никто не запустил; или миграция падает на середине, а резервной копии базы нет.

deploy.md — порядок выкатки твоего проекта: что проверить в .env, какие команды выполнить и в какой последовательности, как убедиться, что очереди и расписание работают, и что делать, если что-то пошло не так. Его один раз собирают с ИИ, а потом выкатывают по нему каждый релиз сами или поручают агенту.

Что внутри deploy.md

• ⚙️.env для продакшена

  APP_ENV=production, APP_DEBUG=false, правильный APP_URL, ключи сервисов боевые. Список переменных сверяется с .env.example.

• 💾Бэкап до миграций

  Копия базы делается до php artisan migrate, и ты знаешь, куда она легла и как её восстановить.

• 📬Очереди и расписание

  Воркеры перезапускаются после выкатки командой queue:restart, иначе продолжают работать со старым кодом. Расписание запускается каждую минуту из cron.

• ↩️Откат

  Как вернуть прошлую версию кода и что делать с миграцией, которую нельзя отменить.

Как использовать

1. 1Запусти шаг 1 в папке проекта

   В Claude Code или Cursor агент сам прочитает composer.json, .env.example и конфиги очередей и ответит на большинство вопросов.

2. 2Ответь на оставшиеся

   Агент не знает, какой у тебя сервер и как туда попадает код. Ответь словами: «VPS, захожу по SSH, код через git pull».

3. 3Собери deploy.md

   Шаг 2 выдаёт полный текст файла. Попроси агента: «Сохрани это в docs/deploy.md».

4. 4Прогони на тестовом сервере

   Первую выкатку по deploy.md сделай не на боевом. Шаг 3 помогает агенту выкатывать по файлу с остановкой на каждом шаге.

Если сервера ещё нет и проект живёт на хостинге, где нельзя запустить очереди, начни с материала про переезд на сервер.

Рядом по теме: План релиза с ИИ-агентом: release.md без забытых шагов, Мини-SaaS с AI-кодером: отчёт CPA из CSV до релиза, Найди ключи и пароли до того, как их найдут другие, статья «Где разместить проект» и Чек-лист «Перед запуском» (бесплатно).

Что дальше

• План отката релиза — подробнее о разделе 4, если релиз трогает оплату или структуру базы.
• CLAUDE.md для Laravel и Livewire — чтобы агент сразу знал правила проекта, включая порядок деплоя.
• Мини-CRM для заявок на Laravel и Livewire — проект из примера целиком.