У тарифах 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 вашої мови.