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

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

rdev の使い方

プロセスとスケジュールタスク

アプリの一部は、Web リクエストの外で動作します。キューワーカー、Horizon、Reverb の WebSocket サーバー、Laravel のスケジューラーなどです。rdev はこれらをサーバー上で実行し、動き続けるように保ち、状況をパネルのサーバーのページに表示します。サーバーに rdev 0.2.0-beta.24 以降が必要です。

サーバー上の Laravel プロジェクトにキューワーカーも Horizon もない場合、プロセス カードはキューワーカーの追加を提案します。スケジューラーがない場合は、スケジュールタスク カードが追加を提案します。クリックすると、そのプロジェクト用に入力済みのフォームが開きます。× はそのプロジェクトの提案を非表示にし、カードの 非表示の提案を表示 で非表示にしたものを戻せます。提案には rdev 0.2.0-beta.26 以降が必要で、どのプロジェクトが Laravel アプリかをパネルに伝えます。

プロセス

プロセスとは、php artisan queue:work のように、常に動作しているべきコマンドです。rdev はプロジェクトフォルダーでそれを起動し、停止したら再度起動し、複数のコピーを実行することもできます。

パネルで、サイドバーの サーバー からサーバーを開き、プロセス カードの プロセスを追加 を選びます。種類を選択します。

  • キューワーカー: php artisan queue:work --tries=3
  • Horizon: php artisan horizon(行のメニューから Horizon ダッシュボードを開けます)
  • Reverb: php artisan reverb:start
  • カスタム: 任意の言語の、任意のコマンド。

次に、プロジェクトと、実行するコピー数を選びます。テーブルには、各プロセスと、そのすべてのコピーが動作しているかどうかが表示されます。行の ⋯ メニューから、開始、停止、再起動、プロセス設定 を開いてコマンドやコピー数の変更、削除ができます。停止したプロセスは、再び開始するまで停止したままです。

サーバーでは次のとおりです。

コマンド 内容
rdev process add shop queue --command "php artisan queue:work" --count 2 2つのコピーを持つプロセスを追加します
rdev process list プロセスと、動作しているコピー数を一覧表示します
rdev process stop shop queue / start / restart すべてのコピーを停止、開始、再起動します
rdev process edit shop queue --count 4 コマンドまたはコピー数を変更します
rdev process logs shop queue 各コピーの出力の最後の数行を表示します
rdev process remove shop queue 停止して削除します

新しいコードをデプロイした後は、キューワーカーと Horizon を再起動して読み込ませてください:rdev process restart shop queue。

スケジュールタスク

スケジュールタスクは、cron のように、決まった時刻にコマンドを実行します。時刻はサーバーの時計である UTC です。同じタスクの前回の実行がまだ続いている間は、実行が始まりません。

スケジュールタスク カードで、スケジュールタスクを追加 を選びます。Laravel スケジューラー は、Laravel アプリに必要な php artisan schedule:run を毎分実行するよう追加します。スケジュール自体はコード内に残ります。カスタム では、任意のコマンドとスケジュールを指定できます。

スケジュールには、分、時、日、月、曜日の5つのフィールドがあります。例:

スケジュール 実行タイミング
* * * * * 毎分
*/15 * * * * 15分ごと
0 3 * * * 毎日 03:00 UTC
30 8 * * 1-5 平日 08:30 UTC
@hourly, @daily, @weekly 毎時、毎日、毎週の開始時

テーブルには、各タスクの前回の実行時刻、成功したかどうか、所要時間、次回の実行時刻が表示されます。結果をクリックすると、その出力を確認できます。スイッチはタスクを削除せずにオフにします。オフの間は、今すぐ実行 を選んだときだけ実行されます。

サーバーでは次のとおりです。

コマンド 内容
rdev cron add shop scheduler --schedule "* * * * *" --command "php artisan schedule:run" Laravel のスケジューラーを追加します
rdev cron list タスクを一覧表示します
rdev cron run shop scheduler 今すぐ実行します
rdev cron disable shop scheduler / enable オフまたはオンにします
rdev cron logs shop scheduler 前回の実行の出力を表示します
rdev cron remove shop scheduler 削除します