ドキュメントの全ページを検索するには、2文字以上入力してください。

↑ ↓ で移動 ↵ で開く esc で閉じる

rdev の使い方

デプロイとエラートラッキング

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 を設定します。