Введіть принаймні дві літери, щоб шукати по всіх сторінках документації.

↑ ↓ щоб переміщатися ↵ щоб відкрити esc щоб закрити

Використання rdev

Розгортання та відстеження помилок

У тарифах Pro і Team rdev допомагає випускати проєкт у робоче середовище та бачити його помилки.

Розгортання за допомогою Deployer

rdev використовує Deployer, стандартний інструмент розгортання для PHP. У проєкті Laravel або WordPress виконайте:

rdev deploy init myapp

Команда створює deploy.php із шаблону rdev і додає Deployer до залежностей розробки проєкту. Вкажіть репозиторій, робочий хост, користувача SSH і шлях, а потім розгорніть командою vendor/bin/dep deploy production. Робочому серверу потрібні PHP, Composer і вебсервер; робочий .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 вашої мови.