На тарифах Pro и Team rdev помогает выкладывать проект в production и видеть его ошибки.
Деплой с помощью Deployer
rdev использует Deployer, стандартный инструмент деплоя для PHP. В проекте Laravel или WordPress выполните:
rdev deploy init myapp
Команда создаёт deploy.php из шаблона rdev и добавляет Deployer в dev-зависимости проекта. Укажите репозиторий, production-хост, SSH-пользователя и путь, затем выполните деплой командой vendor/bin/dep deploy production. Production-серверу нужны PHP, Composer и веб-сервер; production .env (или wp-config.php) находится на этом сервере и никогда не выкладывается отсюда.
Ваш агент тоже знает этот процесс: попросите его настроить деплой, и он заполнит deploy.php вместе с вами перед первым деплоем.
Чек-лист перед деплоем
Рецепт Laravel в deploy.php устанавливает зависимости Composer, связывает storage и общий .env, выполняет php artisan storage:link, кеширует конфигурацию, маршруты, представления и события, выполняет php artisan migrate --force и хранит 5 последних релизов. Рецепт WordPress делает общими wp-config.php и wp-content/uploads. Остальное за вами; пройдите этот список перед первым деплоем и перед крупными:
- Настройки продакшена: в
shared/.envна сервере верныеAPP_KEY,APP_URL, база данных, почта, кеш и очередь (WordPress:shared/wp-config.php). - Отладка выключена:
APP_ENV=productionиAPP_DEBUG=false(WordPress:WP_DEBUGравноfalse). - Резервные копии: сделайте копию продакшен-базы прямо перед деплоем с миграциями.
- Миграции: прочитайте новые миграции; при деплое они запускаются автоматически.
- Воркеры очереди: перезапускайте их после каждого деплоя, чтобы они загрузили новый код. Добавьте
after('deploy:success', 'artisan:queue:restart');вdeploy.phpили выполнитеphp artisan horizon:terminate, если используете Horizon. - Планировщик: один раз добавьте
* * * * * cd /var/www/myapp/current && php artisan schedule:run >> /dev/null 2>&1в crontab пользователя деплоя (WordPress: настоящая cron-задача, вызывающаяwp-cron.php). - HTTPS: веб-сервер отдаёт
current/public(WordPress:current) по HTTPS с действительным сертификатом. - Отслеживание ошибок: подключите проект через
rdev errors connect(ниже), чтобы ошибки продакшена доходили до вас. - Дымовой тест: после деплоя откройте главную, войдите, пройдите основной сценарий и проверьте лог на новые ошибки. Если что-то не так,
vendor/bin/dep rollback productionвернёт предыдущий релиз.
Согласование деплоя на тарифе Team
На тарифе Team выполняйте деплой командой rdev deploy run production, а не вызывайте Deployer сами. Сначала rdev запрашивает одобрение: владелец и администраторы видят запрос на странице Ваша команда и одобряют или отклоняют его, а деплой начинается, как только кто-то одобрит. Запрос, по которому никто не принял решение, истекает через час.
Локальное отслеживание ошибок
В тарифах Pro и Team вы можете запустить на своём сервере GlitchTip — трекер ошибок с открытым кодом, совместимый с SDK Sentry. Он остаётся приватным в вашем tailnet по адресу https://rdev-errors.dev.test.
Настройка: подключитесь к серверу как root (или пользователь sudo) и выполните sudo rdev host errors setup. Команда устанавливает GlitchTip рядом с вашим окружением. Он запускает собственную небольшую базу PostgreSQL, использует Redis вашего окружения, занимает около 0,7 ГБ памяти (лимит 1 ГБ) и около 1 ГБ диска и хранит события 30 дней. По завершении команда выводит e-mail и пароль администратора. Выполните rdev errors password в любой момент, чтобы увидеть их снова, или запустите команду настройки ещё раз, чтобы обновить GlitchTip и получить новый пароль. Опция --email [email protected] задаёт адрес администратора. Письма-оповещения GlitchTip появляются на вашей странице Mail (https://rdev-mail.dev.test). Регистрация отключена, так что войти можете только вы.
Подключение проекта: rdev errors connect my-shop создаёт проект GlitchTip с именем папки и записывает его DSN в проект:
- Laravel: устанавливает
sentry/sentry-laravelи задаётSENTRY_LARAVEL_DSNв.env. Проверьте командойphp artisan sentry:test. - WordPress: выводит шаги для плагина WP Sentry и строку, которую нужно добавить в
wp-config.php. - Другие языки: задаёт
SENTRY_DSNв.env. Добавьте SDK Sentry для вашего языка, который читаетSENTRY_DSN; убедитесь, что приложение загружает.env, либо экспортируйте переменную. PHP:composer require sentry/sentry; Node.js:npm install @sentry/node, затемSentry.init({ dsn: process.env.SENTRY_DSN }); Python:pip install sentry-sdk, затемsentry_sdk.init(); Ruby:bundle add sentry-ruby, затемSentry.init; Go:go get github.com/getsentry/sentry-go, затемsentry.Init(sentry.ClientOptions{}); .NET:dotnet add package Sentry; Java:io.sentry:sentry.
Чтобы отправлять ошибки в другой GlitchTip или в Sentry, передайте его DSN: rdev errors connect my-shop --dsn https://<key>@<host>/<id>.
Просмотр ошибок: откройте https://rdev-errors.dev.test или нажмите кнопку Errors в приложении для ноутбука и войдите с e-mail и паролем администратора. Пока отслеживание ошибок не настроено, страница показывает, как его установить. Кодирующие агенты могут читать нерешённые ошибки проекта через MCP-инструмент rdev_errors.
Отслеживание ошибок
Отправляйте ошибки проекта в GlitchTip или Sentry, на собственном сервере или в их облаке. Скопируйте DSN вашего проекта там, затем выполните:
rdev errors connect myapp --dsn https://<key>@<host>/<project-id>
- Laravel: устанавливает
sentry/sentry-laravelи задаётSENTRY_LARAVEL_DSNв.env. Проверьте командойphp artisan sentry:test. - WordPress: выводит шаги для плагина WP Sentry и строку, которую нужно добавить в
wp-config.php. - Другие проекты: задаёт
SENTRY_DSNв.envдля Sentry SDK вашего языка.