Pro と Team プランでは、rdev がプロジェクトの本番へのデプロイと、そのエラーの確認を支援します。
Deployer によるデプロイ
rdev は、PHP の標準的なデプロイツールである Deployer を使用します。Laravel または WordPress のプロジェクトで、次を実行します。
rdev deploy init myapp
rdev のテンプレートから deploy.php が作成され、プロジェクトの開発用依存関係に Deployer が追加されます。リポジトリ、本番ホスト、SSH ユーザー、パスを入力し、vendor/bin/dep deploy production でデプロイします。本番サーバーには PHP、Composer、Web サーバーが必要です。本番の .env(または wp-config.php)はそのサーバー上にあり、ここからデプロイされることはありません。
エージェントもこの流れを理解しています。デプロイの設定を依頼すると、最初のデプロイの前に、お客様と一緒に deploy.php を入力します。
デプロイ前のチェックリスト
deploy.php の Laravel レシピは 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)。 - バックアップ: マイグレーションを実行するデプロイの直前に本番データベースをバックアップする。
- マイグレーション: 新しいマイグレーションに一度目を通す。デプロイ中に自動で実行されます。
- キューワーカー: 新しいコードを読み込むよう、デプロイのたびに再起動する。
deploy.phpにafter('deploy:success', 'artisan:queue:restart');を追加するか、Horizon を使っているならphp artisan horizon:terminateを実行します。 - スケジューラー: デプロイユーザーの crontab に
* * * * * cd /var/www/myapp/current && php artisan schedule:run >> /dev/null 2>&1を一度追加する(WordPress:wp-cron.phpを呼ぶ実際の cron ジョブ)。 - HTTPS: Web サーバーが
current/public(WordPress:current)を有効な証明書付きの HTTPS で配信している。 - エラートラッキング: 本番のエラーが届くよう、
rdev errors connect(下記)でプロジェクトを接続する。 - スモークテスト: デプロイ後にトップページを開き、ログインし、主要な流れを試し、ログに新しいエラーがないか確認する。問題があれば
vendor/bin/dep rollback productionで前のリリースに戻せます。
Team プランでのデプロイ承認
Team プランでは、Deployer を直接呼び出す代わりに rdev deploy run production でデプロイします。rdev はまず承認を求めます。オーナーと管理者が あなたのチーム ページでリクエストを確認して承認または却下し、誰かが承認するとすぐにデプロイが始まります。誰も判断しないリクエストは、1時間で期限切れになります。
ローカルのエラートラッキング
Pro と Team プランでは、Sentry SDK に対応したオープンソースのエラートラッカー GlitchTip を自分のサーバーで動かせます。tailnet 内に閉じており、https://rdev-errors.dev.test で開きます。
セットアップ:root(または sudo ユーザー)でサーバーに接続し、sudo rdev host errors setup を実行します。環境の隣に GlitchTip がインストールされます。専用の小さな PostgreSQL データベースを動かし、環境の Redis を使います。メモリは約 0.7 GB(上限 1 GB)、ディスクは約 1 GB 必要で、イベントは 30 日間保持されます。完了すると管理者のメールアドレスとパスワードが表示されます。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をインストールし、.envにSENTRY_LARAVEL_DSNを設定します。php artisan sentry:testで確認できます。 - WordPress: WP Sentry プラグインの手順と、
wp-config.phpに追加する行を表示します。 - その他の言語:
.envにSENTRY_DSNを設定します。SENTRY_DSNを読む各言語の Sentry SDK を追加し、アプリが.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 ボタンを使い、管理者のメールアドレスとパスワードでログインします。エラートラッキングが未設定の間は、ページにインストール方法が表示されます。コーディングエージェントは、MCP ツール rdev_errors でプロジェクトの未解決エラーを読めます。
エラートラッキング
プロジェクトのエラーを、セルフホストまたはクラウドの GlitchTip や Sentry に送信できます。そちらのプロジェクトから DSN をコピーし、次を実行します。
rdev errors connect myapp --dsn https://<key>@<host>/<project-id>
- Laravel:
sentry/sentry-laravelをインストールし、.envにSENTRY_LARAVEL_DSNを設定します。php artisan sentry:testで確認できます。 - WordPress: WP Sentry プラグインの手順と、
wp-config.phpに追加する行を表示します。 - その他のプロジェクト: お使いの言語の Sentry SDK 用に、
.envにSENTRY_DSNを設定します。