Введите не менее двух букв, чтобы искать по всем страницам документации.

↑ ↓ для навигации ↵ чтобы открыть esc чтобы закрыть

Работа с rdev

Деплой и отслеживание ошибок

На тарифах 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 вашего языка.